HQCenter: flota de servidores
Muchos servidores en una sola consola
HQCenter es un único servidor Linux en las instalaciones del cliente. Todos los agentes del cliente se conectan a él. Los agentes envían allí sus datos y obtienen de él la configuración, los comandos, las licencias y las nuevas versiones. El administrador ve toda la flota en HQ Monitor y la gestiona desde un navegador.
- 0 puertos de entrada para comunicarse con el centro
- mTLS certificado para cada agente
- 3 min hasta que los datos llegan al centro
- ~1 min hasta que la configuración llega al agente
- con rollback actualizaciones del agente y del centro
Agente · nginx · goafts · fblogspacker · HQ Monitor
Conexión sin puertos de entrada
El agente abre todas las conexiones. HQCenter nunca se conecta a un servidor de base de datos. Así no abres puertos en los servidores Firebird para comunicarse con el centro, y un servidor en una sucursal detrás de NAT funciona igual que un servidor en el rack de al lado.
Tres programas se ejecutan detrás de nginx en HQCenter. goafts recibe archivos, emite certificados y almacena la configuración, los comandos, las licencias y las nuevas versiones. fblogspacker clasifica los archivos en carpetas de agentes. HQ Monitor muestra estas carpetas en un navegador.
| Puerto de HQCenter | Quién se conecta | Comprobación |
|---|---|---|
:443 | Agentes: archivos, configuración, comandos, licencia, nuevas versiones | TLS 1.3 y el certificado del agente; un certificado revocado es rechazado |
:9443 | Agente nuevo en la primera conexión, e instaladores | Sin certificado de agente: solicitud de certificado con la clave de attach.json, huella de la clave del centro, descargas de instaladores |
:8443 | Administrador y consola: gestión | Certificado de administrador y lista de direcciones permitidas |
:8085 | Navegador: consola de HQ Monitor | Lista de direcciones permitidas |
- Conectar con un solo comandoEl centro entrega un archivo
attach.json: dirección, huella de la clave y fecha de caducidad. En el servidor:fbagent --attach --file attach.json. Los instaladores de HQbird 2027 lo hacen por ti. Una solicitud con una clave normal es aprobada por el administrador en el panel del centro. Una clave de licencia aprueba la solicitud por sí misma mientras la licencia tenga puestos libres. - El nombre del agente es el nombre del certificadoLa carpeta de datos del agente, la configuración y la fila de la consola usan este nombre. El instalador de Windows pide el nombre del servidor; el valor predeterminado es el nombre del equipo. Un certificado es válido durante un año; uno revocado deja de funcionar de inmediato.
- Nada se pierdeUn archivo es de hasta 120 MiB. Ante un error de red, 3 reintentos. Un archivo enviado se elimina; uno no enviado nunca se elimina. Cada agente envía con su propio desfase de hasta 150 s, para que los agentes de un mismo centro no lleguen en el mismo segundo.
- Licencias desde el centroEl agente obtiene una nueva licencia en aproximadamente un minuto: la respuesta a la consulta de configuración le informa sobre la licencia. El agente también solicita la licencia al iniciar y cada 6 horas. Comprueba la licencia por sí mismo, sin la red. La página Licencias muestra el estado de cada servidor.
- La consola no toca las bases de datosHQ Monitor construye sus páginas a partir de los archivos de los agentes. No se conecta a Firebird y no genera carga en las bases de datos.
- Un servidor LinuxUbuntu o AlmaLinux. Un script instala el centro; una segunda ejecución actualiza lo que ya existe y conserva las contraseñas y las claves.
IBSurgeon recibe resúmenes: estado del servidor, lista de servidores, lista de copias de seguridad y restauraciones (sin los archivos), eventos e informes semanales, descripciones de clústeres, licencias. Los registros, las trazas, los archivos de copia de seguridad, las contraseñas y el registro de auditoría permanecen con el cliente.
Editor de configuración · Ejecutar ahora · estado de entrega
Configuración desde el centro
El centro guarda una copia de la configuración de cada agente. El administrador cambia tareas y ajustes en el mismo editor que junto al agente, y hace clic en Guardar y enviar al agente. El agente obtiene el cambio en aproximadamente un minuto.
El agente no escribe la nueva configuración sobre la que está en uso. Primero comprueba la candidata. Una candidata defectuosa se aparta, la configuración en uso se mantiene y la consola muestra el motivo del rechazo.
Estado en la página de servidores
Para cada servidor ves hasta dónde llegó el último cambio: un icono de estado, la hora de envío (push) y la hora de respuesta del agente (ack). La sugerencia del icono muestra por qué el agente rechazó y la hora exacta.
En un minuto ves qué servidores tomaron la nueva tarea de copia de seguridad, cuáles no y por qué.
El nivel del servidor en la lista es el veredicto del agente sobre el servidor en su conjunto. Bajo los iconos hay una línea con el hallazgo principal. Un icono «Agente» aparte aparece solo cuando el estado del propio agente es peor que el estado del servidor.
Un servidor que está en silencio durante más de 30 minutos recibe un icono gris «sin datos desde …» y pasa al final de la lista. La línea de resumen sobre la lista cuenta los servidores por nivel.
El agente protege el servidor
El agente vigila su propia memoria y CPU. Si una tarea del agente usa demasiado, el agente la pausa y detiene la ejecución que retiene la memoria. No toca las copias de seguridad ni la carga de datos. Si la memoria del agente sigue creciendo, el agente se reinicia a sí mismo. Una tarea que el agente desactivó se muestra en el informe de estado y en el editor; un botón la vuelve a activar.
Ejecutar ahora desde el centro
Puedes iniciar una copia de seguridad, una restauración, un sweep, una comprobación con gfix o un recálculo de índices ahora, sin esperar a la programación. La solicitud sigue el mismo camino: hacia goafts, luego el agente la obtiene cuando consulta y la pone en su cola, con las comprobaciones habituales.
- BorradoresGuarda un cambio en la consola y envíalo más tarde. Ves el estado: no enviado, enviado, aplicado, reemplazado.
- Las contraseñas se ocultan al centroLa consola cifra una nueva contraseña con la clave pública del agente. Solo el agente en su propio servidor puede descifrarla.
- Copias de la configuraciónAntes de cada reemplazo, el agente guarda una copia: las últimas 10, durante al menos 14 días. Las candidatas rechazadas se conservan durante 90 días.
- Solo en el servidorLa comprobación de la firma de la versión, la licencia, los comandos remotos, las rutas de los programas y el inicio de sesión en la consola no se pueden cambiar desde el centro.
- El reemplazo de la base de datos requiere dos partesUna restauración remota que reemplaza la base de datos en uso se ejecuta solo si el propio servidor lo permite y el usuario tiene un derecho separado. Antes del inicio, debes escribir el nombre del archivo de la base de datos.
- databases.conf desde el centroPuede enviar el archivo a un agente. goafts solo lo reenvía; el agente lo comprueba, escribe el archivo y conserva el antiguo junto a él.
Firma · punto de rollback · comprobación
Actualizaciones con rollback
Los agentes obtienen las nuevas versiones de HQCenter, no de internet. El agente se actualiza a sí mismo, a HQ Monitor, a los programas del clúster y a Firebird. Cada actualización sigue un mismo esquema: comprobar la firma, guardar un punto de rollback, instalar, comprobar que funciona. Si no funciona, se vuelve a la versión anterior.
- 1Firmaversión firmada por IBSurgeon
- 2Punto de rollbackcopia de la versión actual
- 3Instalarreemplazar los archivos
- 4Comprobarla nueva versión informa "estoy funcionando" y se ejecuta durante 45 s
- 5Hechola nueva versión funciona
- ↺Rollbackrestaurar la copia desde el punto de rollback
- ✓La versión anterior funcionatras 2 rollbacks la versión queda bloqueada
| Qué se actualiza | Cuándo | Protección |
|---|---|---|
| Agente | de inmediato cuando la respuesta a la consulta de configuración informa de una nueva versión, y una vez por hora; sin dicha respuesta, cada 180 s | Firma, 2 puntos de rollback. La nueva versión debe informar "estoy funcionando" y ejecutarse durante 45 s. Tras 2 rollbacks la versión queda bloqueada. |
| HQ Monitor | una vez por hora mientras funcione la consulta de configuración; de lo contrario, cada 180 s | Comprobación de estado de la consola durante 30 s, copia de la versión anterior. |
| Programas del clúster | comprobación cada 180 s | Primero la réplica, luego el maestro. |
| Firebird | solo en la ventana, por defecto 03:30–04:00 | Espera a que terminen las copias de seguridad. Comprobación tras la instalación, rollback en caso de fallo. Una compilación revertida no se vuelve a instalar. |
| HQCenter | cada 15 min, si IBSurgeon activó las actualizaciones para este centro; en una ventana que IBSurgeon establece, por ejemplo 02:00–05:00 | Desactivado por defecto. El propietario del centro puede prohibir la actualización: STACK_UPDATE=off. Se comprueba la firma del stack y luego los servicios durante hasta 5 minutos. Si fallan, se instala el stack anterior desde la caché. |
- Primero la prueba, luego todosIBSurgeon publica una versión primero en la zona de pruebas y, tras las comprobaciones, en las zonas de producción. HQCenter copia las versiones de su zona una vez por hora.
- Firma comprobada dos vecesEl centro comprueba la firma antes de la descarga y de nuevo sobre los bytes escritos. El agente la comprueba otra vez antes de instalar.
- Sin downgradeNo se puede instalar una versión inferior a la actual, salvo que el propio servidor lo permita.
- En Linux, root cambia los archivosEl servicio del agente no se ejecuta como root y no puede reemplazar los archivos de instalación de confianza.
Vigilancia de estado · correo electrónico · webhook
Correos de problemas e informe semanal
HQCenter lee la instantánea de estado de cada agente. Un problema nuevo, o un problema que empeoró, es un evento. El propio centro envía el correo electrónico o el webhook. Una vez a la semana el centro genera un informe para toda la flota.
El centro no cambia nada por sí mismo. Si un problema persiste durante semanas y eso es normal para el servidor, el centro sugiere un nuevo umbral. Solo una persona lo aplica.
- 1Leer estadocada 2 minutos, si cambió el archivo del agente
- 2Eventonuevo, empeoró, desapareció, volvió
- 3Correo electrónicoo webhook; sin repetición en 24 h
- 4Informe semanallunes a las 07:00 por defecto
- 5✓ Sugerencianuevo umbral; el administrador lo aplica
Toda la flota durante 14 días
Para cada servidor: porcentaje de tiempo sin problemas, episodios por semana y qué hallazgos están "atascados".
No es ruido sino normal
Activo al menos la mitad del tiempo, y durante al menos una semana seguida. Por ejemplo, la CPU del servidor siempre está cerca del umbral.
Umbral a partir de datos reales
Un poco más allá de lo que mostró el servidor: un cuarto por encima del máximo. Para un umbral inferior, como el espacio libre, un quinto por debajo del mínimo. Puede cambiarlo antes de la aprobación; es válido durante 30 días.
- Un host, un correo electrónicoSi un host ejecuta varios agentes, un problema de CPU, memoria o disco del host cuenta una sola vez.
- Desaparecido u ocultoEl evento indica por qué desapareció el problema: corregido, reconocido por el administrador o convertido en información.
- La aprobación es una nueva versión de la configuraciónEl umbral llega al agente mediante la entrega normal, en nombre del administrador. Cada aprobación y rechazo queda en el registro de auditoría.
- Enlace en el correo electrónicoEl correo electrónico indica el host, da una pista y un enlace al servidor en HQ Monitor.
El administrador del centro activa el correo electrónico y el webhook. Hasta que estén configurados, no se envían correos electrónicos. Los eventos e informes son visibles en el panel del centro y en su API.
Usuarios · derechos · auditoría · idiomas
Usuarios y derechos
Cada usuario ve solo sus propios servidores. Los derechos para hacer cambios se conceden por separado, uno a uno.
El administrador ve todos los servidores y gestiona a los usuarios. Un usuario normal ve los servidores de su lista. Un nuevo derecho o una nueva lista surte efecto en la siguiente carga de página; una nueva contraseña cierra la sesión del usuario en todos los navegadores.
| Derecho | Qué permite |
|---|---|
| Enviar configuración | Enviar la configuración modificada al agente a través del centro. |
| Ejecutar tareas | Iniciar y cancelar una copia de seguridad, restauración, sweep o recálculo de índices (Ejecutar ahora). |
| Tareas que reemplazan una base de datos | Iniciar una restauración que reemplaza la base de datos en funcionamiento. Solo junto con el derecho de ejecución, y solo si el agente también lo permite. |
- Registro de auditoríaCada guardado, envío, cambio de contraseña e inicio de tarea se registra con el inicio de sesión del usuario. En goafts, una cadena de hashes protege el registro.
- Registro de solicitudes del agenteEl propio agente escribe una línea por cada solicitud que cambia el servidor y por cada denegación de acceso: Local API, comandos del centro, Ejecutar ahora, cambios de configuración, actualizaciones. Las contraseñas y los cuerpos de las solicitudes no van al registro. El archivo va al centro junto con los registros.
- Inicio de sesión en HQ MonitorLa sesión dura 7 días. No más de 8 intentos de inicio de sesión desde una dirección en 15 minutos.
- Panel de administración del centroUn inicio de sesión separado, solo con un certificado de administrador. La sesión dura 8 horas. Tras 5 intentos fallidos en 15 minutos, el inicio de sesión se cierra durante 15 minutos.
- Hasta 2000 usuariosCada uno tiene su propia contraseña y lista de servidores; búsqueda por servidor al asignar servidores.
- 5 idiomas de interfazInglés, ruso, alemán, portugués (Brasil), español. Los informes de estadísticas también usan el idioma elegido.
← Volver a la descripción general de HQbird 2027 · El estado del servidor en un minuto →