Skip to main content

Manual | Como realizar a instalação do Agente Integral

Contextualização.

O agente integral é responsável pelo envio das informações do Integral para o Novo Avanço através de arquivos jsons. Essa comunicação facilita a integração com outros sistemas e também a correção de notas fiscais através da interface gráfica do portal, além de realizar as funções ja presentes no carga relacionadas as nota fiscais (envio, cancelamento, inutilização...)
      
       Atualmente os arquivos enviados na integração JSON são:
    Convênios:
    https://api.novoqas.avancoinfo.net/docs/public/#/Convenio
    Produtos:
    https://api.novoqas.avancoinfo.net/docs/public/#/Produto/ProdutoPublicoController_cadastraOuAtualizaProduto
    Produto Composto(Produção):
    https://api.novoqas.avancoinfo.net/docs/public/#/ProdutoComposto
    Promoções:
    https://api.novoqas.avancoinfo.net/docs/public/#/Promocao

     

    Requisitos para instalação.

      Servidor do cliente ser 64 bits.
      Cliente utiizar novo tramitador.
      Servidor possuir sqlite3 instalado.
      Servidor possuir jq instalado.
      Servidor possuir redis-server instalado.

      Obs: 
      Comando para verificar versão do servidor:
      "uname -m".

      Comando para verificar se programas estão instalados:
      sqlite3 --version
      jq --version
      redis-server --version

      Caso seja instalado o redis-server no cliente, após a instalação é necessário executar os seguintes comandos para inicializar as filas:
      redis-cli
      FLUSHALL



      Executando a instalação e configuração do Agente Integral no servidor.


      ATENÇÃO!
      Os processos abaixo deverão ser realizados com o usuário avanco.

      1 - Realizar download do script de instalação

      link para download direto: 
      https://s3.amazonaws.com/avancoprogramas/outros/instalador-agente-integral.rar

      2 - Copiar arquivo .rar baixado para alguma pasta (Qualquer pasta com permissão) do servidor do cliente:

      image.png



      3 - Extrair arquivo no servidor do cliente:

      image.png

      4 - Desativar execução da bat do pm2
      ATENÇÃO!
      O processo de desativar a execução da bat do pm2 deverá ser realizado somente se o cliente não possuir nenhum serviço além do carga executando no pm2. 


      Comando para verificar processos executados no pm2 atualmente:

      image.png

      Caso o mesmo possua alguma serviço além do carga, pule para o passo 4.1.

      image.png

      Insira um # na linha responsável pela execução da bat e salve o arquivo pressionando ctrt + o e posteriormente saia com ctrl + x

      image.png



      4.1 - Desativar separadamente o serviço do carga (Somente para clientes que executam algum serviço além do carga no pm2)

      abrir o arquivo /u/node_apps/pm2.json e comentar a configuração de execução do carga, mantendo somente os demais serviços:

      image.png

      image.png

      Após comentar o serviço pela execução do carga, salvar o arquivo com ctrl + o e depois sair com ctrl + x

      5 - Reiniciar o cron

      comandos: 
      UTILIZAR USUÁRIO ROOT
      killall cron
      cron -l notice

      ou 

      killall crond
      crond -l notice

      image.png




      5 - Executar script de instalação (Baixado no passo Nº1)

      image.png


      Pressionar enter na pergunta abaixo:

      image.png

      Pressionar seta para baixo e posteriormente a tecla espaço para selecionar a opção "erp"

      image.png

      image.png

      Pressionar enter para prosseguir para a próxima opção.
      Na tela abaixo, pressionar enter novamente:

      image.png

      Manter o ambiente production selecionado e pressionar a tecla enter:

      image.png

      informar e-mail e senha utilizados no portal do Novo Avanço e pressionar enter no campo cnpj.

      image.png


      Após realizar o processo acima, o agente-integral já estará instalado e configurado no cliente.
      Para acessar o container e visualizar os logs, siga o processo abaixo:



      1 - Visualizar id do container no docker:

      Utilizar o comando:
      docker ps

      image.png



      2 - Acessar o container:

      Utilize o comando:
      docker exec -it "id_container" bash
      Obs: Não há necessidade de digitar todo o id, digitando somente 4 caracteres ele já será reconhecido.

      image.png

      image.png