Problemas Conhecidos do Agente Privado¶

Introdução¶

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

Múltiplas Versões de Agentes Privados¶

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

A instalação do Windows Agente Privado 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 a inicialização de um aplicativo não reconhecido.
- Solução alternativa: Na caixa de diálogo da 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 falhará se o TFA estiver ativo.
- Informações Adicionais: O instalador exibe uma caixa de diálogo de erro.
- Solução alternativa: Desative temporariamente o TFA e instale o Windows Agente Privado de 64 bits. Após a instalação, habilite o TFA.
Conexões ODBC não lidam com 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 tratados corretamente por operações que fazem upsert de 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 do banco de dados (veja instruções para Design Studio ou Cloud Studio).
Diretórios SFTP às vezes não são criados automaticamente
- Resumo: Ao gravar em SFTP como destino usando Design Studio ou 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 Cloud Studio.
- Informações Adicionais: Se usado, o script pode ou não gerar um erro. Mesmo que o script não gere erro, a função não funcionará corretamente. Como a função não funciona, será usada a manipulação de sessão integrada do conector Salesforce.
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 detalhes.
A instalação do Agente falha devido à senha do PostgreSQL incluindo um sinal de mais (+)
- Resumo: A instalação do Agente Privado falhará se a senha do PostgreSQL contiver um sinal de mais (+). Não há nenhuma 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 for concluída, a senha poderá ser alterada para qualquer senha aceitável para uso com PostgreSQL.

10.84 / 11.22 e Agentes Privados Anteriores¶

Programação de uma vez por dia ignorada durante a mudança de horário de verão
- Resumo: Ao usar o agente versão 10.84/11.22 ou anterior, e o agente estiver usando um fuso horário que observe o horário de verão, estes problemas conhecidos ocorrem durante uma mudança 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 do agente 10.85/11.23 ou posterior ou defina o fuso horário do agente para UTC usando a Substituir fuso horário do Agente de agendamento política da organização e selecionando Etc/UTC.

10.45 e Agentes Privados Anteriores¶

Vulnerabilidades JNDI do Apache Log4j2 afetam Agentes Privados
- Resumo: Vulnerabilidades do Apache Log4j2 CVE-2021-44228 e CVE-2021-45046 afetam Agentes Privados que usam conectores Cloud Studio criados com o SDK do Harmony Connector.
- Mitigação: Uma manutenção emergencial resolveu 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 entrasse em vigor. Para obter informações e instruções detalhadas, consulte Mitigando a vulnerabilidade JNDI do Apache Log4j2.

10.38 Agentes Privados Linux¶

O banco de dados PostgreSQL é reinicializado ao atualizar da versão 10.37 para 10.38
- Antecedentes: Ao atualizar um Agente Privado Linux de uma versão anterior à 10.37 para uma versão 10.37 ou posterior, o banco de dados PostgreSQL será reinicializado à medida que 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 o 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 Agente Privado. 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 Cloud Studio Cherwell não funciona
- Resumo: A partir do 10.1 Harmony Release, 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 agentes 10.1 ou superior.

9.8 Agentes Privados¶

Plugins não estão sendo executados
- Resumo: Um problema com a falha na execução dos plug-ins fez com que o download do Agente Privado 9.8 fosse interrompido logo após o lançamento.
- Solução alternativa: Se você ainda tiver um Agente Privado 9.8, atualize para uma versão mais recente.