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

« Anterior Versão 4 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çãoEm 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. 

PropriedadeDetalhamentoVersão mínima
Sistema operacional

Windows

Windows Server 2016 ou superior.

AplicaçãoJavaVersão 8 instalada no ambiente e, devidamente, configurada na variável de ambiente PATH do servidor windows.
Aplicação LinxPortal 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:

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


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


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”.
  •  Clicar em “Finish”

⦁    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