Solução de problemas do agente privado Jitterbit

Introdução

Esta página fornece conselhos para solução de problemas para vários problemas que podem ser encontrados ao executar um agente privado. Entre em contato com suporte Jitterbit para problemas não listados aqui.

O agente privado Jitterbit não está em execução ou está parado ou inacessível

A mensagem de erro "Agente não em execução ou inacessível" pode ser causada por estes fatores:

• Você está usando uma versão mais antiga do agente.

  • Solução: Atualize para a versão mais recente do agente.

• Os serviços Jitterbit não estão em execução.

  • Solução: Os serviços podem ser iniciados em %windir%\system32\services.msc; OU

  

  

  • Solução: No diretório de instalação, você encontrará um script StartServices.bat que iniciará os serviços relevantes; OU

  

  • Solução: No Windows, você encontrará uma opção para Iniciar Serviços Jitterbit no Menu Iniciar.

  

  • Normalmente, se um serviço não estiver iniciando, você encontrará um erro durante a reinicialização.

    • Para Windows: Procure um erro em C:\Program Files (x86)\Jitterbit Agent\log. Certifique-se de que eles estejam sendo executados como Sistema Local e verifique o Log de Eventos para ver se há alguma mensagem de erro.

    • Para Linux: Procure um erro em /opt/jitterbit/log.

    Nota

    Substitua USERNAME pelo seu nome de usuário atual.

    Permissões: A conta na qual os Serviços Jitterbit estão sendo executados precisa ser de Administrador Local no computador e ter Acesso Total à pasta Jitterbit.

• Os serviços estão em execução, mas não conseguem se comunicar com o Jitterbit Cloud.

  • Solução: Verifique:

    • Se a Internet estiver funcionando.

    • O arquivo de log, para ver se há uma mensagem de erro óbvia:

      • Para Windows: C:\Program Files (x86)\Jitterbit Agent\log\jitterbit-agent.log.

      • Para Linux: /opt/jitterbit/log/jitterbit-agent.log.

• Problemas de proxy também podem causar a mensagem de erro Agente Not Running ou Unreachable. Solucionar isso é um pouco mais difícil, pois há muitas configurações de rede diferentes.

  • Solução: Durante a instalação, você pode ter que marcar ou desmarcar o Negotiate Ntlm Proxy. Isso depende de qual proxy você tem. Também é muito útil ver o Denied Log do Proxy Server.

Agente privado Jitterbit mostrando diferentes versões ou IPs

Emitir

Os Agentes no Management Console pode exibir diferentes versões e/ou IPs para um agente privado. Após reiniciar os serviços do agente, a página Agents pode exibir inicialmente a versão/IP "correta" e então reverter para alternar continuamente para frente e para trás.

Causa do problema

O servidor do agente provavelmente foi clonado. O servidor clonado está sendo executado em paralelo e colide com o servidor do agente principal. Você não pode executar vários servidores sob as mesmas credenciais do agente.

Etapas para diagnosticar e resolver problemas e resolver

1. Desligue a máquina do servidor principal que executa a versão oficial, aguarde 10 minutos e atualize a página Agentes do Management Console. Se o status do agente mudou de parado para em execução, isso significa que há outra instância do agente em execução. Os agentes estão trabalhando alternadamente ou simultaneamente.

2. Para resolver o problema, será necessário encontrar a instância em execução na versão antiga e desligar o servidor.

3. Se não conseguir fazer isso, desinstale o agente oficial, crie um novo agente com um nome diferente e instale-o no servidor oficial.

4. Verifique se o novo agente está em execução, conforme listado na página Agentes no Management Console.

5. Exclua o agente antigo da página Agentes usando o menu suspenso Ação > Remover.

Erros de conexão, websocket e E/S em agentes privados Jitterbit usando VMs do Azure

Visão geral

Esta página fornece instruções sobre como solucionar problemas de um agente privado Linux ou Windows . instalado em uma máquina virtual (VM) do Microsoft Azure. (Consulte Ajuste de desempenho do agente privado para informações gerais sobre ajuste de desempenho.)

Solucionar problemas de conexões perdidas

