Manutenção do servidor HQbird
Manutenção sem plantão noturno
Sweep, validação do banco, recálculo das estatísticas de índices, seus scripts SQL e a atualização do Firebird rodam à noite, conforme o agendamento. O sweep em grupo, os scripts SQL e a atualização do Firebird só começam na sua própria janela. O agente não atrapalha os backups nem os usuários. Se algo der errado, ele mesmo restaura o estado anterior.
- 4 jobs de manutenção
- 1 operação pesada por banco
- 2 tarefas pesadas por servidor
- 03:30–04:00 janela de atualização do Firebird
- rollback automático se a verificação falhar
Agendamento padrão
A noite do servidor
A manutenção roda à noite, cada job no seu horário. Abaixo estão os horários e as janelas padrão. Você os altera no editor de configuração do agente.
Sweep, validação gfix, recálculo de índices e scripts SQL vêm desativados por padrão: você os ativa para os seus bancos. Os horários seguem o fuso horário do agente.
A noite de domingo segue esta ordem: validação gfix às 02:30, sweep às 03:00, recálculo de índices às 04:00. Primeiro a verificação, depois a coleta de lixo, depois as estatísticas sobre os dados vivos.
sweep · gfix · índices · SQL
Quatro jobs de manutenção
Cada job é um comando comum do Firebird. O agente acrescenta o que o DBA costuma fazer à mão: agendamento, janela, bloqueio do banco, log e um motivo de erro claro.
| Job | O que faz | Quais bancos | Padrão |
|---|---|---|---|
| Sweep | gfix -sweep: remove versões antigas de registros. | Lista explícita de bancos | dom 03:00 |
| Sweep em grupo | O mesmo sweep para todos os bancos nas pastas. Máscaras, exclusões, profundidade de busca. | Pastas, máscara *.fdb | 00:15–01:15 |
| Validação gfix | gfix -v -full: verifica cada página do banco. | Só lista explícita | dom 02:30 |
| Recálculo de índices | SET STATISTICS para índices de usuário. Também encontra índices inativos. | Lista de bancos | dom 04:00 |
| Scripts SQL | Seu DDL e DML da pasta de scripts de entrada ou da fila. | Um banco por script | 03:00–04:00 |
- Transações longas antes do sweepOpcionalmente, o agente desconecta as conexões com transações de mais de 5 horas (o limite é configurável). Ele não mexe em gbak, gfix, gstat e fbsvcmgr.
- O grupo não paraUm erro em um banco não interrompe o processamento dos outros bancos.
- Motivo claroO Firebird 3 e posteriores não permitem validar um banco com usuários conectados. O agente diz isso claramente, em vez de mostrar só um código de erro.
- SQL: o agente faz o COMMITDDL: COMMIT após cada comando; DML: a cada 100 comandos.
SET BAIL ON: o primeiro erro para o script. - SQL perigoso não é executado
DROP DATABASE, usuários e roles,GRANTeREVOKE,ALTER DATABASE: um script assim vai inteiro para a quarentena. - Log de execuçõesQual comando, quando e com qual resultado. Para sweep e validação gfix, o agente guarda o histórico de comandos: até 50 por job, os dois últimos aparecem no editor. A senha não vai para o log.
Janelas · bloqueios · vagas
Se o servidor está ocupado, o job espera ou pula o banco
Antes de iniciar, o agente verifica várias condições. Se uma condição não é atendida, o job espera ou pula o banco. Ele não interrompe o trabalho de outros.
Ative as condições à esquerda e veja o que o agente faz com o banco sales.fdb no sweep em grupo da pasta dele.
| Regra | O que conta | O que o agente faz |
|---|---|---|
| Janela de manutenção | Sweep em grupo 00:15–01:15, scripts SQL 03:00–04:00, teste de desempenho sáb 22:00 — dom 06:00. | Fora da janela o job não inicia. Se falta menos de um minuto para o fim da janela, também não inicia. |
| Uma operação pesada por banco | Backup, sweep, validação, recálculo de índices, restauração e script SQL pegam o bloqueio do banco. | O backup espera até 60 minutos o banco ficar livre. Sweep, validação e recálculo de índices pulam o banco ocupado até a próxima execução agendada. O Run now espera e tenta de novo. |
| No máximo 2 tarefas pesadas por servidor | Backups, restaurações, sweep, validações, recálculo de índices, scripts SQL, gstat completo, o teste. O trabalho pesado do próprio agente também ocupa vaga: processamento de traces e logs. | A terceira tarefa espera uma vaga livre. O número é alterado nas configurações; o novo valor vale após reiniciar o agente. |
Arquivo .delta | Há um arquivo .delta ao lado do banco: o nbackup segura o banco. | O sweep pula esse banco. |
| Erro de um banco no grupo | O sweep de um banco do grupo terminou com erro. | O sweep de grupo continua a partir do próximo banco. Se a continuação estiver desativada, só esse job para. Os bancos com erro aparecem no resumo do job. |
Se um backup gbak e um nbackup do mesmo banco caem no mesmo minuto, o backup gbak é adiado em 15 minutos. Uma execução manual pelo Run now não é adiada.
Um botão
Run now: executar agora
Precisa de um backup antes de atualizar um programa ou de um sweep agora mesmo? O botão “Executar agora” (Run now) na linha do job o executa uma vez. O agendamento não muda.
O Run now existe para backups, restaurações, sweep, recálculo de índices e validação gfix. Um job desativado também pode ser executado uma vez: depois ele continua desativado. O agente verifica as mesmas condições do agendamento e mostra o que está esperando.
- Dá para ver o que ele esperaO banco está ocupado com outra operação, o job espera a janela, pouco espaço em disco.
- CancelamentoEnquanto a execução está na fila ou esperando, é possível cancelá-la. Um job já iniciado não é cancelado.
- O pedido vale por 60 minutosSe o agente não o pegar nesse tempo, a execução conta como expirada, não perdida.
- Dá para ver qual banco vai rodarA janela de execução começa pelo campo do banco. Para um job de grupo, são caixas de seleção dos bancos e a linha “marcados N de M”.
- Relatório de desempenho sob demandaO Run now gera um relatório de qualquer intervalo de até 24 horas, com filtros por banco, duração e programa. É a mesma execução do botão “Build report…” na página do relatório.
- Local e pela centralO console local fala direto com o agente. Pela central, o pedido passa pelo goafts. O agente o pega na próxima sincronização, em cerca de um minuto.
- Substituição do banco à parteRestauração com substituição e ciclo backup-restauração-substituição: é preciso digitar o nome do arquivo do banco e ter uma permissão própria. A execução remota desses jobs vem desativada no servidor por padrão.
- Logo após salvarO Run now espera o agente aceitar a nova configuração e só então inicia o job.
Atualização do motor
Um novo build do Firebird é uma operação noturna comum
O agente baixa sozinho o novo build do Firebird, espera a janela de manutenção, instala e verifica. Se a verificação falhar, o agente volta à versão anterior e não instala mais esse build.
- JanelaPor padrão, 03:30–04:00. Fora da janela, o build baixado espera o início da janela. Se a atualização for adiada dentro da janela, o agente tenta de novo em 10 minutos. O agente encontra um novo build na central em cerca de uma hora.
- Jobs que não podem ser interrompidosSe há gbak, nbackup, restauração ou script SQL em andamento, a atualização fica para a próxima verificação. Sweep, validação gfix e gstat não impedem: eles podem ser repetidos.
- Um motor por vezEm um servidor com várias instâncias do Firebird, só uma é atualizada por vez.
- Espaço e arquivos em usoO espaço livre e os arquivos presos por outro programa são verificados antes de parar o Firebird. Se um arquivo não pode ser substituído, o Firebird não é parado.
- Seus arquivos ficamO agente substitui só os arquivos da distribuição. firebird.conf, databases.conf, replication.conf, o banco de segurança, UDFs e plugins de terceiros ficam. No firebird.conf só são adicionados os parâmetros obrigatórios que faltam.
- RollbackOs arquivos substituídos ficam no backup da atualização. O rollback os devolve ao lugar. São guardados os 2 últimos backups.
- Bloqueio de versãoUm build que teve rollback, automático ou manual, fica bloqueado. Um comando remove o bloqueio.
- Atualização incompletaSe o processo parou no meio, uma nova atualização não começa até o administrador fazer o rollback ou concluir a anterior.
O agente não atualiza o Firebird instalado por pacotes do SO (apt, dnf): os arquivos pertencem ao gerenciador de pacotes. Como migrar esse servidor para o HQbird está descrito abaixo.
Teste · databases.conf · migração
Ferramentas do administrador
Teste de desempenho do servidor
Uma vez por semana o agente roda o teste da IBSurgeon: INSERT, UPDATE e DELETE em um milhão de linhas em um banco temporário. O histórico dos testes mostra como o servidor funcionava antes e depois de uma troca de hardware, disco ou configurações.
O teste carrega o disco, por isso roda só na sua janela. O próprio Firebird apaga o banco temporário. Se o agente cair durante o teste, o arquivo é apagado na próxima inicialização.
| Janela | sáb 22:00 — dom 06:00 |
|---|---|
| Início | dom 01:00 |
| Linhas | 1 000 000 |
| Espaço livre em disco | cerca de 7,2 GiB; sem isso o teste não inicia |
| Histórico | últimas 30 execuções |
| Ao mesmo tempo | um teste; a segunda execução é ignorada |
Usuários do Firebird: Security.fdb/Users
Uma página de configurações separada mostra os bancos de segurança do servidor: o comum, os privados e os embutidos no banco. Etiquetas mostram o problema: não há login para leitura, a lista não foi atualizada, o registro está desatualizado.
O botão Create user cria um usuário do Firebird pelo agente. Na janela: nome, senha duas vezes, plugin da configuração UserManager, opções “ativo” e “administrador”. Os direitos de administrador são confirmados em um segundo passo. Antes da execução, aparece o texto do comando, com a senha oculta.
A criação funciona com o agente local e não funciona para o Firebird 2.5.
Editor do databases.conf
O arquivo aparece como uma lista de caminhos de bancos. Cada caminho tem seus aliases e um bloco de parâmetros. A lista de parâmetros traz só os que esta versão do Firebird aceita por banco. Ao lado aparece o valor do firebird.conf.
Alias repetido e segundo bloco para o mesmo caminho são erros: não é possível salvar um arquivo assim. Um erro de digitação no nome do parâmetro recebe uma dica. Ao salvar, o agente verifica o arquivo de novo e deixa ao lado uma cópia do arquivo anterior. Se o arquivo mudou enquanto você editava, o agente recusa, e o seu texto fica no editor. Edições no formulário não mexem nos comentários do arquivo. Cada gravação vai para o log de auditoria.
Pela central, o arquivo é entregue pelo goafts. O agente o aplica em cerca de um minuto e informa o resultado: aceito ou rejeitado.
Migração para o HQbird e mudanças de configuração
FBDataGuard
As configurações do HQbird antigo migram sozinhas
Na primeira inicialização, o agente encontra a configuração do FBDataGuard e migra os jobs de backup, sweep e estatísticas de índices. A importação acontece uma vez. Por padrão, os jobs chegam desativados. Se o instalador desativa o FBDataGuard, são ativados os jobs que o FBDataGuard executava e que foram importados sem avisos. Assim o servidor não fica sem backups. Os outros jobs continuam desativados: verifique-os e ative-os você mesmo. O agente passa a controlar os backups antigos dos journals do FBDataGuard: a retenção e a restauração os veem.
apt · dnf
Firebird de pacotes do SO
O instalador encontra o Firebird de pacotes e para sem alterar nada. Ele imprime os comandos que removem o pacote e preservam o banco de segurança, o databases.conf e os bancos. Depois o instalador instala o HQbird e aproveita os usuários e aliases do servidor anterior. Testado com Firebird 2.5, 3.0, 4.0 e 5.0.
sem reiniciar
Novas configurações, com verificação
O agente verifica a nova configuração, faz uma cópia da antiga e aplica a nova sem reiniciar. Se a nova não carregar, o agente volta à anterior. A maioria das configurações é aplicada sem reiniciar. É preciso reiniciar para a pasta de dados, o log do agente, a Local API, a conexão com a central, o Prometheus, o cluster, os limites de carga e o fuso horário do agente. O agente informa quais mudanças aguardam reinício.
← Voltar à visão geral do HQbird 2027 · Backups em detalhe → · Saúde do servidor →