Capítulo 2Instalação
Este capítulo destina-se ao técnico que instala o CLARUS Prime nos computadores do laboratório. Acompanha o instalador página a página, explica depois o que o instalador faz após copiar os ficheiros, como instalar sem direitos de administrador ou sem o assistente, e o que fazer quando uma instalação tropeça.
2.1 Antes de começar
- O ficheiro do instalador. O seu nome começa por
CLARUS-Prime-Setup. O mesmo ficheiro instala um servidor e um computador membro, em todos os idiomas que o instalador fala. - Uma conta de administrador. O instalador pede direitos de administrador quando arranca. Sem eles, a base de dados não pode ser registada como serviço do Windows (ver 2.10 Instalar sem direitos de administrador).
- A internet. Não é necessária para instalar. Mas o período experimental começa com a assinatura do fornecedor, que o instalador obtém durante a instalação (ver 3.2 O período experimental).
- O programa antigo fechado, se já houver uma versão instalada neste computador. O instalador não instala por cima de um programa que ainda esteja em execução e a reter os seus ficheiros.
2.2 As páginas do instalador, por ordem
O instalador pergunta primeiro o seu idioma. A partir daí, todas as páginas, a licença e a declaração sobre os dados ficam nesse idioma.
| Página | O que pede | Quando aparece |
|---|---|---|
| Boas-vindas | Nada | Sempre |
| O contrato de licença | Aceitação da licença | Sempre |
| Tipo de instalação | Servidor da filial, ou um computador de uma filial existente | Numa instalação nova. Uma atualização mantém a função que encontra |
| Dados e privacidade | Concordância com a forma como o programa trata os dados do laboratório | Apenas num servidor |
| A verificar este computador | Nada; mostra o que encontrou | Sempre num servidor. Num membro, apenas quando encontrou algo a corrigir |
| Pronto para instalar | A forma recomendada, ou a escolha de cada parte | O servidor de um laboratório novo |
| A pasta | Onde fica o programa | Ao escolher cada parte, e num membro |
| Já existe um laboratório neste computador | A partir de que parte começa a instalação | Apenas quando o instalador encontra dados ou cópias de segurança anteriores para a pasta escolhida |
| Onde ficam as cópias de segurança | A pasta das cópias de segurança | Um servidor, ao escolher cada parte |
| Os idiomas do laboratório | Os idiomas além do inglês | Um servidor novo, ao escolher cada parte |
| O que encontrámos | O país, a moeda, o papel e o fuso horário | Ao escolher cada parte, e sempre que o Windows não indicou o país |
| Ativação | O número de série, ou o número de licença do computador membro | Sempre |
| Pronto | Um resumo das escolhas | Apenas ao escolher cada parte |
| A instalar, e depois a página final | Nada | Sempre |
2.3 Servidor ou membro
A página «Tipo de instalação» tem duas opções:
| Opção | O que significa |
|---|---|
| Servidor da filial | A base de dados da filial fica guardada neste computador e o programa corre nele. Escolha-a para o primeiro computador de um laboratório ou de uma filial |
| Um computador de uma filial existente | Trabalha sobre a base de dados do servidor da sua filial e junta-se a ele com o número de licença próprio deste computador, depois de o servidor da filial permitir esse número. Nenhum dado do laboratório fica guardado nele |
O instalador de um computador membro é mais curto: não tem a página Dados e privacidade, nem a página das cópias de segurança, nem a dos idiomas, porque nenhuma lhe diz respeito. O membro junta-se ao seu servidor na primeira vez que o programa arranca (ver Capítulo 5: Rede, filiais e Clarus Link).
2.4 A forma recomendada, ou a escolha de cada parte
Para o servidor de um laboratório novo, a página «Pronto para instalar» mostra o que o instalador vai fazer: a pasta do programa, os dados do laboratório, as suas cópias de segurança, e o país e a moeda. Oferece duas formas:
- Instalar assim (recomendado). O instalador avança diretamente para a ativação e depois instala.
- Quero escolher as pastas, os idiomas e o país. O instalador mostra cada uma dessas páginas e, antes de instalar, um resumo.
A forma recomendada ainda assim pergunta o país, se o Windows não o indicou. Nada é escolhido pelo laboratório por suposição.
2.5 As pastas
A pasta do programa. Quando o computador tem uma unidade fixa D, o instalador propõe D:\Clarus\Clarus_prime. Sem ela, C:\Program Files\Clarus\Clarus_prime. Qualquer uma pode ser alterada na página da pasta.
A pasta das cópias de segurança. Junto à pasta do programa, na unidade D: D:\Clarus\Clarus_prime-backups. Sem unidade D, C:\ProgramData\Clarus\Clarus_prime-backups. Porque é melhor um segundo disco explica-se em 8.2 Onde ficam as cópias de segurança.
A pasta de dados. A base de dados, as chaves de cifragem e os registos. O instalador coloca-a segundo estas regras, por ordem:
- Uma atualização mantém a pasta de dados que a instalação já tem.
- Se o programa estiver em Program Files, os dados vão para
C:\ProgramData\Clarus\Clarus_prime\data. - Caso contrário, a pasta de dados fica dentro da pasta do programa:
D:\Clarus\Clarus_prime\datana unidade D.
Todos os caminhos estão listados em B.1 As pastas principais.
2.6 Já existe um laboratório neste computador
Se o instalador encontrar os dados ou as cópias de segurança de uma instalação anterior para a pasta escolhida, pergunta a partir de que parte esta instalação começa:
| Opção | O que acontece |
|---|---|
| Utilizar os dados do laboratório na pasta que encontrou | A base de dados é usada tal como está. O laboratório regressa com os seus utilizadores e dados |
| Restaurar a cópia de segurança mais recente | O laboratório é restaurado a partir dessa cópia de segurança |
| Começar um laboratório novo | Uma base de dados nova. Os dados anteriores ficam onde estão |
Nada é eliminado, qualquer que seja a escolha. 15.2 Reinstalar sobre dados existentes explica quando esta página aparece depois de desinstalar.
2.7 Ativação no instalador
Num servidor, o número de série é opcional. Se ficar vazio, o programa inicia o seu período experimental completo de 14 dias. O número de série pode ser ativado em qualquer momento a partir do ecrã de licença dentro do programa (ver 3.3 Ativar a licença).
O instalador verifica o número de série à medida que é escrito. Se um carácter não coincidir com os restantes, indica-o: 1 e I, e 0 e O, são o par habitual.
Num computador membro, a caixa recebe o número de licença próprio deste computador na sua filial. Um membro não tem período experimental. Se o número não estiver à mão, deixe a caixa vazia e escreva-o na janela do programa depois de instalar.
2.8 O que o instalador faz depois de copiar
Depois de copiar os ficheiros, o instalador executa o script de instalação. Este:
- Regista tudo o que faz em
install-transcript.log, na pasta do programa. - Escolhe a porta do programa: a primeira livre a partir de 8000 (ver A.1 Portas em escuta no servidor).
- Num servidor, prepara a base de dados do laboratório. É o passo mais demorado. Depois regista o serviço
ClarusPrimePostgres, para que a base de dados arranque com o computador (ver 4.2 A base de dados). - Acrescenta o programa às «Aplicações instaladas» do Windows, com o nome
Clarus_prime. - Regista as tarefas agendadas na pasta
\Clarus\Clarus_prime\: atualizações, apoio remoto, regras da firewall e o arranque do programa no início de sessão (ver C.2 Tarefas agendadas). - Inicia o período experimental ou a ativação, se o computador conseguir contactar o fornecedor.
2.9 Quando o instalador termina
A página final indica como a instalação terminou:
| O que diz | O que significa |
|---|---|
| O programa está ativado e pronto | O número de série foi aceite |
| O seu período experimental começou | Não foi escrito nenhum número de série e o período experimental foi assinado |
| O número de série não foi aceite | O programa está instalado e funciona no período experimental. Tente de novo o número de série a partir do ecrã de licença |
| O período experimental começa com a nossa assinatura, que não chegou | O computador não conseguiu contactar o fornecedor. Abra o programa com internet e inicie o período experimental a partir do seu ecrã, ou com o código telefónico que ele mostra (ver 3.2 O período experimental) |
| A instalação não terminou | Os ficheiros foram copiados, mas não foi possível preparar a base de dados. Veja 2.12 Quando a instalação tropeça |
Na primeira vez que um laboratório novo abre o programa, este pede o nome do laboratório, os seus números de contacto e o seu logótipo, e nada mais (ver 3.1 A configuração inicial).
2.10 Instalar sem direitos de administrador
Quando o instalador arranca, o Windows pede direitos de administrador. Um utilizador que não os possa dar pode instalar o programa apenas para a sua própria conta. Nesse caso:
- Sem unidade D, o programa vai para
%LOCALAPPDATA%\Programs\Clarus\Clarus_prime. - A base de dados não é um serviço. Uma tarefa de início de sessão chamada
ClarusPrime PostgreSQLarranca-a quando esse utilizador inicia sessão, e só então (ver 4.2 A base de dados). - As atualizações e o apoio remoto pedirão direitos de administrador de cada vez.
Se o programa já estiver instalado para outra conta, ou com outros direitos, o instalador avisa: instalar de novo cria uma segunda cópia, com a sua própria pasta e a sua própria base de dados. Os dados do laboratório ficariam então numa cópia e não na outra.
2.11 Instalar sem o assistente
Para instalar em vários computadores, execute o instalador a partir de uma linha de comandos com direitos de administrador:
CLARUS-Prime-Setup.exe /VERYSILENT /SUPPRESSMSGBOXES /NORESTART /LOG="C:\setup.log"
/LOGregista nesse ficheiro os passos do próprio instalador. Sem ele, o instalador não guarda registo próprio./ROLE=memberfaz do computador membro o tipo de instalação predefinido.- Sem direitos de administrador, a base de dados não é registada como serviço.
O código de saída do instalador diz a um script de implementação como terminou:
| Código | Significado |
|---|---|
| 0 | Terminou |
| 3 | Os ficheiros estão no sítio, mas não foi possível preparar a base de dados. O programa não arrancará |
| 1 | O script de instalação parou por um erro seu. O programa não arrancará |
Quando o código não é 0, o motivo está em install-transcript.log, na pasta do programa.
2.12 Quando a instalação tropeça
| O que se vê | Causa provável | O que fazer |
|---|---|---|
| A verificação do computador recusa continuar | Um sistema de 32 bits, um Windows anterior ao 10, ou menos de 5 GB livres na unidade do sistema (2 GB para um membro) | Resolva o que a página indica e execute o instalador de novo (ver 1.2 O servidor) |
| A verificação do computador diz que uma porta está em uso por outro programa | Outro programa já está à escuta nela | Nada: o programa escolhe a porta livre seguinte e regista-a (ver A.1 Portas em escuta no servidor) |
| A verificação do computador avisa de outro software de segurança | Um antivírus diferente do Windows Defender | Nada, de início. Se a base de dados depois não arrancar, permita a pasta do programa nesse antivírus e instale de novo |
| «A instalação não terminou» com um código de erro | Não foi possível preparar a base de dados | Reinicie o computador e execute o instalador de novo como administrador. Se falhar outra vez, envie install-transcript.log ao apoio técnico |
| O programa que já está neste computador ainda está em execução | A versão antiga retém os seus ficheiros | Feche-o ou reinicie o computador e execute o instalador de novo |
| «Não foi possível registar o serviço da base de dados» | O instalador não foi executado como administrador | Execute-o de novo como administrador. Até lá, a base de dados não arranca depois de um reinício |
| A página final diz que a assinatura do período experimental não chegou | Sem internet durante a instalação | Inicie o período experimental a partir do ecrã do programa com internet, ou com o código telefónico |