Esta página fue traducida automáticamente. Lee el original en inglés. English

Copias de seguridad Firebird

gbak y nbackup programados, para una base de datos o para todas las bases de datos de una carpeta. Para gbak, puedes activar una restauración de prueba después de cada copia de seguridad. Una base de datos se actualiza desde una copia de seguridad automáticamente, y ningún fallo a mitad de camino la deja en un estado desconocido.

  • 6 tipos de tareas de copia de seguridad
  • nbackup niveles 0…4
  • zip · gz · zstd con verificación del archivo
  • S3 sin archivo intermedio
  • restauración de prueba

Dos herramientas

gbak o nbackup

HQbird admite ambos tipos de copia de seguridad de Firebird, y puedes usar ambos para una misma base de datos. gbak hace una copia lógica: es más pequeña que la base de datos, y una restauración la verifica. nbackup copia páginas de la base de datos: es rápido, y los incrementos ocupan poco espacio.

gbak (copia de seguridad verificada)nbackup (incremental)
Qué copiaDatos y metadatos. La basura y las versiones antiguas de registros no entran en la copia.Páginas del archivo de base de datos. El nivel 0 es completo; los niveles 1…N contienen solo las páginas modificadas.
TamañoNormalmente mucho más pequeño que la base de datos; se comprime bien.El nivel 0 es del tamaño de la base de datos; los incrementos son pequeños.
RestauraciónCrea una nueva base de datos y reconstruye los índices de nuevo. Para bases de datos grandes esto lleva mucho tiempo.Fusiona la cadena de niveles. Rápido.
VerificaciónRestauración de prueba después de cada copia de seguridad, si está activada en la tarea.Verificación de la cadena por GUID. Sin nivel 0 — el agente lo crea de inmediato.
Úsalo paraUna copia fiable, mover entre versiones y servidores, Backup-Restore-Replace.Puntos de restauración frecuentes durante el día sin carga en el servidor.

Si gbak y nbackup de una misma base de datos deben comenzar en el mismo minuto, gbak se desplaza 15 minutos más tarde. Mientras nbackup usa la base de datos, gbak espera (hasta 60 minutos por defecto) y no falla.

Tipos de tareas

Tareas individuales y de grupo

Una tarea individual cubre una base de datos y tiene su propia configuración. Úsala para la base de datos principal de la empresa: su propio horario, su propia carpeta, su propia retención.

Una tarea de grupo cubre carpetas con bases de datos. Un conjunto de ajustes para todas las bases de datos del grupo. En cada ciclo, el agente vuelve a escanear las carpetas por máscaras, así una nueva base de datos entra en la copia de seguridad automáticamente, sin cambiar la configuración.

Una base de datosTodas las bases de datos en carpetas
gbak con verificaciónvbackupgrpvbackup
nbackup con nivelesnbackupgrpnbackup
volcado de nbackupnbackup_dumpgrpnbackup_dump

Qué toma una tarea de grupo y qué omite

El agente recorre las carpetas y comprueba cada archivo contra las máscaras de inclusión y exclusión. Opcionalmente, también comprueba el tamaño mínimo y el inicio del archivo. Los archivos de copia de seguridad (.fbk, .nbk, .delta, archivos) nunca entran en la copia de seguridad.

Una base de datos que tiene su propia tarea individual se excluye del grupo automáticamente, incluso si esa tarea está desactivada. Un grupo de gbak no toma bases de datos de tareas individuales de gbak. Un grupo de nbackup no toma bases de datos de tareas de nbackup y de volcado.

Las bases de datos del sistema (nombres que comienzan con security y examples) siempre se omiten. La vista previa del escaneo muestra el motivo de cada omisión.

