(Antigo) Instalação - TOTVS Agro PIMS Server - Linux

1. VISÃO GERAL

Nesta página será explicado o processo de instalação do TOTVS Agro PIMS Server baseado em ambiente Linux.

Para seguir com esse processo, será estritamente necessário ter um ambiente com os requisitos mínimos preparado e o pacote de instalação, podendo ser verificado no Requisitos Recomendados - TOTVS Agro PIMS Server.

2. INSTALAÇÃO

Inicialmente, já com o ambiente preparado e o pacote TOTVS Agro PIMS Server disponível:

Devemos descompactar o pacote.

Com o pacote já descompactado, será apresentado a estrutura abaixo:

• • configurar_ambiente.sh: Aplicação auxiliar para preparar o ambiente que será instalado.
  • iniciar_instalacao.sh: Aplicação auxiliar de instalação.
  • instalador.jar: JAR que comtempla o TOTVS Agro PIMS Server.
  • instrucoes.txt: Instruções importantes para instalação e atualização.
  • jdk: JDK utilizado para instalação do TOTVS Agro PIMS Server.

Antes de iniciar a instalação, devemos abrir o terminal e executar os comandos a seguir:

• • Como usuário root, navegue até a pasta descompactada e execute o comando abaixo para tornar os arquivos configurar_ambiente.sh e iniciar_instalacao.sh executáveis:

    chmod +x ./configurar_ambiente.sh
    chmod +x ./iniciar_instalacao.sh

    Atenção

    O configurar_ambiente.sh deve ser executado apenas 1 vez por diretório.

• • Como usuário root, execute o arquivo configurar_ambiente.sh, informando qual usuário Linux deverá ser criado e utilizado na instalação e configuração do servidor de aplicação, bem como qual diretório o servidor de aplicação será instalado. Exemplo de execução do arquivo sh:

    ./configurar_ambiente.sh nomedousuario /opt/diretorio-de-instalacao

  • Como usuário root, execute o arquivo iniciar_instalacao.sh para abrir o instalador:

    ./iniciar_instalacao.sh

  • Caso o usuário root não tenha permissão para executar aplicações gráficas e não consiga iniciar o instalador, é recomendado executar o seguinte comando, como usuário não administrador: 

    xhost +si:localuser:root

  • Caso exista uma falha na execução do jar do instalador, é recomendado verificar se a biblioteca libjpeg62 está instalada no sistema. Em ambientes baseados em Debian, é possível instala-la através do comando:

    apt-get install libjpeg62

    Boas práticas durante a instalação:

    • Utilizar portas 8000+ (ex: 8080, 8081, 8091 ...).
    • Utilizar o nome do serviço sem espaços e caracteres especiais.
    • Instalar o PIMS Server em um diretório sem espaços ou caracteres especiais. No Linux, instalar preferencialmente em um diretório dentro da pasta /opt/TotvsAgro

Depois, abrirá o instalador do PIMS Server:

Vamos clicar em "Selecionar Diretório", escolher a pasta criada e "Prosseguir".

Após, concordando com os termos, aperte em prosseguir.

Nessa etapa, podemos escolher dois tipo de instalação:

• • INSTALAÇÃO COMPLETA: A Instalação completa, vai contemplar todos os módulos disponível dentro do instalador.

    • Para realizar a instalação completa, será necessário selecionar todos os módulos disponíveis, "Confirmar a seleção de módulos" e "Prosseguir".
    • 
•  
•  

  • INSTALAÇÃO POR MÓDULO(S): A Instalação por módulo(s), vai contemplar apenas os módulo(s) que forem selecionados durante a instalação.

    • Para realizar a instalação por módulos, será necessário selecionar os módulos que deseja, "Confirmar a seleção de módulos" e "Prosseguir".
    • 

Logo após irá exibir os requisitos mínimos para utilização do PIMS Server, se os requisitos forem atendidos, basta "Prosseguir".

Nessa etapa, será necessário preencher as informações do TomEE (servidor de aplicação) de acordo com o seu local.

• • No campo "Informe o nome do serviço", não utilize espaços nem caracteres especiais.
  • No campo "Informe o IP", será necessário informar o IP da máquina que está sendo realizado a instalação.
  • No campo "Informe a porta", o instalador verifica se a porta estará em uso, após clicar no botão de validação.
  • No campo "Informe o usuário do Linux", deve-se colocar o usuário que foi criado ao executar script configurar_ambiente.sh no começo do manual.

Após preenchimento dos campos, basta clicar em "Validar e gravar informações" e "Prosseguir".

Agora iremos configurar a memória da JVM e podemos seguir 2 possibilidade:

