Requisitos de Sistema para Agentes Privados

Introdução

Esses requisitos de sistema se aplicam aos agentes privados Harmony. Esses requisitos também são abordados nos guias de instalação para agentes privados no Linux e Windows sistemas.

Considerações e Práticas Recomendadas do Sistema Operacional

Antes da instalação, revise Alta disponibilidade e balanceamento de cargas dos grupos de Agente e essas considerações e melhores práticas do sistema operacional.

Considerações Sobre o Sistema Operacional

Ao decidir se deve instalar um agente privado em um Linux ou Windows sistema operacional, revise estas considerações:

• Versão: Todos os agentes privados em um grupo de agentes específico devem ser instalados em máquinas que usam o mesmo sistema operacional e a mesma versão do sistema operacional.

• APIs: Agentes Linux podem aceitar uma carga de API maior (mais solicitações por minuto) do que agentes Windows em máquinas idênticas ao usar APIs configuradas por meio do API Manager.

• Bancos de dados: A autenticação do Windows com o Microsoft SQL Server é suportada apenas em agentes privados do Windows.

• Compartilhamentos de arquivos: Bloco de mensagens do servidor versão 2 (SMBv2) usando o conector de compartilhamento de arquivos para Cloud Studio ou Design Studio é suportado apenas em agentes privados do Windows.

• Microsoft Dynamics: Os conectores do Microsoft Dynamics (como o conector do Microsoft Dynamics CRM para o Cloud Studio e o Microsoft Dynamics AX, CRM e conectores GP para Design Studio) requerem agentes privados do Windows.

Melhores Práticas

Recomendamos seguir estas práticas recomendadas:

• Sistemas suportados: Instale o agente privado em um sistema testado e suportado, conforme listado nesta página. Para resultados ideais, recomendamos que você siga estes pré-requisitos e requisitos para o sistema operacional, banco de dados PostgreSQL e hardware.

• Alta disponibilidade e balanceamento de cargas: Antes da instalação, revise as recomendações para alta disponibilidade (ativo/ativo) e balanceamento de cargas, conforme descrito em Grupos de Agente de alta disponibilidade e balanceamento de cargas.

• Instalação do servidor: Para ambientes de produção, recomendamos instalar o agente privado em um servidor. A instalação do Agente em uma máquina desktop é recomendada apenas para ambientes de desenvolvimento, controle de qualidade ou teste.

• Instalação limpa: Não instale o agente privado em um servidor que já esteja executando outro banco de dados. O agente instala e executa seu próprio banco de dados PostgreSQL. Executar o agente em um servidor que já esteja executando um banco de dados Oracle ou SQL Server pode causar problemas de desempenho.

• Mesmo fuso horário: Recomendamos que todos os agentes em um grupo de agentes privados tenham o mesmo fuso horário. Como o fuso horário dos agendamentos configurados depende do fuso horário do agente privado, as execuções de agendamento podem ser imprevisíveis se os fusos horários forem diferentes.

• Permissões de conta: Recomendamos usar uma conta de superusuário do Linux ou de administrador local do Windows para instalar o agente. Não é recomendado usar uma conta de usuário local.

• Desinstalação: Antes de desinstalar, recomendamos que você copie os arquivos de configuração e os certificados de segurança da sua instalação atual, caso queira reinstalar com a mesma configuração posteriormente.

Requisitos do Sistema Operacional

O Jitterbit exige que os sistemas operacionais usados pelos agentes privados do Harmony atendam a estas especificações:

Linux

A versão Linux do agente privado Harmony requer um SO de 64 bits. Estas são as distribuições suportadas derivadas do Debian Linux e do Red Hat Enterprise Linux para hardware Intel:

• Ubuntu 20.04 LTS

• Ubuntu 22.04 LTS

• Red Hat Enterprise Linux 8

• Amazon Linux AMI 2

O agente privado Harmony não foi certificado em relação a outras distribuições semelhantes com Debian ou distribuições de pacotes RPM derivadas das distribuições Debian e Red Hat. Amazon Linux fornece várias versões do Linux, das quais apenas Amazon Linux AMI 2 foi certificado.

