Imniren akk

Manual de Serviço

Ldi i tɣuri Sader amnir ummid (PDF) 112 isebtar, 4.9 MB

Amnir n tenfa s tutlayt-ik yettwahyag. Alamma yemmed, ha-t-an s Português (Portugal).

Wagi d amnir n lqem 9.95.0. Ddu ɣer lqem amaynut

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 WindowsTipoO que éQuando arranca
ClarusPrimePostgresServiço do WindowsA base de dados PostgreSQLCom o computador, automaticamente
Server na pasta de tarefas \Clarus\Clarus_prime\Tarefa agendada ocultaO próprio programaA cada início de sessão no Windows
Updater na mesma pastaTarefa agendadaO instalador de atualizaçõesUm minuto depois de o computador arrancar e quando o programa o pede
Support na mesma pastaTarefa agendadaExecuta as ações de apoio remotoQuando 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:

ItemValor
Porta5439; se estiver ocupada, o instalador escolhe a primeira porta livre a seguir
Quem lhe pode acederApenas este computador (o endereço 127.0.0.1); a rede nunca lhe chega
Nome da base de dadosclarus_lis
A conta do programa nelaclarus_lis
A sua conta de administradorpostgres
Início de sessãoCom uma palavra-passe cifrada (SCRAM-SHA-256), mesmo a partir do próprio computador
CodificaçãoUTF-8
Pasta de dadospgdata dentro da pasta de dados do programa: D:\Clarus\Clarus_prime\data\pgdata ou C:\ProgramData\Clarus\Clarus_prime\data\pgdata
Registopostgresql.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:

  1. 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.
  2. Se não responder, tenta repará-la executando de novo a configuração da base de dados, no máximo durante três minutos.
  3. Se continuar a não responder, para e escreve uma mensagem que indica os ficheiros de registo postgresql.log e postgresql-startup.log e o comando de reparação a executar à mão.
  4. 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.
  5. 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çãoO que faz
Verificação rápidaUma verificação rápida da integridade dos dados
Verificação de integridadeUma verificação completa da integridade, mais demorada do que a rápida
Reparar chaves estrangeirasRepara as ligações entre tabelas, se alguma estiver quebrada
Atualizar estatísticasAtualiza as estatísticas da base de dados, para que as consultas corram mais depressa
VacuumRecupera o espaço deixado pelos registos eliminados e alterados
CheckpointEscreve 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çoO que indica
http://127.0.0.1:<porta>/api/healthO programa está em execução, e a sua versão. Não toca na base de dados
http://127.0.0.1:<porta>/api/readyO 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ávelO que fazer
O programa não abre depois de o servidor reiniciarNinguém iniciou sessão no WindowsInicie sessão, aguarde um minuto e abra o programa
Uma mensagem no arranque que indica postgresql.logA base de dados não arrancouLeia 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 arrancaUm disco cheio, um ficheiro da base de dados danificado ou software de segurança que o bloqueiaVerifique primeiro o espaço livre no disco. Depois leia o registo. Não elimine nada de pgdata
/api/health responde e /api/ready nãoO programa está em execução e a base de dados nãoReinicie 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 programaOutro programa do computador tem PostgreSQLNada: 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 é grandeEstatísticas antigas ou espaço por recuperarExecute 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).

Mmel-d tuccḍa n tsuqilt

Ileqman-nniḍen n umnir: 9.95.2

WhatsApp Azen aseɣwen n usader ɣer uselkim-ik