Requisitos do Sistema para Agentes Privados do Windows¶

Introdução¶

Estes são os requisitos de sistema para instalar o Harmony Agente Privado em um sistema Windows. 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.

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 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 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¶

A versão Windows do Harmony Agente Privado requer:

• Atualizações do Windows: Instale todas as atualizações "críticas" e de segurança do Windows antes de instalar ou atualizar o 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.

Ambiente de Execução Java¶

O pacote Harmony Agente 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 8.x necessário especificamente para o Jitterbit usar, para que não entre em conflito com outras instalações Java que já possam estar instaladas.

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 o 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, caso ainda não os esteja 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.

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 do Windows 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 são fornecidos com uma versão 9.6.x de 64 bits do PostgreSQL com o driver PostgreSQL 9.2 ODBC. 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. Durante a instalação de um Windows Agente Privado, selecione a opção de instalação avançada durante a instalação do Windows Agente Privado.

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

• Para Windows 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 Windows Agentes Privados 10.x, 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 deve estar livre para uso do banco de dados PostgreSQL.
• PgBouncer pode ser necessário para ambientes de alta carga. Agente Harmony Windows 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.