Manual do Instalador PIMSConnector em Linux

 12.1.19 (Janeiro/2018)

Sumário

1. Contexto de negócio (Introdução)

2. Pré-requisitos instalação/implantação/utilização

3. Instalador

3.1. Instalação

3.2. Atualização

3.4. Configuração

3.4. Desinstalação

3.5. Iniciando o PIMSConnector

4. Overview do JBoss

4.1. Diretório server

4.2. Diretório pimsconnectorconfig

4.3. Diretório deploy

4.4. Diretório apl

4.5. Diretório conf

5. Configurações adicionais do JBoss

5.1. Verbosidade de Logs

Âncora
_Toc_Contexto _Toc_Contexto

...

Image Added

Este manual tem como objetivo capacitar clientes, usuários e demais profissionais que manipulam ou que de alguma forma estão envolvidos com a manutenção do PIMSConnector a realizarem instalações e atualizações dos ambientes de execução relacionados ao PIMS. Com esse Manual os profissionais terão plenas condições de aplicarem os procedimentos nos ambientes configurados para o PIMSConnector.

Âncora
_Toc_PreRequisito _Toc_PreRequisito

Pré-requisitos instalação/implantação/utilização

Sistema Operacional

O aplicativo PIMSConnector é desenvolvido na plataforma Java EE e pode ser instalado em qualquer sistema operacional que suporte a execução de aplicações Java.
Linux (distribuições como RedHat, CentOS e Fedora, mas não se limitando a estas, desde que em suas versões Server), preferencialmente 64 bits *.

...

• Servidor Pentium Core 2 Duo ou Dual Core (mínimo de 2 cpus) 64 bits,
• 4 GB de RAM *disponíveis ***
• 10 GB de HD disponíveis

Pastas & Permissões (Configurações para rotina de instalação)

• Criar um usuário jboss.
  
  
• Criar a pasta TotvsAgro no Diretório opt/ dando direitos de acesso ao usuário jboss.
  
  
  
  

...

