Ir para o conteúdo

Problemas Conhecidos do Agente Privado

Introdução

Esta página documenta problemas conhecidos que foram identificados com versões recentes de agentes privados. Para problemas conhecidos que foram identificados com outros aplicativos Harmony, consulte Problemas conhecidos.

Várias Versões de Agentes Privados

Agentes Privados Linux 11.31.1 e Todas as Versões Anteriores

  • As operações agendadas falham ao serem executadas após a reinicialização do agente privado do Linux

    • Resumo: Após reiniciar um agente privado Linux, o agente Scheduler o serviço falha ao iniciar, fazendo com que as operações agendadas não sejam executadas conforme o esperado. Esse problema não ocorre com agentes privados do Windows.

    • Informações adicionais: O agente Linux Scheduler o serviço usa uma biblioteca que baixa os arquivos de dados de fuso horário mais recentes. Em 4 de setembro de 2024, o provedor desta biblioteca introduziu um erro de sintaxe que faz com que o Scheduler serviço não inicia.

    • Recomendação: Este problema foi resolvido com a versão 11.31.2, que não baixa mais automaticamente a biblioteca que causa o problema. Recomendamos atualizar os agentes privados do Linux para 11.31.2 ou posterior para evitar que esse problema ocorra e, nos casos em que já esteja ocorrendo, para se recuperar dele.

      Como alternativa, se estiver usando uma versão anterior do agente, você pode aplicar as seguintes etapas de solução alternativa ou recuperação a agentes não Docker:

      • Solução alternativa: Se um agente privado Linux ainda não tiver sido reiniciado, para evitar que esse problema ocorra, edite o version arquivar em /opt/jitterbit/TimeZoneDB/version e altere seu valor para 2024b. Isso impedirá que a versão da biblioteca de datas com o problema seja baixada pelo agente.

      • Recuperação: Se um agente privado Linux já estiver enfrentando esse problema, para corrigi-lo, edite o northamerica arquivar em /opt/jitterbit/TimeZoneDB/northamerica para substituir o valor April com Apr em qualquer ocorrência. Em seguida, reinicie o agente.

Todas as Versões Recentes

Esses problemas se aplicam a todas as versões recentes:

  • A instalação do agente privado do Windows mostra um aviso do Microsoft Defender SmartScreen

    • Resumo: Ao instalar um agente privado 10.69 ou posterior (para agentes 10.x) ou 11.8 ou posterior (para agentes 11.x) no Windows 2019 ou Windows 10, uma mensagem de aviso pode aparecer.

    • Informações adicionais: A mensagem de aviso diz "O Windows protegeu seu PC" com uma observação de que o Microsoft Defender SmartScreen impediu que um aplicativo não reconhecido fosse iniciado.

    • Solução alternativa: Na caixa de diálogo de mensagem de aviso, clique em Mais informações para mostrar a opção Executar mesmo assim. Em seguida, clique em Executar mesmo assim para prosseguir com a instalação do agente.

  • Agentes privados do Windows : Não é possível instalar o agente de 64 bits com autenticação de dois fatores (TFA)

    • Resumo: A instalação de um agente privado do Windows de 64 bits falha se o TFA estiver ativo.

    • Informações adicionais: O instalador exibe uma caixa de diálogo de erro.

    • Solução alternativa: Desabilite temporariamente o TFA e instale o agente privado do Windows de 64 bits. Após a instalação, habilite o TFA.

  • As conexões ODBC não manipulam caracteres estendidos corretamente

    • Resumo: Ao conectar-se a um banco de dados usando um driver ODBC, alguns caracteres estendidos, como um travessão, não são manipulados corretamente por operações que inserem dados.

    • Informações adicionais: As operações de Upsert podem falhar ou ter sucesso com consequências não intencionais ao afetar os dados errados. Observe que as operações Insert e Update não são afetadas por esse problema.

    • Solução alternativa: Use um driver JDBC para a conexão com o banco de dados (consulte as instruções para Design Studio ou Cloud Studio).

  • Às vezes, os diretórios SFTP não são criados automaticamente

    • Resumo: Ao gravar no SFTP como um destino usando o Design Studio ou o Cloud Studio, a criação automática de diretórios funciona de forma inconsistente.

    • Informações adicionais: Dependendo do servidor FTP específico envolvido, o diretório pode não ser criado.

    • Solução alternativa: Confirme se o diretório foi criado antes do uso em produção.

  • SetSalesforceSession função não funciona

    • Resumo: A função Jitterbit Script SetSalesforceSession não funciona corretamente e não deve ser usado no Design Studio ou no Cloud Studio.

    • Informações adicionais: Se usado, o script pode ou não gerar um erro. Mesmo que o script não gere um erro, a função não funcionará corretamente. Como a função não funciona, o tratamento de sessão integrado do conector Salesforce será usado.

  • Agentes privados têm requisitos de sistema específicos e problemas conhecidos

    • Resumo: Os agentes privados têm requisitos de sistema e problemas conhecidos diferentes e específicos, dependendo do sistema operacional usado.

    • Solução alternativa: Consulte os Requisitos do sistema para agentes privados para mais detalhes.

  • A instalação do Agente falha devido à senha do PostgreSQL incluir um sinal de mais (+)

    • Resumo: A instalação do agente privado falha se a senha do PostgreSQL contiver um sinal de mais (+). Não há mensagem de erro exibida.

    • Informações adicionais: Este é um problema com o instalador do agente privado, não com o PostgreSQL.

    • Solução alternativa: Use uma senha sem sinal de mais (+). Quando a instalação estiver concluída, a senha poderá ser alterada para qualquer senha aceitável para uso com o PostgreSQL.

