Manual do Instalador PIMSConnector em Linux
12.1.13 (Setembro/2016)
Sumário
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.
...
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.
...
Anchor |
---|
| _Toc_Configuracao |
---|
| _Toc_Configuracao |
---|
|
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.
...
Anchor |
---|
| _Toc_Desinstalacao |
---|
| _Toc_Desinstalacao |
---|
|
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
- 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 .
- 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:
...
Anchor |
---|
| _Toc_DiretorioApl |
---|
| _Toc_DiretorioApl |
---|
|
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.
...
Anchor |
---|
| _Toc_DiretorioConfigAdicionais |
---|
| _Toc_DiretorioConfigAdicionais |
---|
|
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:
...