Manual do Instalador PIMSConnector em Linux

 12.1.13 (Setembro/2016)

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

Anchor
_Toc_Contexto _Toc_Contexto

Contexto de negócio (Introdução)

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.

Anchor
_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)  

Anchor
_Toc_Instalador _Toc_Instalador

Instalador

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

...

Escolha o idioma para prosseguir.

Anchor
_Toc_Instalacao _Toc_Instalacao

Instalação

Selecione Instalação clique Próximo.

Image RemovedImage Added

Selecione o diretório onde será realizada a instalação. Como padrão traz "opt/TotvsAgro/PIMSConnector", porém pode ser informado outro caminho para instalação desde que haja as permissões de leitura e escrita.

...

Exibe a execução das operações realizadas.

Image RemovedImage Added

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

...

Tela Principal do PIMSConnector

Anchor
_Toc_Atualizacao _Toc_Atualizacao

Atualização

Selecione Atualização clique Próximo.Image Removed

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

...

Observação: Caso o serviço do Jboss, não esteja no padrão utilizado pelo PIMSConnector, o instalador irá padronizar o nome do Serviço.

Image RemovedImage Added

Exibe as operações que serão executadas na atualização.

...

Ao final do processo de atualização será apresentada a tela com o resultado de execução das operações.

Image AddedImage Removed

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

...

Configurações

Selecione Configurações clique Próximo.

Image Removed

 Image Added

Selecione o diretório onde será realizada a Configuraçã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 configuração.

Image RemovedImage Added

Abrirá uma tela para informar usuário e senha para prosseguir com a configuração. O usuário deverá ser do tipo "ADMIN".

...

Traz o IP configurado para o servidor de aplicativo (Jboss). Após clicar em "Próximo" será verificado se o IP informado existe, se não existir será retornada o a tela de erro abaixo

Porta do Jboss:

...

Tela com informações das operações realizadas.

Image RemovedImage Added

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

...

Desinstalação

Selecione Desinstalação clique Próximo.

Image Added

 Image Removed

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 RemovedImage Added

Caso já 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.

Anchor
_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.
   
   

Anchor
_Toc_OverviewJboss _Toc_OverviewJboss

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

Anchor
_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.

Anchor
_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.

Anchor
_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

Anchor
_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

Anchor
_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:

...