Requisitos de Sistema para Agentes Privados do Windows¶

Introdução¶

Estes são os requisitos do sistema para instalar o Harmony Agente Privado em um sistema Windows. Antes da instalação, recomendamos revisar Alta disponibilidade e balanceamento de carga dos grupos de Agente e Conversa técnica sobre melhores práticas de 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 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 (ativa/ativa) e balanceamento de cargas conforme descrito em Alta disponibilidade e balanceamento de carga de grupos de Agente.

• Instalação em servidor: Para ambientes de produção, recomendamos a instalação do 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á está 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 podem 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. Usar uma conta de usuário local não é recomendado.

• Desinstalação: Antes de desinstalar, recomendamos que você copie os arquivos de configuração e 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 do 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 para 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 os Agentes Privados Harmony. Existem problemas conhecidos da Microsoft ao instalar 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 ser 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. O uso da compactação do Windows desacelera drasticamente o processamento de operações e transformações do Jitterbit.

Java Runtime Environment¶

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 uso do Jitterbit, 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 com segurança com recursos como servidores, o Java Runtime Environment usado pelo agente deve usar o Java Cryptography Extension (JCE) com Unlimited Strength Jurisdiction Policy Files. 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 enviado com o agente, será necessário substituir os arquivos de política incluídos com o JRE por Arquivos de Política 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 da Extensão de Criptografia Java:

1. Acesse o site da Oracle para fazer download do arquivo ZIP contendo Arquivos de Política de Jurisdição de Força Ilimitada 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 Jitterbit Agente Privado.

Requisitos do PostgreSQL¶

O PostgreSQL é instalado como parte da instalação do Agente Privado. Esta instância do PostgreSQL é para uso somente com e por Jitterbit.

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

• Windows Agentes Privados 11.0 e posteriores são fornecidos com a versão 14.5-1 de 64 bits do PostgreSQL e o driver PostgreSQL 13.2.0.0 ODBC. Os serviços Jitterbit Windows para Windows 11.x Agentes Privados dependem do serviço PostgreSQL 14 Windows.
• Windows Agentes Privados 10.x são empacotados 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 Windows 10.x Agentes Privados dependem do serviço PostgreSQL 9.6 Windows.

O uso de uma instalação existente do PostgreSQL em vez da instância do PostgreSQL empacotada com o 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 posterior, 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 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 PostgreSQL existente 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 Jitterbit PostgreSQL.
• Não use o banco de dados/servidor Jitterbit PostgreSQL como parte de quaisquer operações e transformações Jitterbit.
• Não usar 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. O uso da compactação do Windows desacelera 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. Harmony Windows Agente versões 8.21 e depois instalar automaticamente PgBouncer. Se você já tiver uma instalação existente do PgBouncer e tiver problemas para atualizar, entre em contato com o suporte para assistência.

Requisitos de Hardware¶

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

• Processador quad core

• 8 GB 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 de VMWare, VirtualBox, Amazon AWS ou Rackspace configurada para os requisitos específicos descritos acima

• Configuração otimizada do sistema e ambiente geral; se não for configurado de maneira ideal, problemas esporádicos e imprevisíveis podem resultar de I/O de disco ruim, 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 se comunicar 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 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, as portas de entrada 443 (com SSL) ou 46909 (HTTPS) podem ser abertas. Portas personalizadas podem ser utilizadas para requisitos específicos se forem redefinidas na configuração do Agente Privado e forem permitidas por qualquer firewall corporativo.