:OUTPUT ACCEPT [587:587] ( Porta de saída para envio de e-mail).
-A INPUT -m - - state NEW -m tcp -p - - dport 8080 -j ACCEPT (Porta de entrada para conexão com o servidor = http://IP:8080/PIMSConnector)  

Âncora
_Toc_Instalador _Toc_Instalador

Instalador

Descompactar o arquivo "PIMSConnector-Instalador- VERSAO -linux.zip" na pasta /home/jboss

...

Escolha o idioma para prosseguir.

Âncora
_Toc_Instalacao _Toc_Instalacao

Instalação

Image Added

Selecione Instalação clique Próximo.

...

Onde será executado o PIMSConnector, está compreendido entre 8080 à 9980.

Módulo de Integração

 É o módulo do PIMS que o PIMSConnector irá realizar as integrações, nesta versão compreende apenas o PIMSMulticultivos.

Fuso Horário

Determina um fuso específico para o servidor de aplicação do PIMSConnector, ou seja, o sistema operacional pode trabalhar com um fuso e o servidor de aplicação com outro fuso horário.

...

Tela Principal do PIMSConnector

Âncora
_Toc_Atualizacao _Toc_Atualizacao

Atualização

Image Added

Selecione Atualização clique Próximo.

...

Configurações

Image Added

Selecione Configurações clique Próximo.

...

Porta em que rodará o serviço do PIMSConnector, após clicar no botão "Próximo" será feito uma verificação se a porta selecionada não está sendo utilizada por outro serviço, retornando a seguinte tela de erro quando a mesma estiver em uso:

Image Modified

Seleciona o Fuso Horário:  

...

Caso não ocorra nenhum erro, a configuração será finalizada com sucesso.

Image Modified

Ao final da configuração será iniciado o serviço do PIMSConnector e será carregado no navegador.

...

Desinstalação

Image Added

Selecione Desinstalação clique Próximo.

Image Modified

Selecione o diretório onde será realizada a Desinstalação. Como padrão traz "/opt/TotvsAgro/PIMSConnector", porém pode ser informado outro caminho. Em seguida escolha a instância.

...

Será exibido o resumo das configurações de instalação. O Instalador realizará a parada do PIMSConnector, antes de iniciar o processo de desinstalação.

Image Modified
Caso exista alguma movimentação registrada será necessário informar usuário/senha.

...

Caso não ocorra nenhum erro, a desinstalação será finalizada com sucesso.

Âncora
_Toc_IniciandoPIMSConnector _Toc_IniciandoPIMSConnector

Iniciando o PIMSConnector

1. Iniciar servidor Jboss navegar até a pasta bin do jboss (diretório de instalação + jboss-6.1.0.pimsconnector/bin)
   
   
   
   Executar o seguinte comando: ./runHMG.sh start  
   No nosso exemplo está instalado a instância HMG, se fosse PRD o comando seria  ./runPRD.sh start , ou seja o termo é composto ./runAmbiente.sh start .
   
   
   
   
2. Aguardar alguns minutos e informar na  na URL do navegador o endereço: http://ip_servidor:porta/PIMSConnector
   
   
   
   Informar usuário e senha de acesso ao PIMSConnector. Na instalação o usuário padrão é admin e a senha é a configurada no wizard de configuração.
   
   

Migração

O processo de migração irá auxiliar no transporte das informações presente no H2 Database para o PostgreSQL, esse processo irá migrar as configurações e mensagens (Não Processadas no período de 30 dias ). 

Selecione Migração clique Próximo.

Image Added

Selecione o diretório onde será realizada a Migração. Como padrão traz "/opt/TotvsAgro/PIMSConnector", porém pode ser informado outro caminho. Em seguida escolha a instância.

Image Added

Será exibido o resumo das configurações referente ao processo de Migração.

Image Added

Será exibido as recomendações para o processo de Migração.

Image Added

Tela para informar usuário e senha do PIMSConnector para dar prosseguimento na operação de Migração. O usuário deve estar parametrizado como "ADMIN" . 

Image Added

Será exibido o resumo das tabelas que serão migradas no processo de Migração.

Image Added

Informar os dados para conexão com o banco de Dados PostgreSQL

Image Added

Ao clicar no botão Próximo, abrirá uma tela de confirmação de atualização

Image Added

Ao final o processo de Migração, será apresentada o resultado de execução das operações.

Image Added

Caso não ocorra nenhum erro, a Migração será finalizada com sucesso.

Image Added

Âncora
_Toc_OverviewJboss _Toc_OverviewJboss

Overview do JBoss

Esta é uma rápida introdução ao servidor de aplicações JBoss, abordando os pontos que são importantes para o contexto do PIMSConnector. 
Ao observar o conteúdo do diretório de instalação do JBoss, podemos observar os seguintes subdiretórios. Vamos explorar alguns deles.

...

• Server: Cada subdiretório desta pasta forma uma configuração distinta do JBoss AS, isto é, um conjunto de Serviços Bean e seus diretórios de trabalho.

Âncora
_Toc_DiretorioServer _Toc_DiretorioServer

Diretório server

O PIMSConnector é executado por padrão na configuração server\HMG ou server\PRD. Caso a instalação seja feita de forma manual, os ambientes poderão ter nomes diferentes dos citados acima. 
Dentro das configurações temos os seguintes diretórios:

...

Se for necessário guardar os logs para qualquer análise posterior, faça um backup do diretório log antes de eliminá-lo. 
Na rotina de atualização realizada pelo Instalador, as pastas tmp, work, log e data são apagadas.

Âncora
_Toc_DiretorioPimsConnectorConfig _Toc_DiretorioPimsConnectorConfig

Diretório pimsconnectorconfig

Diretório com arquivos de configuração do PIMSConnector:

PimsConnectorBridge.properties: arquivo de configuração de portas e parâmetros do módulo principal. 
mssql_mapings.xml: arquivo de mapeamento de comandos SQL entre Oracle e SQLSERVER.

Âncora
_Toc_DiretorioDeploy _Toc_DiretorioDeploy

Diretório deploy

Neste diretório temos arquivos de configuração dos DataSources.

PimsConnector-ds.xml: configuração do datasource do PIMSConnector

Com criptografia de senha:

Sem criptografia de senha:
Image Modified
 

PimsMulticultura-ds.xml: configuração do datasource do PIMSMulticultivos

SQLServer com criptografia de senha:

...

Diretório apl

Diretório onde ficam os arquivos que executam as integrações e o núcleo do PIMSConnector

Âncora
_Toc_DiretorioConf _Toc_DiretorioConf

Diretório conf

Login-config.xml: arquivo de configuração dos mecanismos de autenticação no servidor de aplicação. Este arquivo será útil quando houver a necessidade de se utilizar credenciais criptografadas em arquivos de datasource.

...

Configurações adicionais do JBoss

Âncora
_Toc_VerbosidadeLogs _Toc_VerbosidadeLogs

Verbosidade de Logs

O JBoss AS 6 possui um arquivo de configurações para o nível de verbosidade dos logs gerados. Explicando de forma resumida, existem os níveis de log DEBUG, INFO, WARN E ERROR, sendo DEBUG o de menor criticidade (usado em modo de desenvolvimento e homologação) e ERROR o de maior criticidade.
Quanto menor a criticidade utilizada na configuração, maior é a quantidade de log gerado, aumentando assim a quantidade de utilização de disco. Para ambientes de produção, é adequado configurar os níveis de log para WARN. Isto pode ser feito no arquivo JBOSS_HOME\server\HMG\deploy\jboss-logging.xml (onde JBOSS_HOME é o diretório de instalação do servidor). Neste arquivo há várias categorias configuradas, como a que é apresentada abaixo:

...