Conceitos Gerais
Na versão 4.0, processo de instalação da Tesouraria ocorre por meio de um instalador que será melhor detalhado ao longo dessa seção. O propósito do instalador é simplificar o processo de instalação/atualização e automatizar ações que eram executadas manualmente na versão anterior da Tesouraria, como: informar o número dos processadores, validação de acesso a base de dados configurada, configuração de serviços no sistema operacional Windows, entre outras ações.
Pacote de Instalação
Pacote de instalação é composto por dois artefatos: Artefato | Detalhamento |
---|
linx-tesouraria-installer-4.0.0.jar | Responsável por realizar a instalação ou atualização da Tesouraria.
| linx-tesouraria-web.war | Responsável para realizar o deploy (módulo WEB) no servidor de aplicação Wildfly.
Aviso |
---|
Mesmo que seja desejado usar apenas o módulo WEB, a execução do instalador (item acima) é mandatório, pois o mesmo executa configurações necessárias nas variáveis de ambiente do servidor. |
|
Manual de instalação
Abaixo está detalhado o passo a passo a ser executado para proceder com instalação da versão 4.0 da Tesouraria. Na seção abaixo estão detalhados os passos necessários e, adicionalmente, foram adicionadas imagens das telas do Instalador para cada passo da execução. Passo 1 - Executando Instalador e Processadores (opcional)
Expandir |
---|
title | Clique para detalhar passo 1 da instalação: Instalador e Processadores |
---|
|
Para iniciar o processo de instalação, deve-se abrir um terminal como ADMINISTRADOR no servidor e digitar na linha de comando: "java -jar linx-tesouraria-installer-4.0.0.jar" (vide imagem ao lodo) ou clicar 2 vezes no arquivo. |
| Na sequencia, página de boas vindas do instalador será exibida. Aqui é possível confirmar a versão que será instalada. Para seguir, basta clicar em “Próximo”. | | Passo para selecionar tipo da instalação.
- Atualização da tesouraria -> Caso essa opção seja selecionada, o instalador irá buscar pela variável de ambiente “LINX_TESOURARIA”. Caso não exista, o instalador irá entender que não existe nenhuma tesouraria instalada no sistema. Ao seguir com esta opção, o usuário será direcionado para a página de pacotes de instalação onde só será possível seguir para o fim da instalação. Desta forma, com esta opção, não é possível alterar nenhuma configuração definida durante a instalação anterior.
- Nova instalação da tesouraria -> Caso esta opção seja selecionada, o instalador procura se já existe outra instalação da tesouraria, da mesma forma citada acima. Caso encontre, uma mensagem de confirmação será exibida ao usuário. Caso o usuário decida seguir, passará por todas as páginas de configuração da tesouraria, e o instalador irá sobrescrever qualquer configuração já existente no ambiente.
| | Passo para definir diretório de instalação da aplicação. Por default, instalador sugere instalação na unidade raiz do windows e no diretório /linx-tesouraria, porém fica facultativo a modificação dessa localização.
Aviso |
---|
Neste passo deve-se atentar para que seja escolhido um diretório cujo usuário tenha permissões de escrita. |
| | Passo para definições gerais do serviços da Tesouraria
Neste momento, o usuário deverá selecionar quais os serviços que devem ser instalados pelo instalador: processador de notas e processadores de tesouraria. Caso seja selecionado opção para instalação do(s) processador(es) da tesouraria, usuário deve informar quantos processadores serão instalados e qual o ID (identificador único) de cada um deles.
Aviso |
---|
Caso esteja executando este instalador apenas para ter a configuração básica para a tesouraria web, basta deixar selecionado “não” para os dois tipos de processadores e seguir com a instalação. |
Aviso |
---|
IMPORTANTE: Este passo não altera configurações de instancias de processadores já instalados! Ao seguir com esse processo, os serviços já instalados serão removidos e novos serviços serão instalados com a configuração escolhida. |
| | Passo para definir acesso a base de dados
Neste passo, devem ser informadas as configurações de acesso a base de dados corporativo: URL de acesso, usuário e senha. Exemplo: jdbc:oracle:thin:@<IP_BANCO>:<PORTA>:<SID> | | Passo para definir pacotes de instalação opcionais
Neste passo será possível ao usuário selecionar os pacotes da instalação que serão utilizados. No momento, existe apenas um único pacote obrigatório, portanto, basta clicar em “Próximo” e seguir para o próximo passo. | | Passo para acompanhamento da instalação
Após a conclusão deste passo, todos os dados necessários para o instalador já foram coletados e todos os arquivos já estão prontos para serem tratados. Basta aguardar conclusão do processo e clicar no botão “Próximo”. Adicionalmente, neste passo, todos os scripts de instalação são executados e a tesouraria é devidamente instalada. Caso ocorra algum erro, uma mensagem será exibida ao usuário. Após terminar este processo corretamente, o botão “Próximo” será habilitado e o usuário poderá seguir para o próximo passo. |
![](/download/attachments/330419990/image2022-7-29_11-41-50.png?version=1&modificationDate=1661180258892&api=v2)
| Passo para conclusão do processo de instalação/atualização. | |
|
Expandir |
---|
title | Clique para detalhar passo 2 da instalação: Realizando deploy da Tesouraria |
---|
|
Aviso |
---|
IMPORTANTE: Para execução deste passo é mandatório a execução do passo 1, mesmo que o objetivo seja utilizar somente o módulo WEB. O instalador cria as configurações básicas necessárias tanto para os serviços quanto para a tesouraria web. |
| Para iniciar o processo de instalação, deve-se abrir um terminal como ADMINISTRADOR no servidor e digitar na linha de comando: "java -jar linx-tesouraria-installer-4.0.0.jar" (vide imagem ao lodo) ou clicar 2 vezes no arquivo. | Para iniciar o processo, usuário deve ter acesso ao console administrativo do Servidor de aplicação do Wildfly (conforme imagem ao lado). Na sequencia, deve selecionar opção "Deployments"
| | ⦁ Clicar em “add”. ⦁ Deixar selecionado a opção "upload a new deployment" e clicar em Next. | | ⦁ Clicar em “Escolher ficheiro”. ⦁ Selecionar o arquivo “linx-tesouraria-web.war”. ⦁ Clicar em “Next”. | | | | ⦁ Aguardar o deployment ser concluído no servidor. | |
|
|