Ir para o conteúdo

Instale um Agente Privado do Windows

Introdução

Estas são as instruções para baixar e instalar o Harmony Agente Privado no 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.

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

Uma alternativa ao uso do instalador padrão do Agente Privado 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.

Nota

A partir da versão 10.34 do Harmony, os Agentes Privados de 32 bits não estão mais disponíveis para download. Se você estiver usando um agente de 32 bits, atualize para um agente de 64 bits seguindo as instruções do Windows.

Importante

Problema Conhecido: Ao instalar um Agente Privado 10.69 ou posterior (para agentes 10.x) ou 11.8 ou posterior (para agentes 11.x) no Windows 2019 ou Windows 10, uma mensagem de aviso pode aparecer informando que diz “O Windows protegeu seu PC” com uma observação de que o Microsoft Defender SmartScreen impediu a inicialização de um aplicativo não reconhecido. Para prosseguir com a instalação do agente, clique em Mais informações na caixa de diálogo da mensagem de aviso e clique em Executar mesmo assim.

Baixe um Agente Privado do Windows

Estas instruções sobre como baixar um Agente Privado do Windows pressupõem que você já criou um Grupo de Agentes e Agente Privado(s) para sua organização no Management Console Grupos de Agente e Agentes páginas, respectivamente.

  1. Faça login no Portal Harmony e vá para Management Console > Agentes > Grupos de Agente.

  2. Na parte superior da tela, selecione a linha Grupo de Agentes. A metade inferior da tela agora deve listar os Agentes Disponíveis dentro do Grupo de Agentes selecionado.

  3. Na parte inferior da tela, selecione a linha do 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.

Instale 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 carga 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 de e-mail e a senha que você usa para fazer login em https://login.jitterbit.com).

    Cuidado

    Se sua organização e conta usarem login único (SSO), suas credenciais normais de SSO não funcionarão. Você deve usar credenciais Harmony para instalar Agente Privado(s). Consulte Instalando um Agente Privado em Registrando e fazendo login usando o Harmony SSO Para maiores informações.

  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 organizacional que tenha permissões Admin ou Agent-Install. Consulte Organizações e a seção sobre Gerenciamento de permissões, funções e membros Para maiores informações.

  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 de agente PostgreSQL e driver. 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 Windows Agentes Privados 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 Windows Agentes Privados 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 Harmony Agentes Privados 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. Assim que um agente for iniciado, seu status deverá ser Em execução.

    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.