Ao usar um agente privado instalado em uma VM do Microsoft Azure, você pode ter conexões perdidas. O Azure define o tempo limite de inatividade do WebSocket para 4 minutos, enquanto o padrão do agente privado para ping Harmony é definido para 5 minutos. Para resolver esse problema, reduza o intervalo para o heartbeat do agente:

1. Abra o jitterbit-agent-config.properties arquivo em um editor de texto. Este arquivo pode ser encontrado nestes diretórios:

   • Linux: <JITTERBIT_HOME>/Resources/

   • Windows: C:\Program Files\Jitterbit Agent\Resources

2. Encontre o agent.heart.beat.interval configuração:

   #Agent heart beat interval (IN MINUTES)
   agent.heart.beat.interval=5
   

3. Altere a configuração para agent.heart.beat.interval=3.

4. Salve as alterações e reinicie o agente.

Solucionar problemas de websocket e erros de E/S

Erros relacionados a WebSocket e E/S podem ser resolvidos com atualizações nas configurações de tempo limite de inatividade de IP associado à VM, tempo limite de inatividade de TCP do gateway de tradução de endereço de rede (NAT) e tempo limite de fluxo de rede virtual (VNET).

Os valores de tempo limite de inatividade de IP, tempo limite de inatividade de TCP do gateway NAT e tempo limite de fluxo de VNET devem ser definidos como 15 minutos.

Identificar erros relevantes

Erros de WebSocket e E/S podem ser identificados referenciando os logs de operação e o jitterbit-agent.log arquivo. Este arquivo de log pode ser encontrado em um dos seguintes locais:

• Para Windows: C:\Program Files (x86)\Jitterbit Agent\log\jitterbit-agent.log.

• Para Linux: /opt/jitterbit/log/jitterbit-agent.log.

Erros de log de operação

Se presente, qualquer uma das seguintes mensagens nos detalhes do log de operação para uma operação com status Erro pode ser indicativa de um erro de WebSocket ou de E/S:

The operation "Example Operation" completed successfully.

No message found while removing message in cache for: Message Info: AgentId: 000001 AgentGroupId: 000001 MessageId: XXX Message Version (Agent): XXXX Message Version (Harmony): XXX Counter (Harmony): 1 Submitted Timestamp (Harmony):2024-01-20 11:55:00.700, message will be retried later OperationInstanceGUID: XXX

Run message could not reach the agent.

Erros no arquivo de log do Agente

Se presente, qualquer uma das seguintes mensagens no jitterbit-agent.log arquivo pode ser indicativo de um erro de WebSocket ou de E/S:

2024-01-20 12:00:00 request handler thread #10642  INFO org.jitterbit.integration.server.api.util.AgentRetryExecutor:53 - Agent Message Receipt (OperationInstanceGUID: XXX) failed. Retrying....
2024-01-20 12:00:00 request handler thread #10642 ERROR org.jitterbit.integration.server.api.util.AgentRetryExecutor:55 - org.springframework.web.client.ResourceAccessException: I/O error on PUT request for "https://na-east.jitterbit.com/jitterbit-cloud-restful-service/agent/ackmsgreceipt": Read timed out; nested exception is java.net.SocketTimeoutException: Read timed out

E:2024-01-20 12:00:00 request handler thread #884 ERROR org.jitterbit.integration.server.messaging.agent.listener.AgentMessageListener:231 - No message found while removing message in cache for: Message Info: AgentId: 000001 AgentGroupId: 000001 MessageId: XXX Message Version (Agent): XXXX Message Version (Harmony): XXX Counter (Harmony): 1 Submitted Timestamp (Harmony):2024-01-20 11:55:00.700, message will be retried later OperationInstanceGUID: XXX

Drenar o agente de parada

Parada de drenagem o agente antes de atualizar quaisquer configurações de tempo limite. Se você tiver mais de um agente no grupo de agentes afetado, faça o mesmo para todos eles.

Isolar recursos do agente

É recomendável que a VM do agente e seus recursos associados sejam separados em seu próprio grupo de recursos no Azure. Isso inclui sua VNET, IP, gateway NAT, interface de rede (NIC) e grupo de segurança de rede (NSG), se presente.