D:\data\ · máscara *.fdb

  1. sales.fdben el grupo
  2. stock.fdben el grupo
  3. branch_new.fdb
    nueva base de datos: comienza con el nivel 0
    en el grupo
  4. erp.fdb
    tiene su propia tarea individual
    omitir
  5. security5.fdb
    base de datos del sistema
    omitir
  6. bck_sales_20261107.fbk
    archivo de copia de seguridad
    omitir
  7. orders.fdb.delta
    archivo delta de nbackup
    omitir
  • Base de datos eliminada de la carpetaSe convierte en «huérfana». Sus copias de seguridad se conservan según una regla: N días o siempre. O van a la carpeta _orphaned de inmediato y se eliminan después de 7 días.
  • Base de datos renombradaEl nuevo nombre inicia una nueva cadena desde el nivel 0. Las copias de seguridad antiguas se conservan según la regla para bases de datos huérfanas.
  • Fallos repetidosDespués de 5 fallos consecutivos, la base de datos se pausa durante 6 horas y luego se vuelve a intentar.
  • Un error en una base de datos no detiene el grupoEl grupo continúa con la siguiente base de datos. Este es el ajuste «Continuar con las siguientes bases de datos después de un error»; está activado por defecto para los grupos de gbak, nbackup, volcado y sweep.
  • Resultado del grupo en la fila de la tarea«Encontradas N bases de datos · correctas M · errores X · tiempo total». Los detalles tienen una tabla de bases de datos con error: nombre, ruta y el inicio del texto del error.
  • Presupuesto de tiempoUn ciclo no inicia nuevas bases de datos cuando el tiempo se ha agotado. Para los grupos de nbackup, puedes activar la continuación desde la siguiente base de datos en el siguiente ciclo.
  • ParalelismoCuántas bases de datos del grupo procesar al mismo tiempo. Un límite común para tareas largas en el servidor: por defecto, no se ejecutan más de dos al mismo tiempo.
  • Una operación por base de datosLas tareas individuales y de grupo, gbak y nbackup ven los bloqueos de los demás.
  • Árbol de carpetas como en el origenLa casilla «Repetir el árbol de carpetas de origen»: la copia de seguridad de la base de datos x/y/EMPLOYEE.FDB va a <backup folder>/x/y/EMPLOYEE.FDB/. Las bases de datos con el mismo nombre de carpetas diferentes no se estorban entre sí.
Tareas en HQ Monitor. Seis tipos de copia de seguridad y el inventario. Las tareas de restauración están en un grupo separado: debes permitirlas explícitamente, porque modifican bases de datos.

vbackup · grpvbackup

gbak: copia de seguridad con verificación

Antes de cada paso, el agente comprueba el espacio libre: para la copia de seguridad, para la restauración de prueba, para el archivo. Si no hay suficiente espacio para la restauración, el agente la omite con el motivo no_space, y la copia de seguridad se conserva. gbak escribe en un archivo temporal. El archivo recibe el nombre .fbk solo si el tamaño y el registro de gbak son correctos. Así, una copia de seguridad incompleta con un nombre normal nunca aparece en la carpeta.

  1. 1Verificación de espaciopara la copia de seguridad; de nuevo antes de la restauración y la compresión
  2. 2gbaka un .gbaktmp temporal; en Firebird 5 — en N núcleos
  3. 3Verificacióntamaño y registro; luego el nombre .fbk
  4. 4Restauración de pruebasi está activada; un archivo separado, no la base de datos de producción
  5. 5Compresiónarchivo descomprimido y comparado por SHA-256
  6. 6✓ Almacenamientocopia a otra carpeta; las copias antiguas se eliminan
Formulario de tarea de gbak. Horario con indicación de zona horaria, carpeta y nombre de la copia de seguridad, opciones de gbak en una línea, tiempos de espera y factores de cálculo de espacio.
  • Nombres clarosbck_sales_20261107_02-00.fbk: el inicio del nombre de la base de datos y la hora. Dos bases de datos en una carpeta no escriben los mismos nombres.
  • Aviso de solapamientoSi dos tareas escriben archivos con el mismo inicio de nombre en una carpeta, el agente y el editor muestran un aviso.
  • Resultado de la restauración de pruebaok, failed, skipped con un motivo, o not_run. Lo ves en el último resultado de la tarea y en el inventario. En el editor, cada restauración muestra ambos comandos: copia de seguridad y restauración.
  • Base de datos de prueba antiguaUna nueva tarea inicia la restauración de prueba con -rep: gbak sobrescribe la copia de la ejecución anterior. El agente primero desconecta los clientes de esta copia. Si la ruta de la base de datos de prueba es la misma que la base de datos de producción o la base de datos de otra tarea, la restauración se omite.
  • Registros y comandos de gbakLas últimas líneas de error son visibles en la consola; puedes descargar el registro. Los registros se eliminan junto con su copia de seguridad. El agente mantiene un historial de comandos ejecutados: hasta 50 por cada paso del trabajo, con las contraseñas ocultas.
  • Switches que rompen la comprobación-Y envía la salida de gbak a un archivo, pero el agente comprueba la copia de seguridad mediante esta salida. Por eso -Y no está permitido. Un trabajo de streaming tampoco acepta -SE en la línea de restauración. El editor marca estos switches.
  • Tiempos de esperaSuave: una advertencia. Duro: se detiene gbak.
  • Tiempo de gbak por pasoEl propio agente añade el switch -ST TDRW a cada copia de seguridad y restauración y toma el tiempo de gbak de la salida. No necesitas tu propio -ST en las opciones del trabajo: el editor no lo acepta.
  • El agente establece el inicio de sesiónLos switches -user, -password, -fetch_password y -trusted no están permitidos en las opciones. La restauración de prueba se ejecuta como el propietario de la base de datos, si el propietario está registrado en la configuración de acceso a la base de datos. La fila de restauración muestra con qué nombre de usuario se ejecutó.
  • Mensajes clarosEspacio y tiempo en unidades familiares: «8.1 GiB libres, 11.8 GiB necesarios», «tiempo de espera agotado tras 60 s».