Windows

A versão Windows do agente privado Harmony requer um sistema operacional de 64 bits e é compatível com estas versões:

• Windows 10

• Windows 11

• Windows Server 2019

• Windows Server 2022

Requisitos de Software Pré-requisitos

Versão Java Necessária

O pacote do agente privado Harmony é fornecido com uma versão de 64 bits do Java 8 Runtime Environment (JRE) e não requer um Java tempo de execução separado. O Jitterbit instala automaticamente o Java Runtime Environment necessário especificamente para o Jitterbit usar, para que ele não entre em conflito com outras instalações Java que já possam estar instaladas. A partir do Harmony 9.8, a versão do Java enviada com o agente é o AdoptOpenJDK JRE. Este JRE é licenciado conforme descrito no site OpenJDK.

Requisito de Extensão de Criptografia Java de Força Ilimitada

Para que o agente se comunique de forma segura com recursos como servidores, o Java Runtime Environment usado pelo agente deve estar usando o Java Cryptography Extension (JCE) com Unlimited Strength Jurisdiction Policy Files. Se você estiver usando o JRE que é enviado com o agente, ele está usando o JCE com Unlimited Strength Jurisdiction Policy Files.

Se você substituir um JRE diferente pelo enviado com o agente, precisará substituir os arquivos de política incluídos com o JRE por Unlimited Strength Jurisdiction Policy Files, se ele ainda não os estiver usando. Para instalar o Java Cryptography Extension Unlimited Strength Jurisdiction Policy Files:

1. Acesse o site da Oracle para baixar o arquivo ZIP contendo Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files.
2. Descompacte o ZIP para extrair o local_policy.jar e US_export_policy.jar arquivos JAR.
3. Copie e substitua os arquivos JAR existentes encontrados em <JITTERBIT_HOME>\jre\lib\security, substituindo <JITTERBIT_HOME> com o caminho para o diretório raiz do seu agente privado.
4. Reinicie o agente privado Jitterbit.

Linux

Os pré-requisitos do Linux são detalhados em Instalar um agente Harmony Linux.

Windows

A versão Windows do agente privado Harmony tem estes requisitos:

• Atualizações do Windows: Instale todas as atualizações de segurança e "críticas" do Windows antes de instalar ou atualizar os agentes privados Harmony. Há problemas conhecidos da Microsoft ao instalar em sistemas que não têm as atualizações mais recentes (como KB2966870 e KB3140245).

• .NET: Pode ser necessário o Microsoft .NET Framework 4.5 ou superior.

• NTFS: A partição de instalação deve ser formatada em NTFS.

• Compressão: Não use a compressão do Windows na pasta Jitterbit, pasta PostgreSQL ou pasta temporária na máquina onde o agente privado Jitterbit está instalado e em execução. Usar a compressão do Windows diminuirá drasticamente o processamento de operações e transformações do Jitterbit.

Requisitos do PostgreSQL

O PostgreSQL é instalado como parte da instalação do agente privado. Esta instância do PostgreSQL é para uso somente com e pelo Jitterbit.

A versão do PostgreSQL distribuída com o agente depende da versão do agente privado:

• Os agentes privados 11.0 e posteriores são fornecidos com a versão 14.5-1 de 64 bits do PostgreSQL e o driver ODBC PostgreSQL 13.2.0.0. Os serviços Jitterbit do Windows para agentes privados do Windows 11.x dependem do serviço do Windows PostgreSQL 14.
• Os agentes privados do Windows 10.x e os agentes privados do Linux 10.37 a 10.x são agrupados com uma versão de 64 bits, 9.6.x do PostgreSQL com o driver ODBC do PostgreSQL 9.2. Os serviços Jitterbit do Windows para agentes privados do Windows 10.x dependem do serviço do Windows do PostgreSQL 9.6.

O uso de uma instalação existente do PostgreSQL em vez da instância do PostgreSQL incluída no agente é suportado por meio de opções de configuração avançadas:

• Windows: Durante a instalação de um agente privado do Windows, selecione a opção de instalação avançada.

• Linux: Durante a configuração de um agente privado Linux, execute o script de configuração com o -c opção.

A versão do banco de dados PostgreSQL existente deve corresponder à esperada pela versão do agente:

• Para agentes privados 11.0 e posteriores, um banco de dados PostgreSQL existente que é a versão 14.5-1 foi confirmado para funcionar. Espera-se que outras versões 14.x do PostgreSQL funcionem, mas não foram testadas.

• Para agentes privados do Windows 10.x e agentes privados do Linux 10.x que sejam pelo menos 10.37, o banco de dados PostgreSQL existente deve ser da versão 9.6.x.

Esses requisitos devem ser atendidos para instalar a instância do PostgreSQL que acompanha o agente:

• Não instale o PostgreSQL separadamente antes de instalar um agente privado. (As atualizações do agente privado não atualizam uma instalação existente do PostgreSQL para esta versão; elas são deixadas como estão.)
• Não use um sinal de mais (+) como parte da senha do PostgreSQL ao instalar um agente privado Harmony. 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 : + @ $ % &[] {} (), ; ? ^ = £.
• Não tenha nenhum outro banco de dados configurado ou em execução na instância do Jitterbit PostgreSQL.
• Não use o banco de dados/servidor Jitterbit PostgreSQL como parte de quaisquer operações e transformações do Jitterbit.
• Não use a compactação do Windows na pasta Jitterbit, pasta PostgreSQL ou pasta temporária na máquina onde o agente privado está instalado e em execução. Usar a compactação do Windows diminuirá drasticamente o processamento de operações e transformações do Jitterbit.
• A porta 5432 em agentes privados do Windows ou a porta 46914 em agentes privados do Linux devem estar livres para uso pelo banco de dados PostgreSQL.
• PgBouncer pode ser necessário para ambientes de alta carga. Agente privado Harmony Linux versão 10.6 e posterior e agente Harmony Windows versões 8.21 e depois instalar automaticamente PgBouncer. Se você já tem uma instalação existente de PgBouncer e problemas de experiência ao atualizar, entre em contato com o suporte para obter assistência.

Requisitos de Hardware

Estes são os requisitos mínimos de hardware e máquinas virtuais para agentes privados do Harmony:

• Processador quad-core

• 8 GB de RAM

• 50 GB de espaço disponível no disco rígido; isso inclui espaço para software, processamento paralelo e armazenamento temporário que pode crescer bastante durante a execução de uma operação

• Taxa de transferência mínima de 100 MB/s (megabytes por segundo) no disco rígido

• Conexão de Internet de alta velocidade

• Uma instalação direta de hardware ou uma instalação em uma máquina virtual da VMWare, VirtualBox, Microsoft Azure, Amazon AWS ou Rackspace que esteja configurada para os requisitos específicos descritos acima

  Importante

  Se você estiver usando o Microsoft Azure, consulte informações adicionais sobre configuração e solução de problemas.

• Configuração ideal do sistema e do ambiente geral; se não for configurado de forma ideal, problemas esporádicos e imprevisíveis podem resultar de E/S de disco ruim, memória limitada/sem memória, espaço em disco limitado/sem memória, falhas de energia e/ou reinicializações abruptas do sistema

• Acesso à porta de saída 443 (HTTPS) para comunicação com o Harmony. A porta 443 é normalmente permitida por firewalls de servidores corporativos.

• Acesso a portas de entrada especificadas conforme necessário; geralmente, as portas de entrada não precisam ser abertas

É recomendado que a plataforma Jitterbit API seja usada para mensagens ou dados de entrada. Onde um agente privado é usado para receber uma mensagem diretamente (como uma mensagem de saída do Salesforce) em vez da plataforma Jitterbit API, então as portas de entrada 443 (com SSL) ou 46909 (HTTPS) podem ser abertas. Portas personalizadas podem ser usadas para requisitos específicos se forem redefinidas na configuração do agente privado e forem permitidas por qualquer firewall corporativo.