Atualizar o tempo limite de inatividade do IP

1. No portal do Azure, navegue até o grupo de recursos associado à VM do agente.

2. Identifique e clique no item IP associado à VM:

   

3. Clique em Configuração e altere o valor Tempo limite de inatividade (minutos) para 15 minutos:

   

Atualizar o tempo limite de inatividade do TCP do gateway NAT

1. No portal do Azure, navegue até o grupo de recursos associado à VM do agente.

2. Identifique e clique no item NAT gateway associado à VM e ao IP, se presente. Um gateway NAT associado também será listado na Visão geral do item IP ao lado do campo Associado a.

3. Clique em Configuração e altere o valor Tempo limite de inatividade do TCP (minutos) para 15 minutos.

Atualizar o tempo limite do fluxo da VNET

1. No portal do Azure, navegue até o grupo de recursos associado à VM do agente.

2. Identifique e clique no item VNET associado à VM:

   

3. Em Visão geral, clique em Configurar ao lado de Tempo limite de fluxo:

   

4. No painel Tempo limite de fluxo, ative a configuração Ativar tempo limite de fluxo e altere o valor Tempo limite de fluxo (minutos) para 15 minutos:

   

5. Clique em Salvar.

Reinicie o agente

1. No portal do Azure, reinicie a VM do agente.

2. Reinicie o agente parado. Veja Reiniciar um agente do Windows ou Reiniciar um agente Linux para informações detalhadas.

Erro 1722 com agentes privados do Windows Jitterbit

Emitir

A instalação do agente privado do Windows falha com esta mensagem de erro:

Error 1722. There is a problem with this Windows Installer package. A program run as part of the setup did not finish as expected. Contact your support personnel or package vendor. ...

Causa e resolução do problema

Há vários motivos pelos quais a instalação do agente privado pode falhar com essa mensagem de erro. Dois dos motivos mais comuns são um conflito com o Microsoft Visual C++ Redistributable ou ter caracteres não permitidos na senha do PostgreSQL.

Microsoft Visual C++ Redistribuível

Um conflito com uma versão existente do Microsoft Visual C++ Redistributable pode causar o Erro 1722.

Agentes privados exigem Microsoft Visual C++ Redistributable para Visual Studio 2015, 2017, 2019 a ser instalado antes de instalar um agente privado. A Microsoft inclui os mesmos arquivos redistribuíveis para o Visual Studio C++ 2015, 2017 e 2019. Instale a versão de 64 bits do Windows usando vc_redist.x64.exe.

Caracteres de senha do PostgreSQL não permitidos

Uma senha do PostgreSQL que usa caracteres não permitidos pode causar o erro 1722.

Para resolver esse problema, não use um sinal de mais (+) como parte da senha do PostgreSQL ao instalar um agente privado. O número mínimo de caracteres para uma senha do PostgreSQL é oito (8). Recomendamos que você não use caracteres acentuados (como é) ou qualquer um destes caracteres na senha do PostgreSQL: + @ $ % & [] {} (), ; ? ^ = £.

Problema de IPv6 em agentes privados do Windows Jitterbit

Visão geral

Alguns clientes tiveram problemas quando o Protocolo de Internet versão 6 (IPv6) foi habilitado. Nesses casos, recomendamos desabilitar o IPv6 e o IP Helper.

Desabilitar IPv6

Para desabilitar o IPv6:

1. No Windows, abra Painel de Controle > Rede e Internet > Conexões de Rede.

2. Abra as Propriedades de uma conexão.

3. Desmarque a caixa de seleção Protocolo de Internet versão 6 (TCP/IPv6):

   

Desabilitar o auxiliar de IP

Para desabilitar o IP Helper:

1. No Windows, abra Serviços.

2. Localize IP Helper na lista de serviços. Em seguida, clique com o botão direito do mouse em IP Helper e selecione Propriedades.

3. Em Propriedades do Auxiliar de IP, clique em Parar para interromper o serviço e altere o Tipo de inicialização para Desativado:

   

Erro do Apache Server em agentes privados Jitterbit

Se você receber esta mensagem de erro:

No Installed ConfigArgs for the Service "Jitterbit Apache Server"