nbackup · grpnbackup

nbackup: niveles y puntos de restauración

El nivel 0 copia toda la base de datos. El nivel 1 copia las páginas modificadas después del último nivel 0. El nivel 2 copia los cambios posteriores al último nivel 1. Para restaurar la base de datos al momento que necesites, bastan tres archivos.

Programación de ejemplo: nivel 0 una vez por semana, nivel 1 cada noche, nivel 2 cuatro veces al día. Esto da 36 puntos de restauración por semana: 1 + 7 + 28. Conserva 5 copias de nivel 0, 7 de nivel 1 y 24 de nivel 2.

Semana de nbackup: nivel 0 el domingo, nivel 1 cada noche, nivel 2 cuatro veces al día; una restauración toma un archivo de cada nivel
nivel 0 nivel 1 nivel 2 archivos para restaurar
  • Cadena sin huecosSin nivel 0: el agente lo crea de inmediato. Para los demás niveles, esta es la opción «Crear inmediatamente los niveles inferiores que falten». Sin ella, la ejecución se omite mientras falte el nivel inferior.
  • Comprobación por GUIDCada nivel está vinculado a su nivel inferior; un archivo ajeno no entra en la cadena.
  • Tres modos de programaciónSimple: por días y horas. Avanzado: cron para cada nivel, hasta el nivel 4. Plan: reglas con nivel, días y hora.
  • Volcado de nbackupUna copia completa del archivo de base de datos fuera de la cadena de niveles, con su propia programación.
  • Base de datos en estado deltaSi la base de datos queda bloqueada tras un nbackup interrumpido, el agente intenta fusionar el delta.

Modo plan

Un plan es un conjunto de reglas: nivel, días y hora. Los días pueden ser todos los días, días de la semana o días del mes. Si dos reglas coinciden en el mismo minuto, se ejecuta el nivel inferior. El plan puede crear un nivel 0 por sí mismo cuando el último nivel 0 es más antiguo que un número de días establecido. Ejecuta un nivel inferior antes de lo programado cuando los incrementos crecen por encima de una proporción establecida del tamaño de la base de datos. En un trabajo de grupo, cada base de datos construye su propia cadena de niveles.

El editor muestra el plan en un calendario con varias semanas de antelación: qué nivel se ejecuta y cuándo. Un botón convierte una programación simple o avanzada en un plan, y puedes deshacerlo antes de guardar.

  • Retención por ciclosUn ciclo es un nivel 0 con todos sus incrementos. El agente conserva o elimina un ciclo completo: por el número de ciclos, por días o por tamaño total. El ciclo completo más reciente nunca se elimina. El editor muestra de antemano cuánto espacio ocuparán las copias de seguridad.
  • Estado del planLa última copia de cada nivel, el espacio utilizado y lo que eliminará la próxima limpieza. El agente actualiza el estado después de cada ejecución del plan.

Compresión · S3 · almacenamiento

Dónde se almacenan las copias de seguridad

Una copia de seguridad puede ir directamente a S3: gbak o nbackup escriben en un stream, y el stream va al bucket. No hay archivo intermedio en el disco del servidor, así que no necesitas espacio para la copia de seguridad en el servidor.

La compresión zip, gz o zstd funciona tanto para copias de seguridad locales como de streaming. Para una copia de seguridad local, el agente descomprime el archivo terminado y lo compara con el origen por tamaño y SHA-256. Solo después se elimina el archivo de origen. Si la comprobación falla, no se elimina nada.

  • Retención por cantidadgbak: cuántos archivos conservar. nbackup: cuántas copias de cada nivel.
  • Copias a otros lugaresUna copia a una segunda carpeta o a una ruta de red. Subida a S3, FTP o FTPS — con un trabajo file_sync independiente.
  • Tu propio script después de la copia de seguridadPara gbak. Recibe las rutas a la copia de seguridad, a la base de datos de prueba y a los registros de gbak.
  • Cifrado del archivoUn trabajo de gbak puede cifrar el archivo zip (AES-256) con una contraseña de las claves del agente, en disco y en el stream de S3. 7-Zip abre el archivo. Una restauración encuentra la clave correcta por sí misma.
  • Restauración desde un archivoEl formato se detecta a partir del contenido del archivo, localmente y desde S3.
  • Restauración desde S3Un trabajo de restauración lee la copia de seguridad directamente del bucket.
  • AntivirusExcluye las carpetas de copia de seguridad y restauración del escaneo en tiempo real.
  • Tú eliges la compresiónUn trabajo nuevo se crea sin compresión. zstd es el primero de la lista de formatos. Puedes establecer tu propia extensión de archivo para un archivo de cualquier formato.
  • Guía de Amazon S3Configuración paso a paso del bucket, las claves y el trabajo. Disponible en inglés y portugués.

