- Criado por Edmo Sergio Ribeiro Bezerra em ago 21, 2022
Você está vendo a versão antiga da página. Ver a versão atual.
Comparar com o atual Ver Histórico da Página
Versão 1 Próxima »
Conceitos Gerais
Este documento detalha o processo de instalação e configuração da versão 4.0 da Tesouraria que traz como principal evolução e benefício a execução no Servidor de Aplicação Wildfly.
Dessa forma, em conjunto com a evolução do Portal Big Retail, o servidor web Tomcat pode ser desconsiderado como parte do ambiente produtivo dos clientes.
Abaixo, mais algumas características e benefícios da nova versão:
Descrição | Em termos práticos.... |
---|---|
Aplicação passa a ser dividida em dois entregáveis: módulo PROCESSADOR e módulo WEB que podem ser instalados e executados de forma independente. | Instalação da nova versão para clientes que possuem versões legadas (3.0 ou inferiores) pode ser feita de forma modular e incremental. Ou seja, as versões legadas e 4.0 podem permanecer em operação simultaneamente. |
Tesouraria passa a ser executada de forma totalmente apartada apartada do Storex-EP. | Por não depender mais do tomcat (versão 5.5.2) integrada ao Storex, nova versão pode ser instalada em servidor independente do Storex. |
Pré-requisitos
Antes da leitura do documento, necessário o entendimento dos requisitos mandatórios para instalação e execução da versão da Tesouraria.
Propriedade | Detalhamento | Versão mínima |
---|---|---|
Sistema operacional | Windows | Windows Server 2016 ou superior. |
Aplicação | Java | Versão 8 instalada no ambiente e, devidamente, configurada na variável de ambiente PATH do servidor windows. |
Aplicação Linx | Portal Big Retail | Verão 3.16.0 ou superior devidamente configurada. |
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. 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)
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.
| |
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. 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. 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. 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. | |
Passo para conclusão do processo de instalação/atualização. |
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. |
Configurando Tesouraria 4.0 no Portal Big Retail
Abaixo está detalhado o passo a passo para que seja configurado o apontamento no Portal Big Retail para módulo web da versão 4.0 da Tesouraria. Esta ação tem objetivo que as funcionalidade do menu "Tesouraria" do Portal reflitam as telas da nova versão que está sendo executada no servidor Wildfly.
⦁ Acessar o Servidor de Configuração onde o Portal Big Retail está configurado ⦁ Clicar em Manutenção/Parâmetros/Aplicação ⦁ Selecionar opção PORTAL-BIG-RETAIL no Tipo de aplicação e pesquisar. | |
⦁ Buscar pelo parâmetro “URL da Tesouraria”. ⦁ Alterar o valor do parâmetro, conforme imagem ao lado. ⦁ Ex.: http://<IP do wildfly da tesouraria>:<Porta wildfly da tesouraria>/Tesouraria ⦁ Fazer o envio dos parâmetros para a aplicação. |
- Sem rótulos