HQCenter: parque de servidores
Muitos servidores em um só console
O HQCenter é um servidor Linux no cliente, ao qual todos os agentes do cliente se conectam. Os agentes enviam seus dados para lá e buscam lá configurações, comandos, licenças e novas versões. O administrador vê todo o parque no HQ Monitor e o gerencia pelo navegador.
- 0 portas de entrada para falar com a central
- mTLS certificado para cada agente
- 3 min até os dados chegarem à central
- ~1 min até as configurações chegarem ao agente
- com rollback atualizações de agentes e da central
Agente · nginx · goafts · fblogspacker · HQ Monitor
Conexão sem portas de entrada
O agente abre todas as conexões. O HQCenter nunca se conecta ao servidor de banco de dados. Por isso não é preciso abrir portas nos servidores Firebird para falar com a central, e um servidor numa filial atrás de NAT funciona igual a um servidor no rack ao lado.
No HQCenter rodam três programas atrás do nginx. O goafts recebe arquivos, emite certificados e guarda configurações, comandos, licenças e novas versões. O fblogspacker distribui os arquivos nas pastas dos agentes. O HQ Monitor mostra essas pastas no navegador.
| Porta do HQCenter | Quem se conecta | Verificação |
|---|---|---|
:443 | Agentes: arquivos, configurações, comandos, licença, novas versões | TLS 1.3 e certificado do agente; certificado revogado não passa |
:9443 | Agente novo na conexão e instaladores | Sem certificado do agente: pedido de certificado com a chave do attach.json, impressão digital da chave da central, download dos instaladores |
:8443 | Administrador e console: gerenciamento | Certificado de administrador e lista de endereços permitidos |
:8085 | Navegador: console HQ Monitor | Lista de endereços permitidos |
- Conexão com um comandoA central gera o arquivo
attach.json: endereço, impressão digital da chave e validade. No servidor:fbagent --attach --file attach.json. Os instaladores do HQbird 2027 fazem isso sozinhos. Um pedido com chave comum é aprovado pelo administrador no painel da central. Uma chave de licença aprova o pedido sozinha enquanto houver vagas livres na licença. - Nome do agente = nome no certificadoCom esse nome o agente tem uma pasta de dados, configurações e uma linha no console. O instalador do Windows pergunta o nome do servidor; o padrão é o nome do computador. O certificado vale um ano; um certificado revogado para de funcionar na hora.
- Nada se perdeArquivo de até 120 MiB. Em erro de rede, 3 tentativas. O arquivo enviado é apagado; o não enviado nunca é apagado. Cada agente envia com seu próprio atraso de até 150 s, por isso os agentes de uma central não chegam no mesmo segundo.
- Licenças pela centralO agente busca uma nova licença em cerca de um minuto: a resposta à consulta de configurações avisa sobre ela. Além disso, o agente pede a licença ao iniciar e a cada 6 horas. Ele a verifica sozinho, sem rede. A página Licenses mostra o estado de cada servidor.
- O console não toca nos bancosO HQ Monitor monta as páginas a partir dos arquivos dos agentes. Ele não se conecta ao Firebird e não gera carga nos bancos de dados.
- Um servidor LinuxUbuntu ou AlmaLinux. A central é instalada com um script; rodar de novo atualiza o que existe e mantém senhas e chaves.
Para a IBSurgeon vão resumos: saúde dos servidores, lista de servidores, lista de backups e restaurações (sem os próprios arquivos), eventos e relatórios semanais, descrições de clusters, licenças. Logs, traces, arquivos de backup, senhas e o log de auditoria ficam com o cliente.
Editor de configurações · Run now · status de entrega
Configurações pela central
A central guarda uma cópia das configurações de cada agente. O administrador muda jobs e configurações no mesmo editor usado junto ao agente e clica em Save and Send to agent. O agente busca a mudança em cerca de um minuto.
O agente não grava novas configurações por cima das que estão em uso. Primeiro ele verifica o candidato. Um candidato ruim é deixado de lado, as configurações em uso ficam, e o console mostra o motivo da recusa.
Status na página de servidores
Para cada servidor dá para ver até onde chegou a última mudança: ícone de status, hora do envio (push) e hora da resposta do agente (ack). A dica no ícone mostra o motivo da recusa do agente e a hora exata.
Assim, em um minuto, você vê quais servidores aceitaram o novo job de backup, quais não aceitaram e por quê.
O nível do servidor na lista é a conclusão do agente sobre o servidor inteiro. Abaixo dos ícones fica uma linha com o achado principal. Um ícone “Agent” separado só aparece quando o estado do próprio agente é pior que o estado do servidor.
Um servidor em silêncio há mais de 30 minutos recebe um ícone cinza “sem dados desde …” e vai para o fim da lista. A linha de resumo acima da lista conta os servidores por nível.
O agente poupa o servidor
O agente acompanha sua própria memória e CPU. Se uma tarefa do agente usa demais, o agente a pausa e para a execução que segura a memória. Backups e envio de dados ele não toca. Se a memória do agente continua crescendo, o agente reinicia sozinho. Uma tarefa que o agente desligou aparece no relatório de saúde e no editor; um botão a liga de novo.
Run now pela central
Backup, restauração, sweep, verificação gfix ou recálculo de índices podem ser iniciados agora, sem esperar o agendamento. O pedido segue o mesmo caminho: vai para o goafts, depois o agente o busca na consulta e o põe na sua fila, com as verificações de sempre.
- RascunhosDá para salvar uma mudança no console e enviá-la depois. O estado fica visível: not sent, sent, applied, superseded.
- Senhas não aparecem na centralO console criptografa a nova senha com a chave pública do agente. Só o agente no seu servidor consegue descriptografá-la.
- Cópias das configuraçõesAntes de cada troca, o agente salva uma cópia: as 10 últimas, por no mínimo 14 dias. Candidatos rejeitados ficam guardados 90 dias.
- Só no servidorVerificação de assinatura dos releases, licença, comandos remotos, caminhos de programas e login no console não podem ser alterados pela central.
- Troca do banco: dos dois ladosA restauração remota que substitui o banco de dados em uso só funciona se isso estiver permitido no próprio servidor e o usuário tiver um direito separado. Antes de iniciar, é preciso digitar o nome do arquivo do banco.
- databases.conf pela centralO arquivo pode ser enviado a um agente. O goafts só o repassa; quem verifica e grava o arquivo é o agente, e o antigo fica salvo ao lado.
Assinatura · ponto de rollback · verificação
Atualizações com rollback
Os agentes pegam novas versões no HQCenter, não na internet. O agente atualiza a si mesmo, o HQ Monitor, os programas do cluster e o Firebird. Toda atualização segue o mesmo esquema: verificar a assinatura, salvar um ponto de rollback, instalar, verificar se funciona. Se não funcionar, voltar à versão antiga.
- 1Assinaturarelease assinado pela IBSurgeon
- 2Ponto de rollbackcópia da versão atual
- 3Instalaçãotroca dos arquivos
- 4Verificaçãoa nova versão avisa "estou funcionando" e roda por 45 s
- 5Prontoa nova versão funciona
- ↺Rollbackrestaurar a cópia do ponto de rollback
- ✓A versão antiga funcionaapós 2 rollbacks a versão é bloqueada
| O que é atualizado | Quando | Proteção |
|---|---|---|
| Agente | na hora, quando a resposta à consulta de configurações informa uma nova versão, e uma vez por hora; sem essa resposta, a cada 180 s | Assinatura, 2 pontos de rollback. A nova versão precisa avisar "estou funcionando" e rodar por 45 s. Após 2 rollbacks a versão é bloqueada. |
| HQ Monitor | uma vez por hora enquanto a consulta de configurações funciona; senão a cada 180 s | Verificação do console por 30 s, cópia da versão antiga. |
| Programas do cluster | verificação a cada 180 s | Primeiro a réplica, depois o master. |
| Firebird | só na janela, por padrão 03:30–04:00 | Espera o fim dos backups. Verificação após a instalação, rollback em caso de falha. Um build que sofreu rollback não é instalado de novo. |
| HQCenter | a cada 15 min, se a IBSurgeon ativou a atualização para esta central; na janela definida pela IBSurgeon, por exemplo 02:00–05:00 | Desligado por padrão. O dono da central pode proibir a atualização: STACK_UPDATE=off. Verificação da assinatura do pacote, depois até 5 minutos de verificação dos serviços. Se falhar, o pacote anterior do cache é instalado. |
- Primeiro teste, depois todosA IBSurgeon publica o release primeiro na zona de teste e, após a verificação, nas zonas de produção. O HQCenter copia os releases da sua zona uma vez por hora.
- Assinatura verificada duas vezesA central verifica a assinatura antes do download e de novo nos bytes gravados. O agente a verifica outra vez antes de instalar.
- Sem downgradeNão é possível instalar uma versão menor que a atual, a menos que o próprio servidor permita.
- No Linux, quem troca os arquivos é o rootO serviço do agente não roda como root e não pode substituir os arquivos de instalação confiáveis.
Monitoramento de status · e-mail · webhook
E-mails sobre problemas e relatório semanal
O HQCenter lê o retrato de estado de cada agente. Um problema novo, ou um problema que ficou mais grave, é um evento. Quem envia o e-mail ou webhook é a própria central. Uma vez por semana a central prepara um relatório de todo o parque.
A central não muda nada sozinha. Se um problema dura semanas e isso é normal para o servidor, a central sugere um novo limite. Só uma pessoa o aplica.
- 1Leitura do statusa cada 2 minutos, se o arquivo do agente mudou
- 2Eventonovo, piorou, sumiu, voltou
- 3E-mailou webhook; sem repetição em 24 h
- 4Relatório semanalpor padrão na segunda-feira às 07:00
- 5✓ Sugestãonovo limite; o administrador aplica
Todo o parque em 14 dias
Para cada servidor: parcela do tempo sem problemas, quantos episódios por semana e quais achados estão "presos".
Não é ruído, é o normal
Ativo em pelo menos metade do tempo e em pelo menos uma semana seguida. Por exemplo, a CPU do servidor está sempre perto do limite.
Limite pelos fatos
Um pouco além do que o servidor mostrou: um quarto acima do máximo. Para um limite inferior, como espaço livre, um quinto abaixo do mínimo. Pode ser alterado antes da aprovação; vale por 30 dias.
- Um host, um e-mailSe o host tem vários agentes, um problema de CPU, memória ou disco do host conta uma vez só.
- Sumiu ou ocultoO evento diz por que o problema sumiu: corrigido, reconhecido pelo administrador ou virou info.
- Aprovação é uma nova versão das configuraçõesO limite vai ao agente pela entrega normal, em nome do administrador. Cada aprovação e recusa fica no log de auditoria.
- Link no e-mailO e-mail cita o host, dá uma dica e um link para o servidor no HQ Monitor.
O administrador da central ativa o e-mail e o webhook. Enquanto não estiverem configurados, nenhum e-mail sai. Eventos e relatórios aparecem no painel da central e na sua API.
Usuários · direitos · auditoria · idiomas
Usuários e direitos
Cada usuário vê só os seus servidores. Os direitos de alteração são dados à parte, um a um.
O administrador vê todos os servidores e gerencia os usuários. Um usuário comum vê os servidores da sua lista. Um novo direito ou uma nova lista vale a partir do próximo carregamento da página; uma nova senha desconecta o usuário de todos os navegadores.
| Direito | O que permite |
|---|---|
| Enviar configurações | Enviar ao agente, pela central, configurações alteradas. |
| Executar jobs | Iniciar e cancelar backup, restauração, sweep ou recálculo de índices (Run now). |
| Jobs com troca do banco | Iniciar uma restauração que substitui o banco de dados em uso. Só junto com o direito de execução e só se o agente também permitir. |
- Log de auditoriaCada gravação, envio, troca de senha e início de job é registrado com o login do usuário. No goafts, o log é protegido por uma cadeia de hashes.
- Log de pedidos do agenteO próprio agente grava uma linha para cada pedido que altera o servidor e para cada acesso negado: Local API, comandos da central, Run now, mudança de configurações, atualizações. Senhas e corpos dos pedidos não entram no log. O arquivo vai para a central junto com os logs.
- Login no HQ MonitorSessão de 7 dias. No máximo 8 tentativas de login de um mesmo endereço em 15 minutos.
- Painel do administrador da centralLogin separado, só com certificado de administrador. Sessão de 8 horas. Após 5 tentativas falhas em 15 minutos, o login fica bloqueado por 15 minutos.
- Até 2000 usuáriosCada um com sua senha e sua lista de servidores; busca por servidor na atribuição.
- 5 idiomas de interfaceinglês, russo, alemão, português (Brasil), espanhol. Os relatórios de estatística também saem no idioma escolhido.
← Voltar à visão geral do HQbird 2027 · Saúde do servidor em um minuto →