• • CONFIGURAÇÕES RECOMENDADAS: Após descer a tela do instalador, clicamos no botão "Utilizar configurações recomendadas", "Validar e gravar informações" e "Prosseguir".
    • 

• • CONFIGURAÇÕES MANUAIS: Alterar os campos manualmente, de acordo com o que deseja, descer a tela e clicar em "Validar e gravar informações" e "Prosseguir".  
    • 

Logo após iremos preencher as configurações de JMS.

• • • Preencher os campos de acordo com o seu ambiente:
    • transactionSupport: Especifica se a conexão está inscrita em valores permitidos de transação global: xa, local ou none.
    • poolMaxSize: Número máximo de conexão física com o broker ActiveMQ.
    • poolMinSize: Número mínimo de conexão física com o broker ActiveMQ.
    • connectionMaxWaitTime: Quantidade máxima de tempo que uma conexão pode ficar ociosa antes de ser recuperada.
    • connectionMaxWaitTime:  Tempo máximo de espera por uma conexão.
    • Porta: Especificar a porta de configuração da JMS.
    • IP do Servidor: Inserir o IP do Servidor, o mesmo que foi inserido no TomEE (servidor de aplicação).

• • 
  • Após preencher os campos basta "Validar e Gravar Informações" e "Prosseguir".

Agora, iremos preencher a configuração do datasource (banco de dados).

• Preencher os campos de acordo com o seu banco de dados, descer a tela e clicar em "Testar Conexão", "Validar e Gravar Informações" e "Prosseguir".
• 
  
  

• Observação

  Caso prossiga com as informações vazias, será necessário configurar o datasource manualmente no arquivo no caminho: tomee\conf\tomee.xml

Nessa etapa, iremos preencher a configuração de login.

• • Ver quais opções se adequam a sua instalação, "Validar e gravar informações" e "Prosseguir".
  • 

  • Importante

    Caso seja escolhido a opção: LDAP (Active Directory) é de extrema importância que siga a Configuração do LDAP, após realizar a instalação.

Nessa etapa, iremos preencher a configuração de email.

• • Selecionar se deseja configurar os envios de e-mail (Servidor de Aplicação), caso seja sim, marque a opção, preencha as informações dos campos, "Validar e Gravar Informações" e "Prosseguir".
  • 

Nessa etapa, iremos preencher a configuração de logs.

• • Você pode configurar o nível de logs dos aplicativos da maneira que deseja, assim como no exemplo abaixo, logo após basta "Validar e Gravar Informações" e "Prosseguir"

• • 

    Lembrete

    Se aumentar a quantidade máxima de arquivos e tamanhos (MB), verificar a capacidade do disco para armazenamento.

Nessa etapa, iremos ver a confirmações de dados.

• • Basicamente, está é uma tela de resumo dos valores preenchidos durante a instalação. Confirme que todos os dados estão de acordo e "Prosseguir"
  • 

Nessa etapa, iremos ver a Iniciar a instalação.

• • Basta clicar no botão "Iniciar processo de instalação/atualização".
  • 

Por fim, a instalação do PIMS Server foi concluída.

Para acessar a aplicação, podemos seguir o manual de Simulação do Acesso abaixo:

Simulação do Acesso - TOTVS Agro PIMS SERVER

3. CONFIGURAÇÃO DO LDAP

Para inicializarmos a configuração do LDAP, devemos parar o serviço do PIMS Server.

 Com o serviço do PIMS Server parado, devemos navegar até a pasta que foi realizado a instalação do PIMS Server e entrar na pasta /tomee/conf:

• Caminho Padrão

  /opt/TotvsAgro/pimsserver/tomee/conf

Logo após iremos criar um novo arquivo de texto e renomear para ldap.properties:

• Terminal

  touch ldap.properties

Após realizar a criação do arquivo, vamos abrir ele com um editor de texto, e colocar as seguintes informações:

• ldap.properties

  ldap.url= 
  ldap.baseDN= 
  ldap.authentication= 
  ldap.timeout= 
  ldap.server= 
  ldap.sufixDomainName= 
  ldap.concatUIDwithDOMAIN= 
  ldap.attribute.uid= 
  ldap.attribute.cn= 
  ldap.attribute.givenName= 
  ldap.attribute.sn= 
  ldap.attribute.mail= 
  ldap.attribute.memberOf=

Logo após ele ficará da maneira abaixo, que será necessário preencher todas as informações de acordo com o seu servidor LDAP e salvar o arquivo.

Agora, teremos a seguinte estrutura dentro da pasta conf:

Para entrar no sistema do PIMSWeb via LDAP, basta inicializar o serviço do PIMS Server e seguir o manual:

Simulação do Acesso - TOTVS Agro PIMS SERVER