Amazon S3 · almacenamiento compatible

Copias de seguridad en S3

El agente envía las copias de seguridad a un bucket en Amazon S3 o en un almacenamiento compatible. Esto funciona para trabajos de gbak y nbackup. No necesitas otro programa para esto.

La configuración tiene tres partes: preparar un bucket y una clave de acceso, crear un destino s3 en la configuración del agente, activar la subida en el trabajo de copia de seguridad. Cada trabajo usa uno de dos modos.

Copia de archivoStream a S3
Archivo en el disco del servidorSí. La copia de seguridad se escribe en disco y luego se envía.No. La copia de seguridad va directamente al bucket.
Espacio en disco para la copia de seguridadNecesario.No necesario.
DestinoS3, FTP, FTPSSolo S3
Eliminación de copias antiguas en el bucketNo. Usa una regla de ciclo de vida del bucket.Sí, según la regla de retención del trabajo.
Fallo de subidaLa copia de seguridad local sigue siendo válida.Sin copia de seguridad: no queda ningún objeto en el bucket.
  • Cómo elegirCopia de archivo: cuando necesitas tanto una copia local como una copia en S3. Stream: cuando el disco del servidor es pequeño o S3 es el único lugar para las copias de seguridad.
  • Restauración desde S3Un trabajo de restauración lee una copia de seguridad en streaming directamente del bucket: el objeto más reciente o el que indiques. El agente comprueba el tamaño y el SHA-256 de cada objeto.
  • CifradoEl cifrado del bucket protege el objeto en el lado del almacenamiento. El cifrado del archivo en el trabajo protege el archivo con una contraseña antes de que salga del servidor.
  • BucketMantén el acceso público bloqueado. Añade una regla que elimine las subidas multipart sin terminar después de un día.
  • Una clave solo para copias de seguridadCrea un usuario separado. Dale solo los derechos que necesita: escribir, leer y eliminar objetos, abortar una subida y listar las subidas sin terminar del bucket. Si el bucket está cifrado con una clave KMS, también necesita derechos sobre esta clave. En un servidor Amazon EC2, puedes trabajar sin clave: el agente usa el rol IAM del servidor.
  • ComprobaciónInicia el trabajo con el botón Ejecutar ahora, revisa el resultado y haz una restauración de prueba antes de confiar en la copia de seguridad.

Errores comunes

ErrorCausaQué hacer
AccessDeniedFalta un derecho, o la ruta en los derechos es diferente.Comprueba los derechos del usuario.
SignatureDoesNotMatchClave incorrecta, o espacios en su valor.Copia la clave de nuevo.
PermanentRedirectLa región en la configuración no coincide con la región del bucket.Corrige la región.
NoSuchBucketNombre de bucket incorrecto.Corrige el nombre.
RequestTimeTooSkewedEl reloj del servidor es incorrecto.Sincroniza el reloj con NTP.

restore.replace_cycle

Backup-Restore-Replace

El ciclo reconstruye la base de datos de producción. El agente hace una copia de seguridad con gbak, la restaura en un archivo nuevo y coloca el archivo nuevo en lugar del antiguo. La nueva base de datos no tiene basura, sus índices están frescos y normalmente es mucho más pequeña. La base de datos de producción se desconecta y se renombra de forma segura: el agente primero la pone en shutdown full, todas las conexiones se cierran, y solo entonces el archivo recibe un nuevo nombre.

