Requisitos do Sistema para Agentes Privados Linux¶

Visão Geral¶

Estes são os requisitos de sistema para instalar o Harmony Agente Privado em um sistema Linux. Antes da instalação, recomendamos revisar Alta disponibilidade e balanceamento de carga de grupos de Agente e Conversa técnica sobre práticas recomendadas para Agentes Privados.

Para obter instruções sobre como baixar, instalar, configurar, reiniciar, atualizar, reverter e desinstalar um Agente Privado Linux, consulte a página apropriada para as distribuições suportadas:

Requisitos de Sistema¶

Melhores Práticas¶

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 uma conta de superusuário Linux 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 versão Linux do Harmony Agente Privado requer um sistema operacional de 64 bits. É compatível com estas distribuições derivadas do Debian Linux e 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 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.

Requisitos de Software de Pré-requisito¶

Comandos Necessários¶

O jitterbit-agent o pacote pode ser instalado em muitas versões de distribuições Linux; tem muito poucas dependências explícitas de pacotes. No entanto, estes comandos devem estar disponíveis:

Required Commands

python
sed
sudo
tar
unixodbc
unzip

Você pode testar a disponibilidade de um comando executando o which comando.

Nota

O usuário root em seu servidor deve ter acesso ao sudo comando.

Bibliotecas Necessárias¶

Os Agentes Privados do Linux exigem que estas bibliotecas sejam instaladas:

Required Libraries

libc.so.6
libgcc_s.so.1
libm.so.6
librt.so.1
libstdc++.so.6
libuuid.so.1
libz.so.1

Para obter instruções sobre como instalar as bibliotecas necessárias, consulte a página apropriada para sua distribuição:

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.

O Jitterbit pode ser configurado para usar um JRE externo. A versão mínima é 1.8 (Java 8). Para alterar o tempo de execução Java usado pelo Harmony Agente Privado, edite o arquivo /etc/sysconfig/jitterbit para usar a versão apropriada do Java tempo de execução e reiniciar todos os serviços Jitterbit.

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:

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).
Descompacte o ZIP para extrair o local_policy.jar e US_export_policy.jar Arquivos JAR.
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.
Reinicie o Agente Privado 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 Linux 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 Agentes Privados 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 PostgreSQL 9.2.

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. 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 Linux 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 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 46914 deve estar livre para uso do banco de dados PostgreSQL.
PgBouncer pode ser necessário para ambientes de alta carga. Agente Privado Harmony Linux versão 10.6 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.

Próximos Passos¶

Para obter instruções sobre como baixar, instalar, configurar, reiniciar, atualizar, reverter e desinstalar um Agente Privado Linux, consulte a página apropriada para sua distribuição: