Tüm kılavuzlar

Manual de Serviço

Okumak için aç Kılavuzun tamamını indir (PDF) 112 sayfa, 4.9 MB

Dilinizdeki Servis Kılavuzu hazırlanıyor. Hazır olana kadar burada Português (Portugal) dilinde.

Bu, 9.95.0 sürümünün kılavuzudur. En yeni sürüme git

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).

Çeviri hatası bildir

Kılavuzun diğer sürümleri: 9.95.2

WhatsApp İndirme bağlantısını bilgisayarınıza gönderin