Manual de instalação: Integrador Portal ConexãoNF-e no Linux

Veja os requisitos e como instalar o Integrador do Portal ConexãoNF-e no Linux.

Requisitos

  • Linux com Java 8 instalado;
  • Suporte a System V ou Systemd para configurar o integrador como serviço no Linux;
  • Conectividade com a internet recomendada de 2 mbits ou superior, para comunicação com a solução na nuvem;
  • Firewall/Proxy liberados para a url de integração: https://api.conexaonfe.com.br (porta 443).

ID de integração

No início da instalação será solicitado o ID de integração, que pode ser consultado no portal em Administrar > Usuários.

Esse ID é gerado automaticamente para o Administrador (usuário que criou a conta no cloud), e está disponível na página de detalhes do Usuário, campo ID de integração. Conforme abaixo:

Menu de usuário, onde encontra o ID de integração no Portal ConexãoNF-e.

Com o ID de integração em mãos, inicie a instalação através do executável que foi baixado.

Instalação dos integradores

  • Já no servidor Linux, execute o comando abaixo para baixar o executável:
wget https://s3-sa-east-1.amazonaws.com/conexaonfe-public/agentes/cxnf-integrador-v6-install.sh
  • Adicione a permissão de execução no arquivo baixado:
sudo chmod +x cxnf-integrador-v6-install.sh
  • Execute o instalador passando como parâmetro o ID de Integração citado acima:
sudo sh cxnf-integrador-v6-install.sh <ID DE INTEGRAÇÃO>

Exemplo:

sudo sh cxnf-integrador-v6-install.sh 12341234123412341234123412341234

O serviço será descompactado no diretório /opt/conexaonfe/integrador.

  • Adicione a permissão de execução no arquivo que será configurado como serviço:
find /opt/conexaonfe/integrador/ -name integrador-*.jar -exec sudo chmod +x {} \;

Configurar para rodar como serviço do Linux

É possível configurar como System V (comando service) ou Systemd (comando systemctl), conforme a compatilidade da sua distribuição.

System V (service)

  • Crie um link simbólico para iniciar o serviço via System V:
find /opt/conexaonfe/integrador/ -name integrador-*.jar -exec sudo ln -s {} /etc/init.d/conexaonfe-integrador \;
  • Comandos para gerenciar o serviço:

Iniciar:

sudo service conexaonfe-integrador start

Parar:

sudo service conexaonfe-integrador stop

Verificar Status:

sudo service conexaonfe-integrador status

Para configurar o serviço para iniciar com a inicialização do Linux com System V:

sudo update-rc.d conexaonfe-integrador defaults <priority>

Caso System V não seja suportado, utilize o Systemd.

Systemd (systemctl)

O Systemd utiliza o comando systemctl para gerenciar o serviço.

  • Crie o arquivo abaixo conforme a versão instalada:

/etc/systemd/system/conexaonfe-integrador.service

[Unit] 
Description=conexaonfe-integrador
After=syslog.target

[Service]
User=root
ExecStart=/opt/conexaonfe/integrador/integrador-6.0.3.jar
SuccessExitStatus=143

[Install]
WantedBy=multi-user.target
  • Comandos para gerenciar o serviço:

Iniciar:

sudo systemctl start conexaonfe-integrador.service

Parar:

sudo systemctl stop conexaonfe-integrador.service

Verificar Status:

sudo systemctl status conexaonfe-integrador.service

Para configurar o serviço para iniciar junto com a inicialização do Linux com Systemd:

sudo systemctl enable conexaonfe-integrador.service

Caso apresente algum erro no processo, mande um print no chat no portal.

Agora é só iniciar o serviço.

Configuração das pastas no portal

Caso os serviços estejam rodando, com o ID de Integração correto e sem nenhum bloqueio de firewall, você já pode iniciar a parametrização das pastas diretamente no portal:

Parametrizações das pastas

Caso o servidor ainda não aparece no portal para parametrização, verifique os pontos abaixo.

Verificar possíveis erros na execução

Caso os serviços não subam, podemos testar a execução manual na pasta /opt/conexaonfe/integrador:

./integrador-6.0.3.jar

Assim você pode acompanhar o log de execução direto na saída do console. Essas informações podem ser solicitadas no chat de suporte para resolução de problemas relacionados aos integradores.

Para a execução acima utilize CTRL + C.

Consultar logs de execução

Para acompanhar o log de execução, os arquivos ficam dentro da pasta abaixo:

 /opt/conexaonfe/integrador/logs

Removendo o serviço

  • Pare o serviço conforme já citamos acima.

  • Remova o link simbólico que encontrar:

sudo rm /etc/init.d/conexao-integrador
  • Remova a pasta /opt/conexaonfe
rm -R /opt/conexaonfe