Agentes Jitterbit

Visão geral

Os agentes Harmony da Jitterbit processam as operações dos seus projetos de integração e enviam e recebem dados de endpoint. Existem dois tipos de agentes, nuvem e privado:

• Nuvem: Jitterbit gerencia agentes de nuvem em sua própria infraestrutura de nuvem. Você não precisa configurar nada.

• Privado: Você deve configurar, configurar e gerenciar agentes privados em sua própria nuvem ou infraestrutura física.

Todos os agentes são membros de um grupo. Grupos de Agente são grupos de agentes do mesmo tipo. Agentes dentro de um grupo de agentes compartilham o trabalho de processamento an Integration Studio ou Design Studio operações do projeto. Qual grupo de agentes e qual tipo de agentes um projeto usa depende de qual ambiente o projeto é implantado.

A tabela a seguir compara os dois tipos de agente:

Agentes de nuvem

Agentes de nuvem são serviços de nuvem gerenciados pelo Jitterbit. Eles são configurados para se adaptarem automaticamente para corresponder às cargas de trabalho do seu projeto. Você não precisa instalar, configurar, atualizar, iniciar ou parar agentes de nuvem.

Grupos de agentes de nuvem

Os grupos de agentes de nuvem são grupos de agentes de nuvem executando a mesma versão. Eles estão incluídos em todas as assinaturas do Harmony. O Jitterbit fornece dois grupos de agentes de nuvem para cada região:

• Grupo de Agentes em Nuvem para Produção: Um grupo de agentes na versão lançada atualmente, totalmente testados e prontos para produção.

• Grupo de Agentes em Nuvem Sandbox: Um grupo de agentes na próxima versão proposta atualmente, adequada para avaliação e teste.

Os grupos de agentes de nuvem não precisam de configuração ou gerenciamento. Ao contrário de agentes privados, os agentes de nuvem individuais não são visíveis no Management Console.

Agentes privados

Ao contrário dos agentes de nuvem, que são gerenciados pelo Jitterbit, você deve instalar e configurar agentes privados (no Windows, Linux) ou Docker hosts que satisfazem os requisitos do sistema) e gerencie agentes e grupos usando o Management Console > Agentes página.

Grupos de agentes privados

Antes de poder instalar e executar um agente privado, você precisa de pelo menos um grupo de agentes privados. (Grupos de agentes privados são uma adição licenciável à sua assinatura Harmony .) Nenhum grupo de agentes privados é fornecido por padrão. Você deve criá-los e atribuí-los a ambientes. Um grupo de agentes privados deve ter pelo menos um agente privado nele, e um agente pode estar em apenas um grupo por vez.

Quando há dois ou mais agentes em um grupo, os agentes se revezam no processamento de cadeias de operação inteiras, incluindo filhos. Isso tem as seguintes consequências:

• Não há como prever em qual agente uma cadeia de operação será executada. Projetos com endpoints que exigem acesso a arquivos locais devem ser executados em um ambiente em que todos os agentes do grupo tenham acesso a um sistema de arquivos comum ou unidade compartilhada.

• A carga de trabalho média de hosts de agentes individuais pode variar significativamente.

• Se um agente falhar, as operações podem travar e os dados podem ser perdidos.

Para conectores suportados e um número mínimo de agentes ativos, você pode habilitar o serviço de escuta para agentes em um grupo. O serviço de escuta permite que os agentes sejam suportados Integration Studio conectores escutam eventos de API. Ele também nomeia um dos agentes como líder. O agente líder distribui tarefas de operação para agentes de acordo com seu status e carga. Se um agente travar, os dados podem ser recuperados.

Cronograma de lançamento e notas de lançamento

O cronograma de lançamento para agentes varia dependendo do tipo de agente:

• Os grupos de agentes de nuvem são atualizados automaticamente na atualização do Grupo de Agentes em Nuvem Sandbox e atualização do Grupo de Agentes em Nuvem para Produção agendamentos.

• Instaladores de agentes privados atualizados ficam disponíveis em Downloads na conclusão do lançamento do Grupo de Agentes em Nuvem para Produção.

• A imagem do Docker do agente privado fica disponível em Docker Hub na conclusão do lançamento do Grupo de Agentes em Nuvem para Produção da região da América do Norte (NA).

Nas Notas de lançamento do Harmony, cada tipo de agente é incluído como um item de linha separado na tabela de datas de lançamento no topo de cada página de notas de lançamento. As notas de lançamento individuais são listadas sob o título Agentes, com qualquer aplicabilidade relevante a certos tipos de agentes incluída nas notas de lançamento.

Compilações de notas de versão para Grupos de agentes em nuvem de produção, Grupos de agentes em nuvem, e agentes privados também estão disponíveis.

Problemas conhecidos

Esta seção lista problemas conhecidos que foram identificados com versões recentes de agentes privados. Para problemas conhecidos que foram identificados com outros aplicativos Jitterbit 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 de um 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 Integration Studio).

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

  • Resumo: Ao escrever para SFTP como um alvo usando o Design Studio ou Integration 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 Integration 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 do Microsoft Azure Service Bus

  • Resumo: Ao usar o conector Microsoft Azure Service Bus 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 Integration Studio conectores construídos com o Integration Studio SDK do conector.

  • 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 Integration Studio O conector Cherwell não funciona

  • Resumo: A partir do lançamento do Harmony 10.1, uma alteração feita no conector Cherwell em Integration Studio significa que 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.