De forma predeterminada, el ciclo se ejecuta el sábado a las 02:00; puede cambiar la programación. Ejecutar ahora inicia el ciclo de inmediato, pero primero le pide que escriba el nombre del archivo de base de datos. La base de datos se puede establecer mediante una ruta o mediante un alias de databases.conf.

    Clientes

    conectar sales.fdb

    Archivos en disco

    Desde el apagado hasta el reemplazo, los clientes reciben «base de datos no encontrada» o «base de datos apagada». Programe el ciclo para un momento en que la base de datos pueda estar no disponible durante un backup más una restauración. En modo pipe, el backup y la restauración se ejecutan al mismo tiempo y no se escribe ningún archivo de backup.

    El ciclo no se inicia si

    • «Permitir reemplazo» (allow_replace) no está activado en el trabajo;
    • la base de datos está en apagado, cifrada o es una réplica;
    • la base de datos es una base de seguridad, propia o para otras bases de datos;
    • hay archivos de un ciclo sin terminar junto a ella;
    • no hay suficiente espacio en disco.

    El espacio se calcula de antemano: el archivo de backup y la copia restaurada están en disco al mismo tiempo, cada uno aproximadamente del tamaño de la base de datos. El original se renombra, no se copia, por lo que no ocupa espacio. Si el espacio es escaso, el ciclo se detiene antes del apagado: la base de datos no se toca y los clientes siguen trabajando.

    Qué permanece en disco

    Originales. Los últimos originales en apagado completo se conservan junto a la base de datos, de 1 a 10, 1 de forma predeterminada. Los adicionales se eliminan al inicio del siguiente ciclo, por lo que la base de datos en su estado anterior al último ciclo siempre está ahí.

    El archivo de backup se elimina después del reemplazo. Si la restauración falló, el archivo se conserva como .restore-failed.fbk para su análisis.

    Para volver al original: detenga la base de datos de producción, renombre los archivos y ejecute gfix -online para el original.

    Cuando se interrumpe el ciclo

    Alguien puede detener el agente, el servidor puede reiniciarse, la energía puede fallar. En una parada normal del servicio antes del reemplazo, el agente deja que gbak termine y revierte el ciclo. Para el caso de un fallo, antes de cada paso el agente escribe lo que hace en un archivo de intención. Al inicio y luego cada minuto, el agente lee estos archivos y lleva el ciclo a un estado conocido.

    Antes del renombrado

    La base de datos vuelve a estar en línea

    El agente pone la base de datos en línea y restaura el retraso de apagado.

    Antes del reemplazo

    Reversión

    La copia intermedia y el backup incompleto se eliminan, el original recupera su nombre anterior y vuelve a estar en línea.

    Después del reemplazo

    Finalización

    La nueva base de datos permanece en producción, el original se conserva en apagado. El script «posterior» no se ejecutó: ejecútelo usted mismo si es importante.

    Si los archivos en disco no coinciden con ningún estado conocido, el agente no cambia nada y el resultado del trabajo comienza con «se necesita operador». El archivo de intención enumera los nombres de todos los archivos del ciclo. Coloque la base de datos correcta en su ruta y el agente finalizará la recuperación por sí solo.

    Sus propios scripts antes y después

    El script «antes del backup» se ejecuta antes del apagado. Si termina con un error, el ciclo se detiene y la base de datos no se toca. El script «después de la restauración» se ejecuta después del reemplazo. Ejemplo: copie el archivo de backup a un archivo antes de que el agente lo elimine.

    VariableAntes del backupDespués de la restauración
    FBAGENT_HOOK_PHASEprepost
    FBAGENT_JOB_IDid del trabajo
    FBAGENT_DB_NAMEnombre en el trabajo: alias o ruta
    FBAGENT_DB_PATHarchivo de base de datos: original, en líneamisma ruta: nueva base de datos, en línea
    FBAGENT_ORIG_PATHvacíoruta al original
    FBAGENT_FBK_PATHfuturo archivo de backup; vacío en modo pipearchivo de backup, eliminado después del script; vacío en modo pipe

    Inventario · informe de estado

    Control: qué base de datos no tiene backup

    El inventario muestra todos los archivos de backup en el servidor, también los realizados por otros programas. El agente lo actualiza después de cada backup y por completo cada 2 horas. Junto a él hay una tabla de restauraciones: de prueba y de producción, durante 14 días.

    Cada backup tiene una columna Verificado: la restauración de prueba pasó, falló o no se ejecutó. Junto a ella están el tamaño de la base de datos restaurada y el tiempo de gbak. La tabla de restauraciones muestra el tamaño de la base de datos y la duración.

    El informe de estado del servidor marca una base de datos sin backups registrados e indica por qué: el trabajo falló, aún se ejecuta, está pospuesto o no hay archivo en las carpetas. Un botón junto al hallazgo abre el formulario para un nuevo trabajo de inmediato.

    Inventario. La restauración de prueba de cada copia falla y lo ve de inmediato. Los archivos sin su propio trabajo se marcan como ORPHANED.
    Hallazgos en el informe. «Sin backups para la base de datos»: agregue un trabajo de nbackup o gbak con un solo botón.

    ← Volver a la descripción general de HQbird 2027