Copias de seguridad de HQbird
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é copia | Datos 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ño | Normalmente 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ón | Crea 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ón | Restauració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 para | Una 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 datos | Todas las bases de datos en carpetas | |
|---|---|---|
| gbak con verificación | vbackup | grpvbackup |
| nbackup con niveles | nbackup | grpnbackup |
| volcado de nbackup | nbackup_dump | grpnbackup_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
- sales.fdben el grupo
- stock.fdben el grupo
- branch_new.fdb
nueva base de datos: comienza con el nivel 0en el grupo - erp.fdb
tiene su propia tarea individualomitir - security5.fdb
base de datos del sistemaomitir - bck_sales_20261107.fbk
archivo de copia de seguridadomitir - orders.fdb.delta
archivo delta de nbackupomitir
- 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
_orphanedde 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.FDBva a<backup folder>/x/y/EMPLOYEE.FDB/. Las bases de datos con el mismo nombre de carpetas diferentes no se estorban entre sí.
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.
- 1Verificación de espaciopara la copia de seguridad; de nuevo antes de la restauración y la compresión
- 2gbaka un
.gbaktmptemporal; en Firebird 5 — en N núcleos - 3Verificacióntamaño y registro; luego el nombre
.fbk - 4Restauración de pruebasi está activada; un archivo separado, no la base de datos de producción
- 5Compresiónarchivo descomprimido y comparado por SHA-256
- 6✓ Almacenamientocopia a otra carpeta; las copias antiguas se eliminan
- Nombres claros
bck_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
-Yenvía la salida de gbak a un archivo, pero el agente comprueba la copia de seguridad mediante esta salida. Por eso-Yno está permitido. Un trabajo de streaming tampoco acepta-SEen 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 TDRWa cada copia de seguridad y restauración y toma el tiempo de gbak de la salida. No necesitas tu propio-STen las opciones del trabajo: el editor no lo acepta. - El agente establece el inicio de sesiónLos switches
-user,-password,-fetch_passwordy-trustedno 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.
- 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 archivo | Stream a S3 | |
|---|---|---|
| Archivo en el disco del servidor | Sí. 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 seguridad | Necesario. | No necesario. |
| Destino | S3, FTP, FTPS | Solo S3 |
| Eliminación de copias antiguas en el bucket | No. Usa una regla de ciclo de vida del bucket. | Sí, según la regla de retención del trabajo. |
| Fallo de subida | La 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
| Error | Causa | Qué hacer |
|---|---|---|
AccessDenied | Falta un derecho, o la ruta en los derechos es diferente. | Comprueba los derechos del usuario. |
SignatureDoesNotMatch | Clave incorrecta, o espacios en su valor. | Copia la clave de nuevo. |
PermanentRedirect | La región en la configuración no coincide con la región del bucket. | Corrige la región. |
NoSuchBucket | Nombre de bucket incorrecto. | Corrige el nombre. |
RequestTimeTooSkewed | El 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
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.
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.
Reversión
La copia intermedia y el backup incompleto se eliminan, el original recupera su nombre anterior y vuelve a estar en línea.
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.
| Variable | Antes del backup | Después de la restauración |
|---|---|---|
FBAGENT_HOOK_PHASE | pre | post |
FBAGENT_JOB_ID | id del trabajo | |
FBAGENT_DB_NAME | nombre en el trabajo: alias o ruta | |
FBAGENT_DB_PATH | archivo de base de datos: original, en línea | misma ruta: nueva base de datos, en línea |
FBAGENT_ORIG_PATH | vacío | ruta al original |
FBAGENT_FBK_PATH | futuro archivo de backup; vacío en modo pipe | archivo 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.