Requisitos do 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 em Linux e Windows sistemas.

Considerações e Práticas Recomendadas Sobre Sistema Operacional¶

Antes da instalação, revise Alta disponibilidade e balanceamento de carga de grupos de Agente e estas considerações e práticas recomendadas sobre sistema operacional.

Considerações Sobre o Sistema Operacional¶

Ao decidir instalar um Agente Privado em um Linux ou Windows sistema operacional, revise estas considerações:

• Versão: Todos os Agentes Privados de um Grupo de Agentes específico devem ser instalados em máquinas que utilizam o mesmo sistema operacional e a mesma versão de 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 Microsoft SQL Server é suportada apenas em Windows Agentes Privados.

• Compartilhamentos de arquivos: Server Message Block versão 2 (SMBv2) usando o conector de compartilhamento de arquivos para Cloud Studio ou Design Studio é compatível apenas com Agentes Privados do Windows.

• Microsoft Dynamics: Os conectores do Microsoft Dynamics (como o conector do Microsoft Dynamics CRM para Cloud Studio e Microsoft Dynamics AX, CRM e conectores GP para Design Studio ) exigem 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 obter melhores resultados, 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 (ativa/ativa) e balanceamento de cargas, conforme descrito em Alta disponibilidade e balanceamento de carga de grupos de Agente.

• Instalação no 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 testes.

• 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. A execução do 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 do agendamento poderão ser imprevisíveis se os fusos horários forem diferentes.

• Permissões de conta: Recomendamos usar um superusuário do Linux ou uma conta 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 de sua instalação atual caso queira reinstalar com a mesma configuração posteriormente.

Requisitos do Sistema Operacional¶

A Jitterbit exige que os sistemas operacionais usados para os Agentes Privados Harmony atendam a estas especificações:

Linux¶

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

• Ubuntu 20.04LTS

• Ubuntu 22.04 LTS

• Red Hat Enterprise Linux 8

• Amazon Linux AMI 2

O Harmony Agente Privado não foi certificado contra outras distribuições semelhantes com distribuições de pacotes Debian ou 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 Harmony Agente Privado 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 de Pré-requisito¶

Versão Java Necessária¶

O pacote Harmony Agente Privado vem 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 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 fornecida com o Agente é o AdoptOpenJDK JRE. Este JRE é licenciado conforme descrito no site do 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 usar o Java Cryptography Extension (JCE) com arquivos de política de jurisdição de força ilimitada. Se você estiver usando o JRE fornecido com o agente, ele estará usando JCE com arquivos de política de jurisdição de força ilimitada.

Se você substituir um JRE diferente por aquele fornecido com o agente, será necessário substituir os arquivos de políticas incluídos no JRE por Arquivos de Políticas de Jurisdição de Força Ilimitada, se ainda não os estiver usando. Para instalar os arquivos de política de jurisdição de força ilimitada do Java Cryptography Extension:

1. Acesse o site da Oracle para fazer download do arquivo ZIP que contém os arquivos de política de jurisdição de força ilimitada do Java Cryptography Extension (JCE).
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 Agente Privado.
4. Reinicie o Agente Privado Jitterbit.

Linux¶

Os pré-requisitos do Linux estão detalhados em Instalando um Agente Harmony Linux. Em resumo, estes são necessários para a instalação do Agente Privado em um sistema Linux:

• Comandos: Estes comandos devem estar disponíveis: python, sed, sudo, tar, unixodbc, unzip.
• Bibliotecas: Agentes Privados exigem determinadas bibliotecas conforme especificado em Bibliotecas Necessárias em Requisitos do sistema para Agentes Privados Linux.

Windows¶

A versão Windows do Harmony Agente Privado tem estes requisitos:

• Atualizações do Windows: Instale todas as atualizações "críticas" e de segurança do Windows antes de instalar ou atualizar os Harmony Agentes Privados. Existem problemas conhecidos da Microsoft durante a instalação em sistemas que não possuem as atualizações mais recentes (como KB2966870 e KB3140245).

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

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

• Compressão: Não use a compactação do Windows na pasta Jitterbit, pasta PostgreSQL ou pasta temporária na máquina onde o Jitterbit Agente Privado está instalado e em execução. Usar a compactação do Windows retardará 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 deve ser usada 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 Windows para Agentes Privados do Windows 11.x dependem do serviço PostgreSQL 14 Windows.
• Os Agentes Privados do Windows 10.x e os Agentes Privados do Linux 10.37 a 10.x são fornecidos com uma versão 9.6.x de 64 bits do PostgreSQL com o driver ODBC do PostgreSQL 9.2. Os serviços Jitterbit Windows para Agentes Privados do Windows 10.x dependem do serviço PostgreSQL 9.6 Windows.

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 da 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 a versão 9.6.x.

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

• Não instale 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 Harmony 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 : + @ $ % & [] {} () , ; ? ^ = £.
• Não possui 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 Jitterbit.
• Não use 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 retardará drasticamente o processamento de operações e transformações do Jitterbit.
• A porta 5432 em Agentes Privados Windows ou a porta 46914 em Agentes Privados Linux deve ser gratuita 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 Harmony Windows Agente versões 8.21 e depois instalar automaticamente PgBouncer. Se você já possui uma instalação existente do PgBouncer e tiver problemas de atualização, entre em contato com o suporte para assistência.

Requisitos de Hardware¶

Estes são os requisitos mínimos de hardware e máquinas virtuais para Harmony Agentes Privados:

• Processador quad core

• 8 GB de RAM

• 50 GB de espaço disponível no disco rígido; isso inclui espaço para o 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, Amazon AWS ou Rackspace configurada para os requisitos específicos descritos acima

• Configuração ideal do sistema e ambiente geral; se não for configurado de maneira ideal, problemas esporádicos e imprevisíveis podem resultar de E/S de disco deficiente, memória limitada/sem memória, espaço em disco limitado/sem espaço, 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

Recomenda-se que a plataforma API Jitterbit seja usada para mensagens ou dados recebidos. Quando um Agente Privado é usado para receber uma mensagem diretamente (como uma mensagem de saída do Salesforce) em vez da plataforma API Jitterbit, 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.