Isso significa que o usuário sob o qual o servidor Jitterbit Apache está sendo executado não tem acesso total à pasta Jitterbit.

Erros do PostgreSQL com agentes privados do Windows Jitterbit

Emitir

Em certos casos, após desinstalar um agente privado do Windows e tentar reinstalar o agente, os usuários podem receber um erro relacionado ao banco de dados PostgreSQL.

Causa do problema

Esse erro é conhecido por ocorrer em sistemas onde a instalação do PostgreSQL associada ao agente privado não foi completamente removida.

Resolução

Para resolver o erro, os usuários devem seguir as etapas descritas em Desinstalar um agente privado do Windows para remover completamente a conta de usuário do Jitterbit PostgreSQL.

Depois que isso for feito, você deve conseguir concluir uma nova instalação do agente. Se você ainda estiver tendo problemas, entre em contato com o suporte.

Não é possível instalar agentes privados Jitterbit do Windows de 64 bits com autenticação de dois fatores (TFA)

Emitir

É um problema conhecido que agentes privados do Windows de 64 bits não podem ser instalados com autenticação de dois fatores (TFA) habilitada. Se o TFA estiver ativo, a instalação de um agente privado do Windows de 64 bits falhará e apresentará uma caixa de diálogo de erro.

Solução alternativa

Para contornar esse problema, desabilite temporariamente o TFA e instale o agente privado do Windows de 64 bits. Após a instalação, habilite o TFA.

O TFA pode ser desabilitado e habilitado nas configurações da organização acessado a partir do Management Console Organizações página.

Erro de slots de conexão com agentes privados Jitterbit do Windows de 64 bits

Emitir

Esse erro é conhecido por ocorrer com agentes privados do Windows de 64 bits instalados antes do lançamento do Harmony 10.14:

Failed to connect to back-end database "TranDb"
FATAL: remaining connection slots are reserved for non-replication superuser
connections
(0) SQL Error! SQLSTATE = 53300 Native err = 210 msg = FATAL: remaining connection slots are reserved for non-replication superuser connections
(1) SQL Error! SQLSTATE = IM006 Native err = 0 msg = [Microsoft][Gerenciador de Driver ODBC] Driver's SQLSetConnectAttr failed
Details:
Unable to connect to database using connection string:
UID=jitterbit;PWD=<REMOVED>;SERVER=127.0.0.1;DRIVER={PostgreSQL ODBC
Driver(UNICODE)};DATABASE=TranDb;Port=6543;!

Resolução

Para resolver esse problema, aumente o max_connections e checkpoint_timeout configurações no postgresql.conf arquivo no agente privado do Windows de 64 bits seguindo estas etapas:

1. Faça uma cópia de segurança do seu postgresql.conf arquivo e salve-o em outro local. Este arquivo pode ser encontrado no C:\Program Files\PostgreSQL\9.x\data diretório.

2. Abra o postgresql.conf arquivo em um editor de texto.

3. Encontre o max_connections configuração.

   # - Connection Settings -
   
   listen_addresses = '*'      # what IP address(es) to listen on;
                       # comma-separated list of addresses;
                       # defaults to 'localhost'; use '*' for all
                       # (change requires restart)
   port = 6543             # (change requires restart)
   max_connections = 100           # (change requires restart)
   #superuser_reserved_connections = 3 # (change requires restart)
   #unix_socket_directories = ''   # comma-separated list of directories
   

4. Altere esta configuração para max_connections = 400.

5. Encontre o checkpoint_timeout configuração.

   # - Checkpoints -
   
   #checkpoint_timeout = 5min      # range 30s-1d
   #max_wal_size = 1GB
   #min_wal_size = 80MB
   

6. Altere esta configuração para checkpoint_timeout = 1h e exclua o marcador de comentário (#) o começo da linha.

7. Salve suas alterações e reinicie o agente.

Recuperar uma instalação de agente privado com falha no Windows

Emitir

A instalação ou atualização de um agente privado no Windows falha.

Resolução

Devido ao número de causas possíveis, a solução mais simples é desinstalar completamente) então reinstale o software do agente privado se qualquer parte do processo de instalação ou atualização falhar.