Mantenimiento del servidor HQbird
Mantenimiento sin turnos nocturnos
El sweep, la validación de la base de datos, el recálculo de estadísticas de índices, tus scripts SQL y las actualizaciones de Firebird se ejecutan por la noche según una programación. El sweep de grupo, los scripts SQL y las actualizaciones de Firebird solo se inician en su propia ventana. El agente no interfiere con las copias de seguridad ni con los usuarios. Si algo sale mal, el agente restaura por sí mismo el estado anterior.
- 4 tareas de mantenimiento
- 1 operación pesada por base de datos
- 2 tareas pesadas por servidor
- 03:30–04:00 ventana de actualización de Firebird
- reversión automática si la comprobación falla
Programación predeterminada
Noche del servidor
El mantenimiento se ejecuta por la noche, cada tarea a su hora. A continuación se muestran las horas y ventanas predeterminadas. Las cambias en el editor de configuración del agente.
El sweep, la validación con gfix, el recálculo de índices y los scripts SQL están desactivados de forma predeterminada: los activas para tus bases de datos. Las horas usan la zona horaria del agente.
La noche del domingo se ejecuta en este orden: validación con gfix a las 02:30, sweep a las 03:00, recálculo de índices a las 04:00. Primero la comprobación, luego la recolección de basura y después las estadísticas sobre datos en vivo.
sweep · gfix · índices · SQL
Cuatro tareas de mantenimiento
Cada tarea es un comando normal de Firebird. El agente añade lo que un DBA suele hacer a mano: una programación, una ventana, un bloqueo de la base de datos, un registro y un motivo de error claro.
| Tarea | Qué hace | Qué bases de datos | Predeterminado |
|---|---|---|---|
| Sweep | gfix -sweep: elimina versiones antiguas de registros. | Lista explícita de bases de datos | Dom 03:00 |
| Sweep de grupo | El mismo sweep para todas las bases de datos de las carpetas. Máscaras, exclusiones, profundidad de escaneo. | Carpetas, máscara *.fdb | 00:15–01:15 |
| Validación con gfix | gfix -v -full: comprueba cada página de la base de datos. | Solo lista explícita | Dom 02:30 |
| Recálculo de índices | SET STATISTICS para los índices de usuario. También encuentra índices inactivos. | Lista de bases de datos | Dom 04:00 |
| Scripts SQL | Tu DDL y DML desde la carpeta de scripts entrantes o desde la cola. | Una base de datos por script | 03:00–04:00 |
- Transacciones largas antes del sweepComo opción, el agente desconecta las conexiones con transacciones de más de 5 horas (el umbral es configurable). No toca gbak, gfix, gstat ni fbsvcmgr.
- El grupo no se detieneUn error en una base de datos no detiene el escaneo de las demás bases de datos.
- Un motivo claroFirebird 3 y posteriores no permiten validar una base de datos con usuarios conectados. El agente lo dice exactamente así en lugar de mostrar solo un código de error.
- SQL: el agente añade COMMITDDL: COMMIT después de cada sentencia, DML: cada 100 sentencias.
SET BAIL ON: el primer error detiene el script. - El SQL peligroso no se ejecuta
DROP DATABASE, usuarios y roles,GRANTyREVOKE,ALTER DATABASE: dicho script pasa a cuarentena en su totalidad. - Registro de ejecucionesQué comando, cuándo y con qué resultado. Para el sweep y la validación con gfix el agente guarda un historial de comandos: hasta 50 por tarea, los dos últimos son visibles en el editor. La contraseña nunca va al registro.
Ventanas · bloqueos · ranuras
Si el servidor está ocupado, la tarea espera o se salta la base de datos
Antes de un inicio, el agente comprueba varias condiciones. Si una condición no se cumple, la tarea espera o se salta la base de datos. No interrumpe otro trabajo.
Activa las condiciones a la izquierda y observa qué hace el agente con la base de datos sales.fdb durante un sweep de grupo de su carpeta.
| Regla | Qué cuenta | Qué hace el agente |
|---|---|---|
| Ventana de mantenimiento | Sweep de grupo 00:15–01:15, scripts SQL 03:00–04:00, prueba de rendimiento Sáb 22:00 — Dom 06:00. | Fuera de la ventana la tarea no se inicia. Si queda menos de un minuto de ventana, tampoco se inicia. |
| Una operación pesada por base de datos | La copia de seguridad, el sweep, la validación, el recálculo de índices, la restauración y el script SQL toman un bloqueo de la base de datos. | Una copia de seguridad espera hasta 60 minutos a que la base de datos quede libre. El sweep, la validación y el recálculo de índices se saltan una base de datos ocupada hasta la siguiente ejecución programada. Ejecutar ahora espera y vuelve a intentarlo. |
| No más de 2 tareas pesadas por servidor | Copias de seguridad, restauraciones, sweep, validaciones, recálculo de índices, scripts SQL, gstat completo, la prueba. El trabajo pesado del propio agente también ocupa una ranura: el procesamiento de trazas y registros. | Una tercera tarea espera una ranura libre. Cambias el número en la configuración; el nuevo valor surte efecto tras reiniciar el agente. |
Archivo .delta | Hay un archivo .delta junto a la base de datos: nbackup retiene la base de datos. | El sweep se salta dicha base de datos. |
| Un error en una base de datos de un grupo | El sweep de una base de datos del grupo terminó con un error. | El sweep de grupo continúa con la siguiente base de datos. Si la continuación está desactivada, solo se detiene esta tarea. Las bases de datos con error se nombran en el resultado de la tarea. |
Si una copia de seguridad con gbak y un nbackup de la misma base de datos coinciden en el mismo minuto, la copia de seguridad con gbak se desplaza 15 minutos más tarde. Un inicio manual con Ejecutar ahora no se desplaza.
Un botón
Ejecutar ahora: inícialo en este momento
¿Necesitas una copia de seguridad antes de una actualización de software, o un sweep ahora mismo? El botón «Ejecutar ahora» en la fila de la tarea inicia la tarea una vez. La programación no cambia.
Ejecutar ahora está disponible para copias de seguridad, restauraciones, sweep, recálculo de índices y validación con gfix. También puedes ejecutar una tarea desactivada una vez: después permanece desactivada. El agente comprueba las mismas condiciones que para una ejecución programada y muestra qué está esperando.
- Ves qué está esperandoLa base de datos está ocupada con otra operación, la tarea espera su ventana, el espacio en disco es bajo.
- CancelarMientras una ejecución está en cola o esperando, puedes cancelarla. Una tarea que ya ha comenzado no se cancela.
- Una solicitud vive 60 minutosSi el agente no la toma en este tiempo, la ejecución cuenta como expirada, no como perdida.
- Ves qué base de datos se ejecutaráLa ventana de ejecución comienza con el campo de base de datos. Para una tarea de grupo, son casillas de verificación para las bases de datos y la línea «N de M seleccionadas».
- Informe de rendimiento bajo demandaEjecutar ahora genera un informe para cualquier rango de hasta 24 horas, con filtros por base de datos, duración y programa. Es la misma ejecución que el botón «Generar informe…» en la página de informes.
- Localmente y desde el centroLa consola local va directamente al agente. Desde el centro, la solicitud pasa por goafts. El agente la toma en la siguiente sincronización, en aproximadamente un minuto.
- El reemplazo de base de datos es aparteRestaurar con reemplazo y el ciclo copia de seguridad-restauración-reemplazo: debes escribir el nombre del archivo de la base de datos y tener un permiso aparte. El inicio remoto de tales tareas está desactivado en el servidor de forma predeterminada.
- Justo después de GuardarEjecutar ahora espera hasta que el agente acepte la nueva configuración, y solo entonces inicia la tarea.
Actualización del motor
Una nueva compilación de Firebird es una operación nocturna habitual
El agente descarga por sí mismo una nueva compilación de Firebird, espera a la ventana de mantenimiento, la instala y la comprueba. Si la comprobación falla, el agente vuelve a la versión anterior y no vuelve a instalar esta compilación.
- Ventana03:30–04:00 por defecto. Fuera de la ventana, la compilación descargada espera a que se abra la ventana. Si la actualización se pospone dentro de la ventana, el agente lo intenta de nuevo en 10 minutos. El agente encuentra una nueva compilación en el centro en aproximadamente una hora.
- Trabajos que no deben interrumpirseSi se está ejecutando gbak, nbackup, una restauración o un script SQL, la actualización espera hasta la siguiente comprobación. Sweep, la validación con gfix y gstat no la bloquean: se pueden repetir.
- Un motor a la vezEn un servidor con varias instancias de Firebird, solo se actualiza una a la vez.
- Espacio y archivos bloqueadosEl espacio libre y los archivos retenidos por otro programa se comprueban antes de que Firebird se detenga. Si un archivo no se puede reemplazar, Firebird no se detiene.
- Tus archivos se quedanEl agente reemplaza solo los archivos de la distribución. firebird.conf, databases.conf, replication.conf, la base de datos de seguridad, las UDF y los plugins de terceros se mantienen. Solo se añaden a firebird.conf los parámetros obligatorios que falten.
- ReversiónLos archivos reemplazados se guardan en la copia de seguridad de la actualización. Una reversión los restaura. Se conservan las 2 últimas copias de seguridad.
- Bloqueo de versiónUna compilación que se revirtió, de forma automática o manual, queda bloqueada. Un solo comando elimina el bloqueo.
- Actualización sin terminarSi el proceso se detuvo a medias, no se inicia una nueva actualización hasta que el administrador revierta o complete la anterior.
El agente no actualiza Firebird instalado desde paquetes del sistema operativo (apt, dnf): el gestor de paquetes es el propietario de los archivos. Cómo migrar un servidor así a HQbird se describe más abajo.
Prueba · databases.conf · migración
Herramientas del administrador
Prueba de rendimiento del servidor
Una vez a la semana el agente ejecuta la prueba de IBSurgeon: INSERT, UPDATE y DELETE sobre un millón de filas en una base de datos temporal. El historial de la prueba muestra cómo funcionaba el servidor antes y después de un cambio de hardware, disco o configuración.
La prueba carga el disco, por lo que se ejecuta solo en su propia ventana. Firebird elimina por sí mismo la base de datos temporal. Si el agente se bloqueó durante la prueba, el archivo se elimina en el siguiente inicio.
| Ventana | Sáb 22:00 — Dom 06:00 |
|---|---|
| Inicio | Dom 01:00 |
| Filas | 1 000 000 |
| Espacio libre en disco | unos 7,2 GiB, o la prueba no se inicia |
| Historial | últimas 30 ejecuciones |
| Al mismo tiempo | una prueba; una segunda ejecución se omite |
Usuarios de Firebird: Security.fdb/Users
Una página de configuración aparte muestra las bases de datos de seguridad del servidor: la compartida, las privadas y las integradas en una base de datos. Las etiquetas muestran un problema: no hay inicio de sesión para leer, la lista no se actualizó, la entrada está desactualizada.
El botón Crear usuario crea un usuario de Firebird a través del agente. En la ventana: nombre, contraseña dos veces, plugin del ajuste UserManager, las marcas «activo» y «administrador». Los derechos de administrador se confirman en un segundo paso. Antes de ejecutarse, ves el texto del comando, con la contraseña oculta.
La creación funciona con el agente local y no funciona para Firebird 2.5.
Editor de databases.conf
El archivo se muestra como una lista de rutas de bases de datos. Cada ruta tiene sus alias y un bloque de parámetros. La lista de parámetros contiene solo aquellos que esta versión de Firebird acepta para una sola base de datos. El valor de firebird.conf se muestra al lado.
Un alias repetido y un segundo bloque para la misma ruta son errores: no se puede guardar un archivo así. Una errata en el nombre de un parámetro recibe una sugerencia. Al guardar, el agente comprueba el archivo de nuevo y conserva una copia del archivo anterior junto a él. Si el archivo cambió mientras lo editabas, el agente lo rechaza y tu texto permanece en el editor. Las ediciones en el formulario no tocan los comentarios del archivo. Cada guardado se registra en el registro de auditoría.
Desde el centro, el archivo se entrega a través de goafts. El agente lo aplica en aproximadamente un minuto e informa el resultado: aceptado o rechazado.
Migración a HQbird y cambios de configuración
FBDataGuard
Los ajustes antiguos de HQbird se trasladan solos
En el primer inicio, el agente encuentra la configuración de FBDataGuard y traslada los trabajos de copia de seguridad, sweep y estadísticas de índices. La importación se ejecuta una vez. Por defecto los trabajos llegan deshabilitados. Si el instalador deshabilita FBDataGuard, habilita los trabajos que ejecutaba FBDataGuard y que se importaron sin advertencias. Así el servidor no se queda sin copias de seguridad. Los demás trabajos permanecen deshabilitados: revísalos y habilítalos tú mismo. El agente toma las copias de seguridad antiguas de los diarios de FBDataGuard en sus propios registros: la retención y la restauración las ven.
apt · dnf
Firebird desde paquetes del sistema operativo
El instalador encuentra Firebird de los paquetes y se detiene sin cambiar nada. Muestra los comandos que eliminan el paquete y conservan la base de datos de seguridad, databases.conf y las bases de datos. Después, el instalador instala HQbird y toma los usuarios y alias del servidor antiguo. Probado para Firebird 2.5, 3.0, 4.0 y 5.0.
sin reinicio
Nuevos ajustes, con comprobación
El agente comprueba la nueva configuración, hace una copia de la anterior y aplica la nueva sin reiniciar. Si la nueva no se carga, el agente restaura la anterior. La mayoría de los ajustes se aplican sin reinicio. Se necesita un reinicio para la carpeta de datos, el registro del agente, la API local, la conexión con el centro, Prometheus, el clúster, los límites de carga y la zona horaria del agente. El agente informa qué cambios esperan un reinicio.
← Volver a la descripción general de HQbird 2027 · Copias de seguridad en detalle → · Estado del servidor →