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.

JobO que fazQuais bancosPadrão
Sweepgfix -sweep: remove versões antigas de registros.Lista explícita de bancosdom 03:00
Sweep em grupoO mesmo sweep para todos os bancos nas pastas. Máscaras, exclusões, profundidade de busca.Pastas, máscara *.fdb00:15–01:15
Validação gfixgfix -v -full: verifica cada página do banco.Só lista explícitadom 02:30
Recálculo de índicesSET STATISTICS para índices de usuário. Também encontra índices inativos.Lista de bancosdom 04:00
Scripts SQLSeu DDL e DML da pasta de scripts de entrada ou da fila.Um banco por script03: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 é executadoDROP DATABASE, usuários e roles, GRANT e REVOKE, 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.

    RegraO que contaO que o agente faz
    Janela de manutençãoSweep 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 bancoBackup, 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 servidorBackups, 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 .deltaHá um arquivo .delta ao lado do banco: o nbackup segura o banco.O sweep pula esse banco.
    Erro de um banco no grupoO 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.
    Aba “Tarefas”. Jobs por grupo: estado, agendamento, última execução e resultado. Jobs de restauração perigosos são ativados por uma caixa de seleção separada.

    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.

    Janelasáb 22:00 — dom 06:00
    Iníciodom 01:00
    Linhas1 000 000
    Espaço livre em discocerca de 7,2 GiB; sem isso o teste não inicia
    Históricoúltimas 30 execuções
    Ao mesmo tempoum 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.

    Editor do databases.conf. À esquerda, caminhos e aliases; à direita, aliases e parâmetros do caminho selecionado. A coluna firebird.conf mostra o valor do servidor.
    Histórico de configs. O agente salva uma cópia de databases.conf, firebird.conf e replication.conf a cada alteração. Dá para ver o que mudou e quando.

    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 →