1. VISÃO GERAL

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

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 a pacote já descompactado, será apresentado a estrutura abaixo:

• • jdk_win: JDK utilizado para instalação do TOTVS Agro PIMS Server
  • iniciar-instalacao.bat: 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.

Antes de iniciar a instalação, devemos realizar a criação da pasta onde vai ficar localizado o TOTVS Agro PIMS Server.

C:\TotvsAgro

Com o caminho selecionado, vamos criar a pasta pimsserver.

Não é recomendado utilizar espaços e caracteres especiais na criação da pasta.

Agora podemos iniciar o processo de instalação.

Abra o Prompt de Comando (CMD) como Administrador.

Passe o caminho onde está localizado a pasta descomprimido do instalador PIMS Server.

cd C:\12.1.2209_WIN_PIMS_SERVER

`

Após, inicie o bat: iniciar-instalacao.bat:

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

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

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

    • 

      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"

• • 

    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:

• C:\TotvsAgro\pimsserveer\tomee\conf

Logo após iremos criar um novo arquivo de texto e renomear para 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.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