Instale um Agente Privado do Windows¶

Introdução¶

Estas são as instruções para baixar e instalar o agente privado Harmony no Windows. Antes da instalação, recomendamos revisar Alta disponibilidade e balanceamento de cargas de grupos de Agente e Melhores práticas de agentes privados para conversas técnicas.

Para obter informações sobre os requisitos do sistema, consulte Requisitos do sistema para agentes privados do Windows.

Uma alternativa ao uso do instalador de agente privado padrão do Windows é configurar e executar uma instalação silenciosa e autônoma de um agente privado. Para obter mais informações, consulte Instalar um agente silencioso do Windows.

Baixe um Agente Privado do Windows¶

Estas instruções sobre como baixar um agente privado do Windows pressupõem que você já tenha criado um grupo de agentes e agente(s) privado(s) para sua organização no Management Console Agents Páginas.

1. Faça login no portal Harmony e vá para Management Console > Agentes.

2. Expanda a linha do grupo de agentes.

3. No painel de detalhes, selecione o agente. Em seguida, clique no menu suspenso Ação na extrema direita e selecione Baixar para Windows EXE.

4. O executável do agente do Windows pode ser baixado, armazenado localmente e reutilizado conforme necessário para quaisquer agentes privados adicionais à medida que forem adicionados.

Instalar um Agente Privado¶

A instalação de mais de um agente em um grupo de agentes permite automaticamente alta disponibilidade. A instalação de vários agentes em um grupo de agentes também permite automaticamente o balanceamento de cargas. Consulte Alta disponibilidade e balanceamento de cargas de grupos de Agente para obter informações adicionais. Antes de instalar, verifique se todos os requisitos e avisos de software foram atendidos.

Em cada agente do grupo de agentes:

1. Execute o arquivo executável do agente do Windows baixado e siga as instruções.

2. No prompt Credenciais de login, insira suas credenciais do Harmony (o endereço email e a senha que você usa para fazer login em https://login.jitterbit.com).

   Cuidado

   Se sua organização e conta usam logon único (SSO), suas credenciais normais de SSO não funcionarão. Você deve usar credenciais do Harmony para instalar agente(s) privado(s).

3. Siga as instruções para selecionar sua organização, agente, etc. As opções disponíveis são aquelas que você já configurou no Management Console.

   Nota

   Você deve ser membro de uma papel que tem permissões Admin ou Agent-Install.

4. No prompt Select Install Mode, escolha o modo dependendo se você deseja instalar a instância do PostgreSQL que vem com o agente ou se tem uma instalação existente do PostgreSQL que você gostaria de usar:

   • Instalação rápida (recomendada): Instala todos os componentes necessários para executar um agente privado, incluindo um banco de dados e driver do agente PostgreSQL. Use esta opção se você nunca instalou o PostgreSQL ou um agente privado neste computador antes, ou se você desinstalou corretamente todos os componentes seguindo as instruções em Desinstalar um agente privado. Mais informações sobre o banco de dados PostgreSQL fornecido com o agente são fornecidas em Requisitos do PostgreSQL em Requisitos do sistema para agentes privados.

     Nota

     Quando você for solicitado a configurar sua senha do PostgreSQL, observe que a senha deve estar em conformidade com as políticas de senha do seu sistema em relação ao comprimento e complexidade.

   • Avançado: Instala um agente privado e configura um banco de dados de agente privado para usar uma instalação existente do PostgreSQL. Você precisará fornecer suas credenciais do PostgreSQL. Você pode usar esta opção se quiser gerenciar senhas separadamente em cada aplicativo.

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

     • Para agentes privados do Windows 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, o banco de dados PostgreSQL existente deve ser a versão 9.6.x.

     Um banco de dados PostgreSQL 14.x existente deve ser configurado para usar criptografia de senha MD5:

     postgres=# set password_encryption TO 'md5';
     SET
     

5. Após a instalação, o agente tentará iniciar e estabelecer uma conexão com o Harmony. Esse processo pode levar mais de um minuto para ser concluído.

   Importante

   Os agentes privados Harmony instalados em servidores Microsoft Azure exigem um intervalo de pulsação do agente reduzido.

   Você pode verificar o status do agente no Management Console Agents página. Uma vez que um agente inicia, seu status deve ser Running.

   Nota

   Nas versões 10.61, 10.62, 10.63 e 11.1 do agente, o status será Parado até que o grupo de agentes de um agente seja associado a um ambiente.