Este es el comando borgbackup que se puede ejecutar en el proveedor de alojamiento gratuito de OnWorks utilizando una de nuestras múltiples estaciones de trabajo en línea gratuitas, como Ubuntu Online, Fedora Online, emulador en línea de Windows o emulador en línea de MAC OS.
PROGRAMA:
NOMBRE
borg - BorgBackup es un programa de copia de seguridad de deduplicación con compresión opcional y
cifrado autenticado.
Borg consta de varios comandos. Cada comando acepta varios argumentos y
opciones. Las siguientes secciones describen cada comando en detalle.
GENERAL
Tipo de Propiedad of log salida
El nivel de registro de la configuración de registro incorporado está predeterminado en ADVERTENCIA. Esto es porque
queremos que Borg sea mayoritariamente silencioso y que solo genere advertencias, errores y mensajes críticos.
Niveles de registro: DEPURACIÓN <INFO <ADVERTENCIA <ERROR <CRÍTICO
Uso --depurar para configurar el nivel de registro DEBUG: para obtener depuración, información, advertencia, error y nivel crítico
salida.
Uso --información (o -v or --verboso) para configurar el nivel de registro INFO - para obtener información, advertencia, error y
Salida de nivel crítico.
Uso --advertencia (predeterminado) para establecer el nivel de registro de ADVERTENCIA: para obtener advertencias, errores y críticas
nivel de salida.
Uso --error para establecer el nivel de registro de ERROR: para obtener una salida de error y nivel crítico.
Uso --crítico para establecer el nivel de registro CRÍTICO: para obtener una salida de nivel crítico.
Si bien puede configurar misc. niveles de registro, no espere que cada comando dé diferentes
salida en diferentes niveles de registro, es solo una posibilidad.
ADVERTENCIA:
Las opciones --critical y --error se proporcionan para completar, su uso no es
recomendado, ya que podría perder información importante.
ADVERTENCIA:
Si bien algunas opciones (como - estadísticas or --lista) emitirá más mensajes informativos,
tiene que usar el nivel de registro INFO (o inferior) para que aparezcan en la salida del registro. Usar -v o un
configuración de registro.
Ida y vuelta los códigos de
Borg puede salir con los siguientes códigos de retorno (rc):
0 = éxito (registrado como INFO)
1 = advertencia (la operación alcanzó su final normal, pero hubo advertencias -
debe verificar el registro, registrado como ADVERTENCIA)
2 = error (como un error fatal, una excepción local o remota, la operación
no alcanzó su final normal, registrado como ERROR)
128 + N = asesinado por la señal N (por ejemplo, 137 == matar -9)
Si utiliza --mostrar-rc, el código de retorno también se registra en el nivel indicado como el último
entrada de registro.
Entorno Variables
Borg usa algunas variables de entorno para la automatización:
General:
BORG_REPO
Cuando se establece, use el valor para dar la ubicación del repositorio predeterminada. Si un
El comando necesita un parámetro de archivo, puede abreviarlo como ::archivo. Si un
comando necesita un parámetro de repositorio, puede dejarlo a un lado o
abreviar como ::, si se requiere un parámetro posicional.
BORG_PASSPHRASE
Cuando se establece, use el valor para responder a la pregunta de la frase de contraseña para
repositorios.
BORG_DISPLAY_PASSPHASE
Cuando se establezca, use el valor para responder a "mostrar la frase de contraseña para
"Verificación" pregunta al definir una nueva frase de contraseña para cifrado
repositorios.
BORG_LOGGING_CONF
Cuando se establece, use el nombre de archivo dado como INIconfiguración de registro de estilo.
BORG_RSH
Cuando esté configurado, use este comando en lugar de ssh. Esto se puede usar para especificar ssh
opciones, como un archivo de identidad personalizado ssh -i / ruta / a / clave / privada. Vea hombre
ssh para explorar otras opciones
TMPDIR donde se almacenan los archivos temporales (puede necesitar mucho espacio temporal para
algunas operaciones)
Cosas y automática respondedores (Si conjunto, ellos automáticamente https://www.youtube.com/watch?v=xB-eutXNUMXJtA&feature=youtu.be confirmación preguntas):
BORG_UNKNOWN_UNENCRYPTED_REPO_ACCESS_IS_OK = no (o = si)
Para "Advertencia: intento de acceder a un desconocido sin cifrar
repositorio"
BORG_RELOCATED_REPO_ACCESS_IS_OK = no (o = si)
Para "Advertencia: el repositorio en la ubicación ... estaba ubicado anteriormente en ..."
BORG_CHECK_I_KNOW_WHAT_I_AM_DOING = NO (o = SÍ)
Para "Advertencia:" comprobar --repair "es una función experimental que puede resultar
en la pérdida de datos ".
BORG_DELETE_I_KNOW_WHAT_I_AM_DOING = NO (o = SÍ)
Para "Solicitaste BORRAR completamente el repositorio de alta calidad que incluyen todos
archivos que contiene: "
Nota: las respuestas distinguen entre mayúsculas y minúsculas. establecer un valor de respuesta no válido podría dar
la respuesta predeterminada o preguntarle de forma interactiva, dependiendo de si los reintentos son
permitido (están permitidos por defecto). Así que prueba tus scripts de forma interactiva.
antes de convertirlos en un script no interactivo.
Directorios:
BORG_KEYS_DIR
Predeterminado a '~ / .config / borg / keys'. Este directorio contiene claves para cifrado
repositorios.
BORG_CACHE_DIR
Predeterminado a '~ / .cache / borg'. Este directorio contiene la caché local y
podría necesitar mucho espacio para trabajar con grandes repositorios).
Edificio:
BORG_OPENSSL_PREFIX
Agrega el directorio de archivos de encabezado OpenSSL dado a las ubicaciones predeterminadas
(configuración.py).
BORG_LZ4_PREFIX
Agrega el directorio de archivos de encabezado LZ4 dado a las ubicaciones predeterminadas (setup.py).
Ten en cuenta que:
· Tenga mucho cuidado al usar los que dicen "sí", las advertencias con aviso existen para su /
la seguridad de sus datos
· También tenga mucho cuidado al poner su frase de contraseña en un script, asegúrese de que tenga
permisos de archivo apropiados (por ejemplo, modo 600, root: root).
Recurso Uso
Borg podría usar muchos recursos dependiendo del tamaño del conjunto de datos que está tratando.
con.
UPC: No irá más allá del 100% de 1 núcleo, ya que el código actualmente es de un solo subproceso.
Los niveles de compresión especialmente más altos de zlib y lzma usan cantidades significativas de CPU
ciclos
Salud Cerebral (RAM):
El índice de fragmentos y el índice de archivos se leen en la memoria por motivos de rendimiento.
Compresión, esp. La compresión de lzma con niveles altos puede necesitar cantidades sustanciales.
de la memoria
Temporal archivos:
La lectura de datos y metadatos de un repositorio montado en FUSE consumirá aproximadamente
mismo espacio que los fragmentos deduplicados utilizados para representarlos en el repositorio.
cache archivos:
Contiene el índice de fragmentos y el índice de archivos (más una colección comprimida de
índices de fragmentos de un solo archivo).
Trozos índice:
Proporcional a la cantidad de fragmentos de datos en su repositorio. Muchos fragmentos en su repositorio
implican un índice de fragmentos grandes. Es posible modificar los parámetros de chunker (ver crear
opciones).
archivos índice:
Proporcional a la cantidad de archivos en su última copia de seguridad. Se puede apagar (ver
crear opciones), pero la próxima copia de seguridad será mucho más lenta si lo hace.
Red:
Si su repositorio es remoto, todo desduplicado (y opcionalmente comprimido /
cifrados), por supuesto, los datos deben pasar por la conexión (ssh: repo url). Si tu
utilizar un sistema de archivos de red montado localmente, además, se utilizan algunas operaciones de copia
para soporte de transacciones también revise la conexión. Si realiza una copia de seguridad de varias fuentes
a un repositorio de destino, se produce tráfico adicional para la resincronización de la caché.
En caso de que esté interesado en obtener más detalles, lea la documentación interna.
Unidades
Para mostrar cantidades, Borg se encarga de respetar las convenciones habituales de escala. Disco
los tamaños se muestran en decimal, usando potencias de diez (entonces kB significa 1000 bytes). Para memoria
el uso, binario prefijos se utilizan, y se indican mediante el IEC binario prefijos, utilizando
poderes de dos (así que Kb significa 1024 bytes).
Fecha y Horario
Formateamos fecha y hora conforme a ISO-8601, es decir: AAAA-MM-DD y HH: MM: SS (24h
reloj).
Para obtener más información al respecto, consulte: https://xkcd.com/1179/
A menos que se indique lo contrario, mostramos la fecha y hora locales. Internamente, almacenamos y procesamos
fecha y hora UTC.
BORG INIT
uso: borg init [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--remote-path PATH] [-e {none, keyfile, repokey}]
[REPOSITORIO]
Inicializar un repositorio vacío
argumentos posicionales:
REPOSITORIO repositorio para crear
argumentos opcionales:
-h, --help mostrar este mensaje de ayuda y salir
- trabajo crítico a nivel de registro CRÍTICO
--error trabajo en el nivel de registro ERROR
- advertencia de trabajo en el nivel de registro ADVERTENCIA (predeterminado)
--info, -v, --verbose
trabajar en el nivel de registro INFO
- trabajo de depuración en el nivel de registro DEBUG
--bloqueo-espera N espera el bloqueo, pero máx. N segundos (predeterminado: 1).
--show-rc muestra / registra el código de retorno (rc)
--no-files-cache no carga / actualiza el caché de metadatos del archivo usado para
detectar archivos sin cambios
--umask M establece umask en M (local y remoto, predeterminado: 0077)
--remote-path PATH establece la ruta remota en ejecutable (por defecto: "borg")
-e {ninguno, archivo de claves, repokey}, --encryption {ninguno, archivo de claves, repokey}
seleccione el modo de clave de cifrado (predeterminado: "repokey")
Descripción
Este comando inicializa un repositorio vacío. Un repositorio es un directorio del sistema de archivos
que contiene los datos deduplicados de cero o más archivos. El cifrado se puede habilitar en
tiempo de inicio del repositorio.
Ejemplos
# Repositorio local (el valor predeterminado es usar cifrado en modo repositorio)
$ borg init / ruta / a / repo
# Repositorio local (sin cifrado)
$ borg init --encryption = none / path / to / repo
# Repositorio remoto (accede a un borg remoto a través de ssh)
$ borg init usuario @ nombre de host: copia de seguridad
# Repositorio remoto (almacena la clave en tu directorio de inicio)
$ borg init --encryption = usuario del archivo de claves @ nombre de host: copia de seguridad
Notas importantes sobre el cifrado:
No se recomienda deshabilitar el cifrado. El cifrado del repositorio lo protege, p. Ej.
en el caso de que un atacante tenga acceso a su depósito de respaldo.
Pero tenga cuidado con la clave / frase de contraseña:
Si desea seguridad de "solo frase de contraseña", utilice la reponer modo. La clave se almacenará
dentro del repositorio (en su archivo "config"). En el escenario de ataque mencionado anteriormente, el
El atacante tendrá la clave (pero no la frase de contraseña).
Si desea seguridad de "contraseña y tener la clave", utilice la archivo de clave modo. La clave será
almacenarse en su directorio personal (en .config / borg / keys). En el escenario del ataque, el
El atacante que solo tiene acceso a su repositorio no tendrá la clave (y tampoco la
frase de contraseña).
Haga una copia de seguridad del archivo de clave (archivo de clave modo) o archivo de configuración de repositorio (reponer modo) y
guárdelo en un lugar seguro, para que aún tenga la clave en caso de que se dañe o se pierda. también
Guarde la frase de contraseña en un lugar seguro. La copia de seguridad que está encriptada con esa clave no
ayudarlo con eso, por supuesto.
Asegúrese de utilizar una buena frase de contraseña. Ni demasiado corto ni demasiado simple. El cifrado real /
La clave de descifrado está encriptada / bloqueada por su frase de contraseña. Si un atacante consigue tu
clave, no puede desbloquearla y usarla sin conocer la contraseña.
Tenga cuidado con los caracteres especiales o no ascii en su frase de contraseña:
· Borg procesa la frase de contraseña como unicode (y la codifica como utf-8), por lo que no tiene
problemas para tratar incluso con los personajes más extraños.
· PERO: eso no se aplica necesariamente a la configuración de su sistema operativo / VM / teclado.
Así que es mejor usar una frase de contraseña larga hecha de caracteres ascii simples que una que incluya
Cosas que no son ASCII o caracteres que son difíciles / imposibles de ingresar en un teclado diferente.
diseño.
Puede cambiar su frase de contraseña para repositorios existentes en cualquier momento, no afectará la
clave de cifrado / descifrado u otros secretos.
BORG CREAR
uso: borg create [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--ruta remota RUTA] [-s] [-p] [--lista]
[--filtro STATUSCHARS] [-e PATRÓN]
[--excluir-de EXCLUDEFILE] [--excluir-caches]
[--excluir-si-presente NOMBRE DE ARCHIVO] [--mantener-etiqueta-archivos]
[-c SEGUNDOS] [-x] [--numeric-owner]
[- marca de tiempo aaaa-mm-ddThh: mm: ss]
[--chunker-params CHUNK_MIN_EXP, CHUNK_MAX_EXP, HASH_MASK_BITS, HASH_WINDOW_SIZE]
[--ignore-inode] [-C COMPRESIÓN] [--read-special] [-n]
RUTA DE ARCHIVO [RUTA ...]
Crear nuevo archivo
argumentos posicionales:
ARCHIVO nombre del archivo que se va a crear (debe ser también un
nombre del directorio)
Rutas PATH para archivar
argumentos opcionales:
-h, --help mostrar este mensaje de ayuda y salir
- trabajo crítico a nivel de registro CRÍTICO
--error trabajo en el nivel de registro ERROR
- advertencia de trabajo en el nivel de registro ADVERTENCIA (predeterminado)
--info, -v, --verbose
trabajar en el nivel de registro INFO
- trabajo de depuración en el nivel de registro DEBUG
--bloqueo-espera N espera el bloqueo, pero máx. N segundos (predeterminado: 1).
--show-rc muestra / registra el código de retorno (rc)
--no-files-cache no carga / actualiza el caché de metadatos del archivo usado para
detectar archivos sin cambios
--umask M establece umask en M (local y remoto, predeterminado: 0077)
--remote-path PATH establece la ruta remota en ejecutable (por defecto: "borg")
-s, --stats imprime estadísticas para el archivo creado
-p, --progress muestra la pantalla de progreso mientras se crea el archivo,
mostrando los tamaños original, comprimido y deduplicado,
seguido del Número de archivos vistos y la ruta
en proceso, predeterminado: falso
- lista de salida lista detallada de elementos (archivos, directorios, ...)
--filter STATUSCHARS solo muestra elementos con los caracteres de estado dados
-e PATRÓN, --excluir PATRÓN
excluir rutas que coincidan con el PATRÓN
--excluir-de EXCLUDEFILE
leer patrones de exclusión de EXCLUDEFILE, uno por línea
--exclude-caches excluye directorios que contienen un archivo CACHEDIR.TAG
(http://www.brynosaurus.com/cachedir/spec.html)
--excluir-si-está presente NOMBRE DE ARCHIVO
excluir directorios que contienen el archivo especificado
--keep-tag-files mantiene archivos de etiquetas de cachés / directorios excluidos
-c SEGUNDOS, - intervalo de punto de control SEGUNDOS
escribir punto de control cada SEGUNDO segundos (predeterminado: 300)
-x, --un sistema de archivos
permanecer en el mismo sistema de archivos, no cruzar puntos de montaje
--numeric-owner solo almacena identificadores numéricos de usuarios y grupos
- marca de tiempo aaaa-mm-ddThh: mm: ss
especifique manualmente la fecha / hora de creación del archivo (UTC).
alternativamente, proporcione un archivo / directorio de referencia.
--chunker-params CHUNK_MIN_EXP, CHUNK_MAX_EXP, HASH_MASK_BITS, HASH_WINDOW_SIZE
especificar los parámetros de chunker. predeterminado: 19,23,21,4095
--ignore-inode ignora los datos de inodo en la caché de metadatos del archivo que se usa para
detectar archivos sin cambios.
-C COMPRESIÓN, --compresión COMPRESIÓN
seleccionar algoritmo de compresión (y nivel): ninguno == no
compresión (predeterminado), lz4 == lz4, zlib == zlib
(nivel predeterminado 6), zlib, 0 .. zlib, 9 == zlib (con
nivel 0..9), lzma == lzma (nivel predeterminado 6), lzma, 0 ..
lzma, 9 == lzma (con nivel 0..9).
--read-special abre y lee archivos especiales como si fueran normales
archivos
-n, --dry-run no crea un archivo de respaldo
Descripción
Este comando crea un archivo de respaldo que contiene todos los archivos encontrados de forma recursiva
atravesando todos los caminos especificados. El archivo casi no consumirá espacio en disco para archivos o
partes de archivos que ya se han almacenado en otros archivos.
Para acelerar la extracción de copias de seguridad sobre sshfs y sistemas de archivos de red similares que no
proporcionar información correcta de inodo, se puede usar el indicador --ignore-inode. Esto potencialmente
disminuye la confiabilidad de la detección de cambios, evitando siempre leer todos los archivos en
estos sistemas de archivos.
Consulte el resultado del comando "patrones de ayuda de borg" para obtener más ayuda sobre patrones de exclusión.
Ejemplos
# Respaldo ~ / Documentos en un archivo llamado "mis-documentos"
$ borg crear / ruta / a / repo :: mis-documentos ~ / Documentos
# lo mismo, pero enumera detalladamente todos los archivos a medida que los procesamos
$ borg create -v --list / path / to / repo :: my-documents ~ / Documentos
# Respaldo ~ / Documentos y ~ / src pero excluir archivos pyc
$ borg crear / ruta / a / repo :: mis-archivos \
~ / Documentos \
~ / src \
--excluir '* .pyc'
# Copia de seguridad de directorios de inicio excluyendo miniaturas de imágenes (es decir, solo
# /casa/* /. se excluyen las miniaturas, no /casa/* / * /. miniaturas)
$ borg crear / ruta / a / repo :: mis-archivos / home \
--excluir 're: ^/casa/[^ /] + / \. miniaturas / '
# Haz lo mismo usando un patrón estilo caparazón
$ borg crear / ruta / a / repo :: mis-archivos / home \
--excluir 'sh:/casa/* /. miniaturas '
# Haga una copia de seguridad del sistema de archivos raíz en un archivo llamado "root-YYYY-MM-DD"
# use compresión zlib (buena, pero lenta) - el valor predeterminado es sin compresión
$ borg create -C zlib, 6 / path / to / repo :: root- {ahora:% Y-% m-% d} / --one-file-system
# Realice un gran esfuerzo en la deduplicación granular fina (gestión de grandes
# gastos generales, necesita mucha RAM y espacio en disco, vea la fórmula en los componentes internos
# docs - mismos parámetros que borg <1.0 o ático):
$ borg crear --chunker-params 10,23,16,4095 / ruta / a / repo :: small / smallstuff
# Copia de seguridad de un dispositivo sin formato (no debe estar activo / en uso / montado en ese momento)
$ dd si = / dev / sdx bs = 10M | borg crear / ruta / a / repo :: my-sdx -
# Sin compresión (predeterminado)
$ borg crear / ruta / a / repo :: arch ~
# Compresión súper rápida y baja
$ borg crear --compresión lz4 / ruta / a / repo :: arch ~
# Compresión más alta y menos rápida (N = 0..9)
$ borg crear --compresión zlib, N / ruta / a / repo :: arch ~
# Compresión aún más lenta, aún más alta (N = 0..9)
$ borg crear --compresión lzma, N / ruta / a / repo :: arch ~
# Etiquetas de formato disponibles para el nombre del archivo:
# {ahora}, {utcnow}, {fqdn}, {nombre de host}, {usuario}, {pid}
# agregue el nombre de host corto, el nombre de usuario de respaldo y el tiempo único actual (segundos desde la época)
$ borg crear / ruta / a / repositorio :: {nombre de host} - {usuario} - {ahora:% s} ~
BORG EXTRAER
uso: extracto de borg [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--ruta remota RUTA] [--lista] [-n] [-e PATRÓN]
[--excluir-de EXCLUDEFILE] [--numeric-owner]
[--strip-components NÚMERO] [--stdout] [--sparse]
ARCHIVO [RUTA [RUTA ...]]
Extraer el contenido del archivo
argumentos posicionales:
Archivo ARCHIVO para extraer
PATH caminos para extraer; los patrones son compatibles
argumentos opcionales:
-h, --help mostrar este mensaje de ayuda y salir
- trabajo crítico a nivel de registro CRÍTICO
--error trabajo en el nivel de registro ERROR
- advertencia de trabajo en el nivel de registro ADVERTENCIA (predeterminado)
--info, -v, --verbose
trabajar en el nivel de registro INFO
- trabajo de depuración en el nivel de registro DEBUG
--bloqueo-espera N espera el bloqueo, pero máx. N segundos (predeterminado: 1).
--show-rc muestra / registra el código de retorno (rc)
--no-files-cache no carga / actualiza el caché de metadatos del archivo usado para
detectar archivos sin cambios
--umask M establece umask en M (local y remoto, predeterminado: 0077)
--remote-path PATH establece la ruta remota en ejecutable (por defecto: "borg")
- lista de salida lista detallada de elementos (archivos, directorios, ...)
-n, --dry-run en realidad no cambian ningún archivo
-e PATRÓN, --excluir PATRÓN
excluir rutas que coincidan con el PATRÓN
--excluir-de EXCLUDEFILE
leer patrones de exclusión de EXCLUDEFILE, uno por línea
--numeric-owner solo obedece a identificadores numéricos de usuarios y grupos
--strip-components NÚMERO
Elimina el número especificado de elementos de la ruta principal.
Los nombres de ruta con menos elementos serán silenciosos
omitido.
--stdout escribe todos los datos extraídos en stdout
--sparse crea agujeros en el archivo disperso de salida desde todo cero
trozos
Descripción
Este comando extrae el contenido de un archivo. De forma predeterminada, todo el archivo está
extraído, pero se puede seleccionar un subconjunto de archivos y directorios pasando una lista de Caminos
como argumentos. La selección de archivos se puede restringir aún más mediante el --excluir .
Consulte el resultado del comando "patrones de ayuda de borg" para obtener más ayuda sobre patrones de exclusión.
Ejemplos
# Extraer archivo completo
$ borg extraer / ruta / a / repo :: mis-archivos
# Extraiga archivos completos y listas de archivos durante el procesamiento
$ borg extract -v --list / path / to / repo :: my-files
# Extrae el directorio "src"
$ borg extraer / ruta / a / repositorio :: inicio de mis archivos / NOMBRE DE USUARIO / src
# Extrae el directorio "src" pero excluye los archivos objeto
$ borg extraer / ruta / a / repositorio :: inicio de mis archivos / NOMBRE DE USUARIO / src --excluir '* .o'
# Restaurar un dispositivo sin formato (no debe estar activo / en uso / montado en ese momento)
$ borg extracto --stdout / ruta / a / repo :: my-sdx | dd de = / dev / sdx bs = 10M
Nota: actualmente, extraerlos hacerlo escribe dentro las corriente trabajando directorio ("."),
así que asegúrate de cd al lugar correcto antes de llamar borg extraerlos.
BORG CHEQUE
uso: verificación de borg [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--ruta remota PATH] [--solo repositorio] [--solo archivos]
[--reparar] [--ahorrar espacio] [--último N] [-P PREFIJO]
[REPOSITORIO_OR_ARCHIVO]
Verificar la consistencia del repositorio
argumentos posicionales:
REPOSITORIO_OR_ARCHIVO
repositorio o archivo para comprobar la coherencia de
argumentos opcionales:
-h, --help mostrar este mensaje de ayuda y salir
- trabajo crítico a nivel de registro CRÍTICO
--error trabajo en el nivel de registro ERROR
- advertencia de trabajo en el nivel de registro ADVERTENCIA (predeterminado)
--info, -v, --verbose
trabajar en el nivel de registro INFO
- trabajo de depuración en el nivel de registro DEBUG
--bloqueo-espera N espera el bloqueo, pero máx. N segundos (predeterminado: 1).
--show-rc muestra / registra el código de retorno (rc)
--no-files-cache no carga / actualiza el caché de metadatos del archivo usado para
detectar archivos sin cambios
--umask M establece umask en M (local y remoto, predeterminado: 0077)
--remote-path PATH establece la ruta remota en ejecutable (por defecto: "borg")
- solo repositorio realiza comprobaciones de repositorio
--archives-only realiza comprobaciones de archivos
- intento de reparación para reparar cualquier inconsistencia encontrada
- ahorra espacio trabaja más lento, pero usa menos espacio
--last N solo verifica los últimos N archivos (predeterminado: todos)
-P PREFIJO, --prefijo PREFIJO
solo considere los nombres de archivo que comienzan con este prefijo
Descripción
El comando check verifica la consistencia de un repositorio y los archivos correspondientes.
Primero, se verifican los archivos de datos del repositorio subyacente:
· Para todos los segmentos, el segmento mágico (encabezado) está marcado
· Para todos los objetos almacenados en los segmentos, todos los metadatos (por ejemplo, crc y tamaño) y todos los datos son
leer. Los datos leídos se verifican por tamaño y CRC. Pudrición de bits y otros tipos de accidentes
el daño se puede detectar de esta manera.
· Si estamos en modo de reparación y se detecta un error de integridad para un segmento, intentamos
recuperar tantos objetos del segmento como sea posible.
· En el modo de reparación, se asegura de que el índice sea coherente con los datos almacenados en el
segmentos.
· Si utiliza un servidor de repositorio remoto a través de ssh:, la verificación del repositorio se ejecuta en el servidor de repositorio
sin causar un tráfico de red significativo.
· La verificación del repositorio se puede omitir usando la opción --archives-only.
En segundo lugar, se verifica la coherencia y corrección de los metadatos del archivo:
· ¿Está presente el manifiesto del repositorio? De lo contrario, se reconstruye a partir de fragmentos de metadatos de archivo (este
requiere leer y descifrar todos los metadatos y datos).
· Compruebe si el fragmento de metadatos del archivo está presente. si no es así, elimine el archivo del manifiesto.
· Para todos los archivos (elementos) en el archivo, para todos los fragmentos a los que hacen referencia estos archivos, verifique si
fragmento está presente (si no es así y estamos en modo de reparación, reemplácelo con un fragmento del mismo tamaño de
ceros). Esto requiere la lectura de archivos y metadatos de archivos, pero no datos.
· Si estamos en modo de reparación y revisamos todos los archivos: elimine los trozos huérfanos de
el repositorio.
· Si usa un servidor de repositorio remoto a través de ssh:, la verificación del archivo se ejecuta en el cliente
máquina (porque si el cifrado está habilitado, las comprobaciones requerirán descifrado y esto
siempre se realiza en el lado del cliente, porque se requerirá acceso clave).
· Las comprobaciones de archivo pueden llevar mucho tiempo, se pueden omitir utilizando el
- opción de solo repositorio.
BORG REBAUTIZAR
uso: borg renombrar [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--ruta remota RUTA]
ARCHIVO NEWNAME
Cambiar el nombre de un archivo existente
argumentos posicionales:
Archivo ARCHIVO para renombrar
NEWNAME el nuevo nombre de archivo que se utilizará
argumentos opcionales:
-h, --help mostrar este mensaje de ayuda y salir
- trabajo crítico a nivel de registro CRÍTICO
--error trabajo en el nivel de registro ERROR
- advertencia de trabajo en el nivel de registro ADVERTENCIA (predeterminado)
--info, -v, --verbose
trabajar en el nivel de registro INFO
- trabajo de depuración en el nivel de registro DEBUG
--bloqueo-espera N espera el bloqueo, pero máx. N segundos (predeterminado: 1).
--show-rc muestra / registra el código de retorno (rc)
--no-files-cache no carga / actualiza el caché de metadatos del archivo usado para
detectar archivos sin cambios
--umask M establece umask en M (local y remoto, predeterminado: 0077)
--remote-path PATH establece la ruta remota en ejecutable (por defecto: "borg")
Descripción
Este comando cambia el nombre de un archivo en el repositorio.
Ejemplos
$ borg crear / ruta / a / repo :: nombre de archivo ~
$ lista borg / ruta / a / repositorio
archivename Lun, 2016-02-15 19:50:19
$ borg renombrar / ruta / a / repo :: nombre de archivo nuevo nombre
$ lista borg / ruta / a / repositorio
nuevo nombre Lun, 2016-02-15 19:50:19
BORG Anuncia
uso: lista borg [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--ruta remota PATH] [--short] [--list-format LISTFORMAT]
[-P PREFIJO]
[REPOSITORIO_OR_ARCHIVO]
Enumerar el contenido del repositorio o archivo
argumentos posicionales:
REPOSITORIO_OR_ARCHIVO
repositorio / archivo para enumerar el contenido de
argumentos opcionales:
-h, --help mostrar este mensaje de ayuda y salir
- trabajo crítico a nivel de registro CRÍTICO
--error trabajo en el nivel de registro ERROR
- advertencia de trabajo en el nivel de registro ADVERTENCIA (predeterminado)
--info, -v, --verbose
trabajar en el nivel de registro INFO
- trabajo de depuración en el nivel de registro DEBUG
--bloqueo-espera N espera el bloqueo, pero máx. N segundos (predeterminado: 1).
--show-rc muestra / registra el código de retorno (rc)
--no-files-cache no carga / actualiza el caché de metadatos del archivo usado para
detectar archivos sin cambios
--umask M establece umask en M (local y remoto, predeterminado: 0077)
--remote-path PATH establece la ruta remota en ejecutable (por defecto: "borg")
- abre sólo los nombres de archivos / directorios de impresión, nada más
--formato de lista FORMATO DE LISTA
especificar el formato para la lista de archivos de almacenamiento (predeterminado:
"{mode} {user: 6} {group: 6} {size: 8d} {isomtime}
{path} {extra} {NEWLINE} ") Existe un" {formatkeys} "especial
para enumerar las claves disponibles
-P PREFIJO, --prefijo PREFIJO
solo considere los nombres de archivo que comienzan con este prefijo
Descripción
Este comando enumera el contenido de un repositorio o archivo.
Ejemplos
$ lista borg / ruta / a / repositorio
Lunes Lun, 2016-02-15 19:15:11
repo Lun, 2016-02-15 19:26:54
root-2016-02-15 Mon, 2016-02-15 19:36:29
nuevo nombre Lun, 2016-02-15 19:50:19
...
$ lista borg / ruta / a / repo :: root-2016-02-15
drwxr-xr-x root root 0 Lunes, 2016-02-15 17:44:27.
drwxrwxr-x root root 0 lun, 2016-02-15 19:04:49 bin
-rwxr-xr-x root root 1029624 Jue., 2014-11-13 00:08:51 bin / bash
lrwxrwxrwx root root 0 viernes, 2015-03-27 20:24:26 bin / bzcmp -> bzdiff
-rwxr-xr-x root root 2140 Vie, 2015-03-27 20:24:22 bin / bzdiff
...
$ borg list / path / to / repo :: archiveA --list-format = "{mode} {user: 6} {group: 6} {size: 8d} {isomtime} {path} {extra} {NEWLINE}"
drwxrwxr-x usuario usuario 0 dom, 2015-02-01 11:00:00.
drwxrwxr-x usuario usuario 0 dom, 2015-02-01 11:00:00 código
drwxrwxr-x usuario usuario 0 dom, 2015-02-01 11:00:00 código / myproject
-rw-rw-r-- usuario usuario 1416192 Dom, 2015-02-01 11:00:00 código / myproject / file.ext
...
# ver qué se cambia entre archivos, según la hora de modificación del archivo, el tamaño y la ruta del archivo
$ lista borg / ruta / a / repositorio :: archiveA --list-format = "{mtime:% s} {TAB} {size} {TAB} {ruta} {LF}" | sort -n> / tmp / list .archiveA
$ lista borg / ruta / al / repo :: archiveB --list-format = "{mtime:% s} {TAB} {size} {TAB} {ruta} {LF}" | sort -n> / tmp / list .archiveB
$ diferencia -y /tmp/list.archiveA /tmp/list.archiveB
1422781200 0. 1422781200 0.
1422781200 0 código 1422781200 0 código
1422781200 0 código / myproject 1422781200 0 código / myproject
1422781200 1416192 código / myproject / file.ext | 1454664653 1416192 código / myproject / file.ext
...
BORG BORRAR
uso: borg eliminar [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--ruta-ruta-remota RUTA] [-p] [-s] [-c] [--guardar-espacio]
[OBJETIVO]
Eliminar un repositorio o archivo existente
argumentos posicionales:
Archivo o repositorio de TARGET para eliminar
argumentos opcionales:
-h, --help mostrar este mensaje de ayuda y salir
- trabajo crítico a nivel de registro CRÍTICO
--error trabajo en el nivel de registro ERROR
- advertencia de trabajo en el nivel de registro ADVERTENCIA (predeterminado)
--info, -v, --verbose
trabajar en el nivel de registro INFO
- trabajo de depuración en el nivel de registro DEBUG
--bloqueo-espera N espera el bloqueo, pero máx. N segundos (predeterminado: 1).
--show-rc muestra / registra el código de retorno (rc)
--no-files-cache no carga / actualiza el caché de metadatos del archivo usado para
detectar archivos sin cambios
--umask M establece umask en M (local y remoto, predeterminado: 0077)
--remote-path PATH establece la ruta remota en ejecutable (por defecto: "borg")
-p, --progress muestra la pantalla de progreso al eliminar un solo archivo
-s, --stats imprime estadísticas para el archivo eliminado
-c, --cache-only elimina solo el caché local para el repositorio dado
- ahorra espacio trabaja más lento, pero usa menos espacio
Descripción
Este comando elimina un archivo del repositorio o del repositorio completo. Disco
el espacio se recupera en consecuencia. Si elimina el repositorio completo, la caché local para
también se elimina (si lo hay).
Ejemplos
# eliminar un solo archivo de respaldo:
$ borg eliminar / ruta / a / repositorio :: Lunes
# eliminar todo el repositorio y la caché local relacionada:
$ borg eliminar / ruta / a / repositorio
Solicitó BORRAR completamente el repositorio * incluidos * todos los archivos que contiene:
repo Lun, 2016-02-15 19:26:54
root-2016-02-15 Mon, 2016-02-15 19:36:29
nuevo nombre Lun, 2016-02-15 19:50:19
Escriba 'SÍ' si entiende esto y desea continuar: SÍ
BORG CIRUELA PASA
uso: borg prune [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--ruta remota RUTA] [-n] [-s] [--lista]
[--mantener-dentro DE] [-H POR HORA] [-d DIARIAMENTE] [-w SEMANAL]
[-m MENSUALMENTE] [-y ANUALMENTE] [-P PREFIX] [--save-space]
[REPOSITORIO]
Elimine los archivos del repositorio de acuerdo con las reglas especificadas
argumentos posicionales:
REPOSITORY repositorio para podar
argumentos opcionales:
-h, --help mostrar este mensaje de ayuda y salir
- trabajo crítico a nivel de registro CRÍTICO
--error trabajo en el nivel de registro ERROR
- advertencia de trabajo en el nivel de registro ADVERTENCIA (predeterminado)
--info, -v, --verbose
trabajar en el nivel de registro INFO
- trabajo de depuración en el nivel de registro DEBUG
--bloqueo-espera N espera el bloqueo, pero máx. N segundos (predeterminado: 1).
--show-rc muestra / registra el código de retorno (rc)
--no-files-cache no carga / actualiza el caché de metadatos del archivo usado para
detectar archivos sin cambios
--umask M establece umask en M (local y remoto, predeterminado: 0077)
--remote-path PATH establece la ruta remota en ejecutable (por defecto: "borg")
-n, --dry-run no cambia el repositorio
-s, --stats imprime estadísticas para el archivo eliminado
- lista de salida lista detallada de archivos que mantiene / elimina
--keep-within WITHIN mantiene todos los archivos dentro de este intervalo de tiempo
-H POR HORA, --keep-hourly POR HORA
número de archivos por hora para mantener
-d DIARIAMENTE, --keep-diariamente DIARIAMENTE
número de archivos diarios para mantener
-w SEMANAL, --keep-Weekly SEMANAL
número de archivos semanales para mantener
-m MENSUAL, --keep-mensual MENSUAL
número de archivos mensuales para mantener
-y ANUAL, --keep-anual ANUAL
número de archivos anuales para mantener
-P PREFIJO, --prefijo PREFIJO
solo considere los nombres de archivo que comienzan con este prefijo
- ahorra espacio trabaja más lento, pero usa menos espacio
Descripción
El comando prune poda un repositorio eliminando archivos que no coinciden con ninguno de los
opciones de retención especificadas. Este comando lo utilizan normalmente los scripts de copia de seguridad automatizados.
queriendo mantener una cierta cantidad de copias de seguridad históricas.
Por ejemplo, "-d 7" significa mantener la última copia de seguridad de cada día, hasta las 7 más recientes
días con copias de seguridad (los días sin copias de seguridad no cuentan). Las reglas se aplican desde cada hora.
anualmente, y las copias de seguridad seleccionadas por las reglas anteriores no cuentan para las de
reglas. El tiempo que se completa cada copia de seguridad se utiliza con fines de poda. Fechas y horas
se interpretan en la zona horaria local y las semanas van de lunes a domingo. Especificando un
número negativo de archivos para mantener significa que no hay límite.
La opción "--keep-within" toma un argumento de la forma " ", donde char es" H ",
"d", "w", "m", "y". Por ejemplo, "--keep-within 2d" significa mantener todos los archivos que fueron
creado en las últimas 48 horas. Se considera que "1m" significa "31d". Los archivos guardados con
esta opción no cuenta para los totales especificados por otras opciones.
Si se establece un prefijo con -P, solo se consideran los archivos que comienzan con el prefijo
para su eliminación y solo esos archivos cuentan para los totales especificados por las reglas.
De lo contrario, todos Los archivos en el repositorio son candidatos para ser eliminados.
Ejemplos
Tenga cuidado, podar es un comando potencialmente peligroso, eliminará los archivos de respaldo.
El valor predeterminado de la ciruela pasa se aplica a todos archivo in las repositorio a menos que restrinjas su
operación a un subconjunto de los archivos usando --prefijo. Cuando usas --prefijo, ten cuidado con
elija un buen prefijo, por ejemplo, no utilice un prefijo "foo" si no desea que coincida también
"foobar".
Se recomienda encarecidamente ejecutar siempre ciruela pasa - corrida en seco ... primero para que veas lo que es
lo haría sin que realmente hiciera nada.
# Mantenga 7 archivos de fin de día y 4 adicionales de fin de semana.
# Realice un ensayo sin borrar nada.
$ borg prune --dry-run --keep-daily = 7 --keep-Weekly = 4 / path / to / repo
# Lo mismo que el anterior, pero solo se aplica a los nombres de archivo que comienzan con "foo":
$ borg prune --keep-daily = 7 --keep-Weekly = 4 --prefix = foo / path / to / repo
# Mantenga 7 archivos al final del día, 4 archivos adicionales al final de la semana,
# y un archivo de fin de mes para cada mes:
$ borg prune --keep-daily = 7 --keep-Weekly = 4 --keep-Monthly = -1 / path / to / repo
# Mantenga todas las copias de seguridad de los últimos 10 días, 4 archivos adicionales de fin de semana,
# y un archivo de fin de mes para cada mes:
$ borg prune --keep-within = 10d --keep-Weekly = 4 --keep-Monthly = -1 / path / to / repo
BORG INFO
uso: borg info [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--ruta remota RUTA]
ARCHIVO
Mostrar detalles del archivo, como el espacio en disco utilizado
argumentos posicionales:
Archivo ARCHIVO para mostrar información sobre
argumentos opcionales:
-h, --help mostrar este mensaje de ayuda y salir
- trabajo crítico a nivel de registro CRÍTICO
--error trabajo en el nivel de registro ERROR
- advertencia de trabajo en el nivel de registro ADVERTENCIA (predeterminado)
--info, -v, --verbose
trabajar en el nivel de registro INFO
- trabajo de depuración en el nivel de registro DEBUG
--bloqueo-espera N espera el bloqueo, pero máx. N segundos (predeterminado: 1).
--show-rc muestra / registra el código de retorno (rc)
--no-files-cache no carga / actualiza el caché de metadatos del archivo usado para
detectar archivos sin cambios
--umask M establece umask en M (local y remoto, predeterminado: 0077)
--remote-path PATH establece la ruta remota en ejecutable (por defecto: "borg")
Descripción
Este comando muestra información detallada sobre el archivo especificado.
Ejemplos
$ borg info / ruta / a / repo :: root-2016-02-15
Nombre: root-2016-02-15
Fingerprint: 57c827621f21b000a8d363c1e163cc55983822b3afff3a96df595077a660be50
Nombre de host: myhostname
Nombre de usuario: root
Hora (inicio): Lun, 2016-02-15 19:36:29
Hora (fin): Lun, 2016-02-15 19:39:26
Línea de comando: / usr / local / bin / borg create -v --list -C zlib, 6 / path / to / repo :: root-2016-02-15 / --one-file-system
Número de archivos de: 38100
Tamaño original Tamaño comprimido Tamaño deduplicado
Este archivo: 1.33 GB 613.25 MB 571.64 MB
Todos los archivos: 1.63 GB 853.66 MB 584.12 MB
Trozos únicos Trozos totales
Índice de fragmentos: 36858 48844
BORG MONTE
uso: montaje de borg [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--remote-path RUTA] [-f] [-o OPCIONES]
REPOSITORIO_OR_ARCHIVO PUNTO DE MONTAJE
Monte un archivo o un repositorio completo como un sistema de archivos FUSE
argumentos posicionales:
REPOSITORIO_OR_ARCHIVO
repositorio / archivo para montar
MOUNTPOINT donde montar el sistema de archivos
argumentos opcionales:
-h, --help mostrar este mensaje de ayuda y salir
- trabajo crítico a nivel de registro CRÍTICO
--error trabajo en el nivel de registro ERROR
- advertencia de trabajo en el nivel de registro ADVERTENCIA (predeterminado)
--info, -v, --verbose
trabajar en el nivel de registro INFO
- trabajo de depuración en el nivel de registro DEBUG
--bloqueo-espera N espera el bloqueo, pero máx. N segundos (predeterminado: 1).
--show-rc muestra / registra el código de retorno (rc)
--no-files-cache no carga / actualiza el caché de metadatos del archivo usado para
detectar archivos sin cambios
--umask M establece umask en M (local y remoto, predeterminado: 0077)
--remote-path PATH establece la ruta remota en ejecutable (por defecto: "borg")
-f, --foreground permanece en primer plano, no daemonize
-o OPCIONES Opciones de montaje adicionales
Descripción
Este comando monta un archivo como un sistema de archivos FUSE. Esto puede resultar útil para explorar un
archivar o restaurar archivos individuales. A menos que el --primer plano se le da la opción al comando
se ejecutará en segundo plano hasta que el sistema de archivos esté montado.
Ejemplos
$ borg mount / ruta / a / repo :: root-2016-02-15 / tmp / mymountpoint
$ ls / tmp / mymountpoint
bin boot etc home lib lib64 medios perdidos + encontrados mnt opt root sbin srv tmp usr var
$ fusermount -u / tmp / mymountpoint
BORG CAMBIO DE CONTRASEÑA
uso: borg cambio-contraseña [-h] [--critical] [--error] [--warning] [--info]
[--debug] [--lock-wait N] [--show-rc]
[--no-files-cache] [--umask M]
[--ruta remota RUTA]
[REPOSITORIO]
Cambiar la frase de contraseña del archivo de claves del repositorio
argumentos posicionales:
REPOSITORIO
argumentos opcionales:
-h, --help mostrar este mensaje de ayuda y salir
- trabajo crítico a nivel de registro CRÍTICO
--error trabajo en el nivel de registro ERROR
- advertencia de trabajo en el nivel de registro ADVERTENCIA (predeterminado)
--info, -v, --verbose
trabajar en el nivel de registro INFO
- trabajo de depuración en el nivel de registro DEBUG
--bloqueo-espera N espera el bloqueo, pero máx. N segundos (predeterminado: 1).
--show-rc muestra / registra el código de retorno (rc)
--no-files-cache no carga / actualiza el caché de metadatos del archivo usado para
detectar archivos sin cambios
--umask M establece umask en M (local y remoto, predeterminado: 0077)
--remote-path PATH establece la ruta remota en ejecutable (por defecto: "borg")
Descripción
Los archivos de claves utilizados para el cifrado del repositorio están opcionalmente protegidos con contraseña. Esta
El comando se puede usar para cambiar esta frase de contraseña.
Ejemplos
# Crear un repositorio protegido de archivos de claves
$ borg init --encryption = keyfile -v / ruta / a / repositorio
Inicializando el repositorio en "/ ruta / a / repo"
Ingrese nueva contraseña:
Ingrese la misma contraseña nuevamente:
Recuerde su contraseña. Tus datos serán inaccesibles sin él.
Introduzca "/root/.config/borg/keys/mnt_backup" creado.
Guarde esta llave en un lugar seguro. Tus datos serán inaccesibles sin él.
Sincronizando caché de fragmentos ...
Archivos: 0, con Idx en caché: 0, con Idx desactualizado: 0, sin Idx en caché: 0.
Hecho.
# Cambiar la frase de contraseña del archivo de claves
$ borg cambiar-contraseña -v / ruta / a / repo
Ingrese la frase de contraseña para la clave /root/.config/borg/keys/mnt_backup:
Ingrese nueva contraseña:
Ingrese la misma contraseña nuevamente:
Recuerde su contraseña. Tus datos serán inaccesibles sin él.
Clave actualizada
BORG SIRVE
uso: borg serve [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--Ruta de ruta remota] [--restrict-to-path PATH]
Inicie en modo servidor. Este comando generalmente no se usa manualmente.
argumentos opcionales:
-h, --help mostrar este mensaje de ayuda y salir
- trabajo crítico a nivel de registro CRÍTICO
--error trabajo en el nivel de registro ERROR
- advertencia de trabajo en el nivel de registro ADVERTENCIA (predeterminado)
--info, -v, --verbose
trabajar en el nivel de registro INFO
- trabajo de depuración en el nivel de registro DEBUG
--bloqueo-espera N espera el bloqueo, pero máx. N segundos (predeterminado: 1).
--show-rc muestra / registra el código de retorno (rc)
--no-files-cache no carga / actualiza el caché de metadatos del archivo usado para
detectar archivos sin cambios
--umask M establece umask en M (local y remoto, predeterminado: 0077)
--remote-path PATH establece la ruta remota en ejecutable (por defecto: "borg")
--restringir-a-ruta RUTA
restringir el acceso al repositorio a PATH
Descripción
Este comando inicia un proceso de servidor de repositorio. Este comando generalmente no se usa
manualmente.
Ejemplos
borg serve tiene soporte especial para comandos forzados ssh (ver claves_autorizadas ejemplo
a continuación): detectará que utiliza un comando tan forzado y extraerá el valor del
--restringir a la ruta opción (es). Luego analizará el comando original que vino del
cliente, se asegura de que también sea borg ayudar y hacer cumplir las restricciones de ruta según lo indicado por
el comando forzado. De esa forma, otras opciones dadas por el cliente (como --información or --mascarilla)
se conservan (y no se corrigen mediante el comando forzado).
# Permita que un par de claves SSH solo ejecute borg, y solo tenga acceso a / path / to / repo.
# Utilice opciones clave para deshabilitar la funcionalidad SSH innecesaria y potencialmente peligrosa.
# Esto ayudará a asegurar un sistema de respaldo remoto automatizado.
$ gato ~ / .ssh / Authorizedkeys
command = "borg serve --restrict-to-path / path / to / repo", no-pty, no-agent-forwarding, no-port-forwarding, no-X11-forwarding, no-user-rc ssh-rsa AAAAB3 [...]
BORG REACONDICIONAR
uso: actualización de borg [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--remote-path RUTA] [-p] [-n] [-i]
[REPOSITORIO]
actualizar un repositorio de una versión anterior
argumentos posicionales:
Ruta del repositorio al repositorio que se actualizará
argumentos opcionales:
-h, --help mostrar este mensaje de ayuda y salir
- trabajo crítico a nivel de registro CRÍTICO
--error trabajo en el nivel de registro ERROR
- advertencia de trabajo en el nivel de registro ADVERTENCIA (predeterminado)
--info, -v, --verbose
trabajar en el nivel de registro INFO
- trabajo de depuración en el nivel de registro DEBUG
--bloqueo-espera N espera el bloqueo, pero máx. N segundos (predeterminado: 1).
--show-rc muestra / registra el código de retorno (rc)
--no-files-cache no carga / actualiza el caché de metadatos del archivo usado para
detectar archivos sin cambios
--umask M establece umask en M (local y remoto, predeterminado: 0077)
--remote-path PATH establece la ruta remota en ejecutable (por defecto: "borg")
-p, --progress muestra la pantalla de progreso mientras se actualiza el repositorio
-n, --dry-run no cambia el repositorio
-i, --inplace reescribir el repositorio en su lugar, sin posibilidad de ir
volver a versiones anteriores del repositorio.
Descripción
Actualice un repositorio Borg existente. Esto actualmente admite la conversión de un ático
repositorio a Borg y también ayuda a convertir Borg 0.xx a 1.0.
Actualmente, solo se pueden actualizar los repositorios LOCALES (problema n. ° 465).
Cambiará las cuerdas mágicas en los segmentos del repositorio para que coincidan con la nueva magia Borg.
instrumentos de cuerda. Los archivos de claves que se encuentran en $ ATTIC_KEYS_DIR o ~ / .attic / keys / también será convertido
y copiado a $ BORG_KEYS_DIR o ~ / .config / borg / keys.
Los archivos de caché se convierten, desde $ ATTIC_CACHE_DIR o ~ / .caché / ático a $ BORG_CACHE_DIR
or ~ / .cache / borg, pero el diseño de la caché entre Borg y Attic cambió, por lo que es posible
la primera copia de seguridad después de la conversión tarda más de lo esperado debido a la resincronización de la caché.
La actualización debería poder reanudarse si se interrumpe, aunque seguirá iterando sobre todos
segmentos. Si quiere empezar desde cero, utilice borg borrar sobre el repositorio copiado a
asegúrese de que los archivos de caché también se eliminen:
borg borrar borg
A no ser que --en su lugar se especifica, el proceso de actualización primero crea una copia de seguridad del
repositorio, en REPOSITORY.upgrade-DATETIME, utilizando enlaces físicos. Esto lleva más tiempo que en
colocar actualizaciones, pero es mucho más seguro y proporciona información de progreso (a diferencia de cp -Alabama).
Una vez que esté satisfecho con la conversión, puede destruir la copia de seguridad de forma segura.
ADVERTENCIA: Ejecutar la actualización en su lugar hará que la copia actual sea inutilizable con versiones más antiguas.
versión, sin posibilidad de volver a versiones anteriores. Esto puede DAÑAR PERMANENTEMENTE SU
¡REPOSITORIO! Ático NO PUEDE LEER LOS REPOSITORIOS BORG, ya que las cuerdas mágicas han cambiado. Ustedes
han sido advertidos.
Ejemplos
# Actualice el repositorio de borg a la versión más reciente.
$ borg actualización -v / ruta / a / repo
haciendo una copia de enlace físico en /path/to/repo.upgrade-2016-02-15-20:51:55
abriendo el depósito del ático con borg y convirtiendo
no se ha encontrado ningún archivo de clave para el repositorio
conversión de índice de repositorio /ruta/a/repo/index.0
convertir 1 segmentos ...
convertir borg 0.xx en corriente borg
no se ha encontrado ningún archivo de clave para el repositorio
OTRO AYUDA
borg ayuda .
Los patrones de exclusión admiten cuatro estilos separados, fnmatch, shell, expresiones regulares y
prefijos de ruta. Si va seguido de dos puntos (':'), se utilizan los dos primeros caracteres de un patrón
como selector de estilo. La selección de estilo explícita es necesaria cuando se utiliza un estilo no predeterminado.
deseado o cuando el patrón deseado comienza con dos caracteres alfanuméricos seguidos de un
colon (es decir aa: algo / *).
partido, seleccionador FM:
Estos patrones utilizan una variante de la sintaxis del patrón de shell, con '*' que coincide con cualquier número de
caracteres, '?' coincidir con cualquier carácter individual, '[...]' coincidir con cualquier carácter individual
especificado, incluidos los rangos, y '[! ...]' que coincida con cualquier carácter no especificado. Para el
propósito de estos patrones, el separador de ruta ('' para Windows y '/' en otros sistemas)
no se trata especialmente. Envuelva los metacaracteres entre paréntesis para una coincidencia literal (es decir,
[?] para que coincida con el carácter literal ?). Para que una ruta coincida con un patrón, debe
coincidir completamente de principio a fin, o debe coincidir desde el principio hasta justo antes de una ruta
separador. Excepto por la ruta raíz, las rutas nunca terminarán en el separador de rutas cuando
se intenta la coincidencia. Por lo tanto, si un patrón dado termina en un separador de ruta, un '*' es
añadido antes de intentar la coincidencia.
Patrones estilo caparazón, selector sh:
Al igual que los patrones de fnmatch, estos son similares a los patrones de caparazón. La diferencia es que el
el patrón puede incluir ** / para hacer coincidir cero o más niveles de directorio, * para igualar cero
o caracteres más arbitrarios con la excepción de cualquier separador de ruta.
Expresiones regulares, selector re:
Se admiten expresiones regulares similares a las que se encuentran en Perl. A diferencia de los patrones de concha
No se requieren expresiones regulares para coincidir con la ruta completa y cualquier coincidencia de subcadena
es suficiente. Se recomienda encarecidamente anclar los patrones al inicio ('^'), al
end ('$') o ambos. Separadores de ruta ('' para Windows y '/' en otros sistemas) en rutas
siempre se normalizan a una barra inclinada ('/') antes de aplicar un patrón. El regular
la sintaxis de la expresión se describe en la Python documentación para las re módulo.
Ruta de prefijo, selector páginas:
Este estilo de patrón es útil para hacer coincidir subdirectorios completos. El patrón pp: / datos / barra
cerillas / data / bar y todo lo que contiene.
Las exclusiones se pueden pasar a través de la opción de línea de comando --excluir. Cuando se usa desde dentro de un
shell los patrones deben ser citados para protegerlos de la expansión.
El --excluir de La opción permite cargar patrones de exclusión de un archivo de texto con una
patrón por línea. Líneas vacías o comenzando con el signo de número ('#') después de eliminar
los espacios en blanco en ambos extremos se ignoran. También se admite el prefijo de selector de estilo opcional
para patrones cargados desde un archivo. Debido a las rutas de eliminación de espacios en blanco con espacios en blanco en el
el principio o el final solo se pueden excluir mediante expresiones regulares.
Ejemplos:
# Excluir '/home/user/file.o' pero no '/home/user/file.odt': $ borg create -e '
*
.o 'copia de seguridad /
# Excluya '/ home / user / junk' y '/ home / user / subdir / junk' pero # no
'/ home / user / importantjunk' o '/ etc / junk': $ borg create -e '/casa/
*
/ copia de seguridad basura /
# Excluir el contenido de '/ home / user / cache' pero no el directorio en sí: $ borg create
-e / inicio / usuario / caché / copia de seguridad /
# El archivo '/ home / user / cache / important' es no copia de seguridad: $ borg create -e
/ inicio / usuario / caché / copia de seguridad / / inicio / usuario / caché / importante
# El contenido de los directorios en '/ home'no se respaldan cuando su nombre # termina en
'.tmp' $ borg create --exclude 're: ^/casa/[^ /] +. tmp / 'copia de seguridad /
# Cargar exclusiones del archivo $ cat> exclude.txt < /casa//basura * .tmp
fm: aa: algo / re: ^/casa/[^ /]. tmp / sh:/casa/
*
/.thumbnails EOF $ borg crear --excluir-de excluir.txt copia de seguridad /
DEBUG COMANDOS
Hay algunos comandos más (todos comienzan con "debug-") que son todos no Destinado a para
normal utilizan el y la posibilidad muy mas peligroso si se usa incorrectamente.
Existen para mejorar las capacidades de depuración sin acceso directo al sistema, por ejemplo, en caso de
alguna vez se ha encontrado con un mal funcionamiento grave. Úselos solo si sabe lo que está haciendo o
si un desarrollador Borg de confianza le dice qué hacer.
ADICIONAL NOTAS
Aquí hay varios. notas sobre temas que tal vez no estén cubiertos con suficiente detalle en el uso
.
Asunto banderas
borg Para crear -v --lista genera una lista detallada de todos los archivos, directorios y otros archivos
elementos del sistema que consideró (sin importar si tenían cambios de contenido o no). Para cada
elemento, antepone una bandera de una sola letra que indica el tipo y / o estado del elemento.
Si está interesado solo en un subconjunto de esa salida, puede dar, por ejemplo, --filtro = AME y
solo mostrará archivos normales con estado A, M o E (ver más abajo).
Un carácter en mayúsculas representa el estado de un archivo normal en relación con los "archivos".
caché (no relativo al repositorio; esto es un problema si no se utiliza la caché de archivos).
Los metadatos se almacenan en cualquier caso y para 'A' y 'M' también se almacenan nuevos fragmentos de datos. Para
'U' todos los fragmentos de datos se refieren a fragmentos ya existentes.
· 'A' = archivo normal, agregado (ver también a_status_oddity en las preguntas frecuentes)
· 'M' = archivo normal, modificado
· 'U' = archivo normal, sin cambios
· 'E' = archivo normal, ocurrió un error al acceder / leer así presentar
Un carácter en minúscula significa un tipo de archivo que no es un archivo normal, generalmente borg solo
almacena sus metadatos:
· 'D' = directorio
· 'B' = dispositivo de bloqueo
· 'C' = dispositivo de caracteres
· 'H' = archivo normal, enlace fijo (a inodos ya vistos)
· 'S' = enlace simbólico
· 'F' = quince
Otras banderas utilizadas incluyen:
· 'I' = los datos de respaldo se leyeron desde la entrada estándar (stdin)
· '-' = ejecución en seco, el elemento fue no respaldado
· '?' = falta el código de estado (si ve esto, envíe un informe de error)
--chunker-parámetros
Los parámetros de chunker influyen en cómo se cortan los archivos de entrada en trozos (trozos) que luego se
considerado para la deduplicación. También tienen un gran impacto en el uso de recursos (RAM y disco
espacio) ya que la cantidad de recursos necesarios está (también) determinada por la cantidad total de
fragmentos en el repositorio (ver Índices / Cachés memoria personal para más detalles).
--chunker-params = 10,23,16,4095 da como resultado una deduplicación detallada y crea una gran
cantidad de fragmentos y, por lo tanto, utiliza una gran cantidad de recursos para administrarlos. Esto es bueno para
volúmenes de datos relativamente pequeños y si la máquina tiene una buena cantidad de RAM y disco libres
espacio.
--chunker-params = 19,23,21,4095 (predeterminado) da como resultado una deduplicación de grano grueso y
crea una cantidad mucho menor de fragmentos y, por lo tanto, utiliza menos recursos. Esto es bueno para
volúmenes de datos relativamente grandes y si la máquina tiene una cantidad relativamente baja de RAM libre y
Espacio del disco.
Si ya ha creado algunos archivos en un repositorio y luego cambia los parámetros de chunker,
esto, por supuesto, afecta la deduplicación, ya que los fragmentos se cortarán de manera diferente.
En el peor de los casos (todos los archivos son grandes y se tocaron entre copias de seguridad), esto almacenará
todo el contenido en el repositorio nuevamente.
Sin embargo, por lo general, no es tan malo:
· Por lo general, la mayoría de los archivos no se tocan, por lo que simplemente reutilizará los fragmentos antiguos que ya tiene.
en el repositorio
· Los archivos más pequeños que el tamaño de fragmento mínimo (tanto antiguo como nuevo) dan como resultado solo un fragmento
de todos modos, por lo que los fragmentos resultantes son los mismos y se aplicará la deduplicación
Si cambia los parámetros de chunker para ahorrar recursos para un repositorio existente que ya tiene algunos
archivos de copia de seguridad, verá un efecto creciente con el tiempo, cuando más y más archivos
han sido tocados y almacenados nuevamente usando el tamaño de trozo más grande y todas las referencias al
Se han eliminado fragmentos antiguos más pequeños (eliminando / podando archivos).
Si desea ver un gran efecto inmediato en el uso de recursos, es mejor que comience una nueva
repositorio al cambiar los parámetros de chunker.
Para obtener más detalles, consulte chunker_details.
--leer-especial
La opción --leer-especial no está diseñado para el nivel de sistema de archivos normal (completo o
copias de seguridad parcialmente recursivas). Solo das esta opción si quieres hacer algo en lugar
... especial, y si ha seleccionado algunos archivos que desea tratar de esa manera.
borg Para crear --leer-especial abrirá todos los archivos sin hacer ningún tratamiento especial
según el tipo de archivo (la única excepción aquí son los directorios: se repetirán
en). Solo imagina lo que pasa si lo haces gato nombre de archivo --- el contenido que verá allí
es lo que borg hará una copia de seguridad para ese nombre de archivo.
Entonces, por ejemplo, se seguirán los enlaces simbólicos, se leerá el contenido del dispositivo de bloqueo, se nombrarán canalizaciones
/ Se leerán los sockets de dominio UNIX.
Debe tener cuidado con lo que da como nombre de archivo cuando usa --leer-especial, por ejemplo, si
das / dev / zero, su copia de seguridad nunca terminará.
Los metadatos de los archivos dados se guardan como se guardarían sin --leer-especial (por ejemplo, su
nombre, su tamaño [puede ser 0], su modo, etc.), pero además, también el contenido leído
de él se guardará para él.
Restaurar el contenido de dichos archivos actualmente solo se admite uno a la vez a través de --salida estándar
opción (y tiene que redirigir stdout a donde quiera que vaya, tal vez directamente a un
archivo de dispositivo existente de su elección o indirectamente a través de dd).
Ejemplo
Imagine que ha realizado algunas instantáneas de los volúmenes lógicos (LV) de los que desea realizar una copia de seguridad.
NOTA:
Para algunos escenarios, este es un buen método para obtener una consistencia "similar a un bloqueo" (yo lo llamo
similar a un choque porque es lo mismo que obtendría si solo presiona el botón de reinicio o
su máquina se estrellaría abrupta y completamente). Esto es mejor que no tener consistencia
en absoluto y un buen método para algunos casos de uso, pero probablemente no lo suficientemente bueno si tiene
bases de datos en ejecución.
Luego, crea un archivo de respaldo de todas estas instantáneas. El proceso de copia de seguridad verá un
estado "congelado" de los volúmenes lógicos, mientras que los procesos que trabajan en los volúmenes originales
continúe cambiando los datos almacenados allí.
También agrega la salida de lvdisplay a su copia de seguridad, para que pueda ver los tamaños de LV en caso de
alguna vez necesitará recrearlos y restaurarlos.
Una vez finalizada la copia de seguridad, vuelve a eliminar las instantáneas.
$ # crea instantáneas aquí
$ lvdisplay> lvdisplay.txt
$ borg create --read-special / path / to / repo :: arch lvdisplay.txt / dev / vg0 / * - instantánea
$ # eliminar instantáneas aquí
Ahora, veamos cómo restaurar algunos LV a partir de dicha copia de seguridad.
$ borg extraer / ruta / a / repo :: arch lvdisplay.txt
$ # cree LV vacíos con los tamaños correctos aquí (mire en lvdisplay.txt).
$ # asumimos que creó una raíz vacía y un LV de inicio y lo sobrescribe ahora:
$ borg extract --stdout / ruta / a / repo :: arch dev / vg0 / root-snapshot> / dev / vg0 / root
$ borg extract --stdout / ruta / a / repo :: arch dev / vg0 / home-snapshot> / dev / vg0 / home
Solo anexar modo
Un repositorio se puede hacer "solo para agregar", lo que significa que Borg nunca sobrescribirá ni
eliminar datos comprometidos. Esto es útil para escenarios en los que varias máquinas realizan copias de seguridad en un
servidor de respaldo central usando borg ayudar , ya que una máquina pirateada no puede eliminar copias de seguridad
permanentemente.
Para activar el modo de solo agregar, edite el repositorio config archivo y agregue una línea append_only = 1
En el correo electrónico “Su Cuenta de Usuario en su Nuevo Sistema XNUMXCX”. [repositorio] sección (o edite la línea si existe).
En el modo de solo adición, Borg creará un registro de transacciones en el transacciones archivo, donde
cada línea es una transacción y una marca de tiempo UTC.
Ejemplo
Supongamos que un atacante eliminó de forma remota todas las copias de seguridad, pero su repositorio estaba solo en anexo.
modo. Un registro de transacciones en esta situación podría verse así:
transacción 1, hora UTC 2016-03-31T15: 53: 27.383532
transacción 5, hora UTC 2016-03-31T15: 53: 52.588922
transacción 11, hora UTC 2016-03-31T15: 54: 23.887256
transacción 12, hora UTC 2016-03-31T15: 55: 54.022540
transacción 13, hora UTC 2016-03-31T15: 55: 55.472564
De sus registros de seguridad, concluye que el atacante obtuvo acceso a las 15:54:00 y todos los
las copias de seguridad fueron eliminadas o reemplazadas por copias de seguridad comprometidas. Por el registro sabes que
las transacciones 11 y posteriores están comprometidas. Tenga en cuenta que el ID de la transacción es el nombre del
pasado archivo en la transacción. Por ejemplo, la transacción 11 abarca los archivos 6 a 11.
En un ataque real, probablemente querrá mantener intacto el repositorio comprometido para analizar
lo que el atacante trató de lograr. También es una buena idea hacer esta copia por si acaso
algo sale mal durante la recuperación. Dado que la recuperación se realiza eliminando algunos archivos,
copia de enlace durocp -Alabama) es suficiente.
El primer paso para restablecer el repositorio a la transacción 5, el último sin compromisos
transacción, es eliminar el sugerencias.N y índice.N archivos en el repositorio (estos dos archivos
son siempre prescindibles). En este ejemplo, N es 13.
Luego elimine o mueva todos los archivos de segmento de los directorios de segmento en fecha / empezando con
archivo 6:
rm datos / ** / {6..13}
Eso es todo.
Inconvenientes
Como los datos solo se agregan y no se elimina nada, comandos como ciruela pasa or borrar no liberará
espacio en disco, simplemente etiquetan los datos como eliminados en una nueva transacción.
Tenga en cuenta que puede alternar entre la operación normal y la operación de solo anexar editando
el archivo de configuración, no es un "viaje de ida".
Promover consideraciones
El modo de solo adición no es respetado por herramientas distintas de Borg. rm todavía funciona en el
repositorio. Asegúrese de que las máquinas cliente de respaldo solo accedan al repositorio a través de
borg ayudar .
Asegúrese de que no sea posible el acceso remoto si el repositorio se establece temporalmente en normal
modo para, por ejemplo, poda regular.
Se pueden implementar más protecciones, pero están fuera del alcance de Borgs. Por ejemplo, archivo
instantáneas del sistema o envoltura borg ayudar para establecer permisos especiales o ACL en nuevos datos
archivos.
Use borgbackup en línea usando los servicios de onworks.net
