Capítulo 4Base de dados e serviços
Este capítulo destina-se ao técnico de apoio e ao administrador informático do laboratório. Expõe:
- o que corre no servidor depois da instalação: a base de dados, o programa e as tarefas agendadas;
- como o programa arranca, e como o parar e reiniciar sem causar danos;
- como verificar a saúde da base de dados e o que fazer quando ela não funciona.
4.1 O que corre no servidor
| Nome no Windows | Tipo | O que é | Quando arranca |
|---|---|---|---|
ClarusPrimePostgres | Serviço do Windows | A base de dados PostgreSQL | Com o computador, automaticamente |
Server na pasta de tarefas \Clarus\Clarus_prime\ | Tarefa agendada oculta | O próprio programa | A cada início de sessão no Windows |
Updater na mesma pasta | Tarefa agendada | O instalador de atualizações | Um minuto depois de o computador arrancar e quando o programa o pede |
Support na mesma pasta | Tarefa agendada | Executa as ações de apoio remoto | Quando o programa o pede |
Num computador membro, a tarefa Member ocupa o lugar de Server e não existe base de dados. Todos os nomes estão em Apêndice C: Nomes dos serviços.
4.2 A base de dados
O instalador traz consigo o PostgreSQL 18 e cria um agrupamento de bases de dados próprio do laboratório:
| Item | Valor |
|---|---|
| Porta | 5439; se estiver ocupada, o instalador escolhe a primeira porta livre a seguir |
| Quem lhe pode aceder | Apenas este computador (o endereço 127.0.0.1); a rede nunca lhe chega |
| Nome da base de dados | clarus_lis |
| A conta do programa nela | clarus_lis |
| A sua conta de administrador | postgres |
| Início de sessão | Com uma palavra-passe cifrada (SCRAM-SHA-256), mesmo a partir do próprio computador |
| Codificação | UTF-8 |
| Pasta de dados | pgdata dentro da pasta de dados do programa: D:\Clarus\Clarus_prime\data\pgdata ou C:\ProgramData\Clarus\Clarus_prime\data\pgdata |
| Registo | postgresql.log na pasta de registos, com rotação a cada 20 MB |
O instalador dimensiona a memória da base de dados em função da do computador: um oitavo da memória para a sua cache, entre 128 MB e 1 GB.
4.2.1 As palavras-passe
O instalador gera duas palavras-passe aleatórias: uma para a conta de administrador e outra para a conta do programa. Guarda-as no ficheiro cluster-superuser.json na pasta de dados, que só os administradores e a conta SYSTEM podem ler.
O programa guarda o seu endereço para a base de dados, com a palavra-passe da sua conta, no seu ficheiro de configuração clarus-lis.config.json na pasta do programa.
4.2.2 Um laboratório instalado sem direitos de administrador
Quando o programa é instalado para um só utilizador sem direitos de administrador (ver 2.10 Instalar sem direitos de administrador), a base de dados não é registada como serviço. Em vez disso, uma tarefa de início de sessão chamada ClarusPrime PostgreSQL arranca a base de dados quando esse utilizador inicia sessão, e só então. Assim, depois de o computador reiniciar, nada funciona até esse utilizador iniciar sessão.
4.3 Como o programa arranca
O programa arranca sem janela a cada início de sessão no Windows, através da tarefa Server. É de propósito: depois de um reinício noturno para uma atualização do Windows, os analisadores começam o seu dia antes de alguém abrir o programa, pelo que este tem de estar à escuta.
Quando arranca, sucede por esta ordem:
- Garante que a base de dados está em execução. Se o serviço da base de dados estiver parado, arranca-o e espera que responda, no máximo durante dois minutos.
- Se não responder, tenta repará-la executando de novo a configuração da base de dados, no máximo durante três minutos.
- Se continuar a não responder, para e escreve uma mensagem que indica os ficheiros de registo
postgresql.logepostgresql-startup.loge o comando de reparação a executar à mão. - Prepara o laboratório. Entretanto, as páginas do programa respondem que ele está a ser preparado e pedem para tentar de novo dentro de alguns segundos.
- Entra em funcionamento e, com ele, o posto que imprime e liga os analisadores (ver Capítulo 7: Impressoras).
Duas cópias do programa nunca arrancam em simultâneo. Se um segundo utilizador iniciar sessão no Windows enquanto o programa está em execução, este não arranca de novo, e o atalho do programa no ambiente de trabalho abre a sua janela na cópia que já está em execução.
4.4 Parar e reiniciar
A forma mais segura é sempre reiniciar o próprio computador e depois iniciar sessão. O Windows fecha então a base de dados de forma limpa e tudo arranca de novo pela sua ordem.
Quando o técnico precisa de parar apenas o programa, sem reiniciar, o script de paragem está na pasta do programa:
D:\Clarus\Clarus_prime\packaging\windows\stop-clarus-lis.ps1
Pára, por ordem, primeiro o programa e depois o serviço da base de dados. Execute-o a partir do PowerShell com direitos de administrador. Depois arranque o programa de novo a partir do atalho no ambiente de trabalho, que arranca a base de dados antes dele.
4.4.1 Uma base de dados em execução fora do seu serviço
Após uma atualização, a base de dados pode ficar em execução, mas fora do seu serviço registado, pelo que o serviço aparece como parado. Em versões antigas, isto recusava todas as novas ligações até o Windows reiniciar. Agora a configuração da base de dados deteta-o sozinha: pára de forma limpa a cópia que corre fora do serviço e depois arranca o serviço. Se não conseguir pará-la, deixa a base de dados em execução e escreve um aviso; nesse caso, reinicie o computador.
4.5 Verificar a sua saúde
4.5.1 A partir do programa
O menu Apoio tem dois ecrãs:
- Estado e diagnóstico: o cartão Base de dados com o seu tamanho e integridade, e o cartão de disponibilidade do servidor com o número de ligações à base de dados e de sessões abertas. Abaixo deles está a secção Manutenção da base de dados.
- Servidor e atualizações: o tipo, o endereço e a porta da base de dados, e o estado das atualizações.
4.5.2 Manutenção da base de dados
Na secção Manutenção da base de dados, o técnico mede o tamanho da base de dados com Medir agora e vê a última manutenção e o que o servidor recomenda. As operações são:
| Operação | O que faz |
|---|---|
| Verificação rápida | Uma verificação rápida da integridade dos dados |
| Verificação de integridade | Uma verificação completa da integridade, mais demorada do que a rápida |
| Reparar chaves estrangeiras | Repara as ligações entre tabelas, se alguma estiver quebrada |
| Atualizar estatísticas | Atualiza as estatísticas da base de dados, para que as consultas corram mais depressa |
| Vacuum | Recupera o espaço deixado pelos registos eliminados e alterados |
| Checkpoint | Escreve no disco o que está retido em memória |
Nenhuma é executada a menos que o técnico a peça; cada uma fica registada na auditoria em nome dele, e nenhuma elimina um registo. A base de dados também se limpa automaticamente em segundo plano, como o PostgreSQL faz, pelo que nenhuma destas operações é necessária em utilização normal. Execute Atualizar estatísticas depois de uma grande migração, embora o programa já o faça sozinho após cada migração do RealLab.
4.5.3 A partir de um navegador
No próprio servidor, o programa responde a dois endereços que o técnico pode abrir num navegador. A porta é a do programa (ver Apêndice A: Portas):
| Endereço | O que indica |
|---|---|
http://127.0.0.1:<porta>/api/health | O programa está em execução, e a sua versão. Não toca na base de dados |
http://127.0.0.1:<porta>/api/ready | O programa acede à base de dados. Se não aceder, responde com o código 503 |
Se o primeiro responder e o segundo não, o programa está em execução e a base de dados não.
4.6 Quando a base de dados não funciona
| O que se vê | Causa provável | O que fazer |
|---|---|---|
| O programa não abre depois de o servidor reiniciar | Ninguém iniciou sessão no Windows | Inicie sessão, aguarde um minuto e abra o programa |
Uma mensagem no arranque que indica postgresql.log | A base de dados não arrancou | Leia as últimas linhas de postgresql.log e postgresql-startup.log na pasta de registos (ver Apêndice B: Caminhos) e reinicie o computador |
O serviço ClarusPrimePostgres está parado e não arranca | Um disco cheio, um ficheiro da base de dados danificado ou software de segurança que o bloqueia | Verifique primeiro o espaço livre no disco. Depois leia o registo. Não elimine nada de pgdata |
/api/health responde e /api/ready não | O programa está em execução e a base de dados não | Reinicie o computador. Se voltar a acontecer, execute o comando de reparação da mensagem de arranque, com direitos de administrador |
A porta 5439 está ocupada por outro programa | Outro programa do computador tem PostgreSQL | Nada: o instalador escolheu outra porta e registou-a. Veja a porta real no ficheiro de configuração |
| O programa está lento e a base de dados é grande | Estatísticas antigas ou espaço por recuperar | Execute Atualizar estatísticas e depois Vacuum fora do horário de trabalho |
Se a própria pasta da base de dados estiver danificada, o caminho de regresso é restaurar a partir da última cópia de segurança (ver 8.9 Restaurar a partir de uma cópia de segurança).