11.26 Agentes Privados

  • O VerifyJwtClaims funções claims parâmetro não assume o valor correto quando deixado em branco

    • Resumo: Ao usar a versão 11.26 do agente, deixar o opcional claims parâmetro vazio com o VerifyJwtClaims A função Jitterbit Script gerará um erro.

    • Solução alternativa: Atualize para a versão 11.27 ou posterior do agente ou insira "{}" para claims. Por exemplo, VerifyJwtClaims("AxE9qm4aTZiXvA2G8sblAxjeL...", "RS256", "Secret", "{}");.

10.87 / 11.25 e Agentes Privados Anteriores

  • Entradas de log excessivas para o conector Microsoft Azure ESB

    • Resumo: Ao usar o conector Microsoft Azure ESB com a versão do agente 10.87 / 11.25 ou anterior, um número excessivo de INFO os logs são gerados em um curto período de tempo, levando a problemas de espaço em disco devido ao tamanho do catalina.out arquivo.

    • Solução alternativa: É recomendável atualizar para a versão 11.26 ou posterior do agente. Como alternativa, esse problema pode ser resolvido na versão 10.87 / 11.25 ou anterior do agente adicionando as seguintes configurações ao logback.xml arquivo localizado em C:\Program Files\Jitterbit Agent\tomcat\shared\lib (Windows) ou /opt/jitterbit/tomcat/shared/lib (Linux):

      <logger name="com.azure.core.amqp" level="ERROR"/>
<logger name="com.azure.messaging.servicebus" level="ERROR"/>
<logger name="com.azure.core.implementation" level="ERROR"/>

10.84 / 11.22 e Agentes Privados Anteriores

  • Programação diária ignorada durante a mudança do horário de verão

    • Resumo: Ao usar a versão 10.84/11.22 ou anterior do agente, e o agente estiver usando um fuso horário que observa o horário de verão, estes problemas conhecidos ocorrem durante uma troca de horário de verão:

      • Quando uma programação diária é definida entre 1h e 2h, a operação programada não será executada no primeiro domingo de novembro devido ao horário de verão.

      • Quando uma programação diária é definida entre 2h e 3h, a operação programada não será executada no segundo domingo de março devido ao horário de verão.

    • Solução alternativa: Atualize para a versão 10.85/11.23 ou posterior do agente ou defina o fuso horário do agente como UTC usando a Substituir fuso horário do Agente programado política da organização e selecionando Etc/UTC.

10.45 e Agentes Privados Anteriores

  • Vulnerabilidades do Apache Log4j2 JNDI afetam agentes privados

    • Resumo: Vulnerabilidades do Apache Log4j2 CVE-2021-44228 e CVE-2021-45046 afetam agentes privados que usam conectores do Cloud Studio criados com o Harmony Connector SDK.

    • Mitigação: Uma manutenção de emergência abordou as vulnerabilidades. Após a manutenção, os agentes privados precisaram ser reiniciados e uma operação executada para cada conector afetado para que a atualização se tornasse efetiva. Para obter informações e instruções detalhadas, consulte Mitigar a vulnerabilidade Apache Log4j2 JNDI.

10.38 Agentes Privados Linux

  • O banco de dados PostgreSQL é reinicializado ao atualizar da versão 10.37 para 10.38

    • Histórico: Ao atualizar um agente privado Linux de uma versão pré-10.37 para uma versão 10.37 ou posterior, o banco de dados PostgreSQL será reinicializado conforme for atualizado para a versão 9.6. Esta atualização recriará o banco de dados em seu agente privado e seus dados serão recuperados durante este processo de atualização. Após a atualização, quaisquer backups criados usando uma versão anterior do PostgreSQL não serão compatíveis. O processo de atualização pode levar mais de 30 minutos, dependendo do número de projetos e do tamanho dos ambientes associados ao seu grupo de agentes privados. Quaisquer trabalhos pendentes serão colocados em uma fila pendente para serem executados após a conclusão da atualização. Esta atualização não envolve o agente privado do Windows.

    • Problema Conhecido: É um problema conhecido que, ao atualizar um agente privado Linux da versão 10.37 para 10.38, o banco de dados PostgreSQL é reinicializado.

    • Solução alternativa: Atualize para um agente privado Linux versão 10.39 ou posterior.

10.0 Agentes Privados

  • O conector Cherwell do Cloud Studio não funciona

    • Resumo: A partir do lançamento do Harmony 10.1, uma alteração feita no conector Cherwell no Cloud Studio significa que ele não é mais compatível com agentes 10.0.

    • Solução alternativa: Se estiver usando o conector Cherwell, atualize para os agentes 10.1 ou superior.

9.8 Agentes Privados

  • Plugins não estão sendo executados

    • Resumo: Um problema com plugins falhando na execução resultou na retirada do download do agente privado 9.8 logo após o lançamento.

    • Solução alternativa: Se você ainda tiver um agente privado 9.8, atualize para uma versão posterior.