Ir para o conteúdo

Instale um Agente Privado Silencioso do Windows

Introdução

O Windows Quiet Agente Installer permite configurar e executar uma instalação silenciosa e autônoma de um Agente Privado. Esta página fornece instruções sobre como baixar, instalar e configurar um Agente Privado usando o instalador do Harmony Windows Quiet Agente.

Para obter instruções sobre como usar o instalador padrão do Agente Privado do Windows, consulte Instalar um Agente do Windows.

Para obter mais informações sobre requisitos do sistema, reinicialização, reversão e desinstalação de um Agente Privado, consulte Instalando um Agente Harmony Windows.

Estas instruções pressupõem e exigem que você já tenha criado um Grupo de Agentes e Agente Privado(s) para sua organização no Management Console. Consulte Agentes > Grupos de Agente e Agentes > Agentes Para maiores informações.

Baixe o Instalador do Windows Quiet Agente

Para baixar o instalador do Windows Quiet Agente, siga estas instruções:

  1. Faça login no Portal Harmony e navegue até Downloads página.
  2. Na linha Jitterbit Agente, clique em Windows Quiet Agente Installer (x64) na coluna Download. Um arquivo ZIP para o Windows Quiet Agente Installer será baixado. O arquivo ZIP contém vários scripts que devem ser editados para instalar o agente (consulte Instalando e configurando um Agente abaixo).

Nota

O arquivo ZIP do Windows Quiet Agente Installer pode ser baixado, armazenado localmente e reutilizado conforme necessário para quaisquer Agentes Privados adicionais à medida que eles são adicionados.

Instalar e Configurar um Agente

Para instalar e configurar um Agente Privado usando o Windows Quiet Agente Installer, siga estas etapas:

  1. Descompacte jitterbit-agent-x64-XX.XX.X.XX.zip.

  2. Abra config64.ps1 e preencha os parâmetros entre aspas duplas para cada campo:

    config64.ps1
    $Jitterbit_user_name = "example@jbexample.com"
    $Jitterbit_password = "Jitterbit4Ever!"
    $Postgres_super_user = "postgres"
    $Postgres_super_password = "Ea$yAs123"
    Postgres_service_account = "postgres"
    $Postgres_service_password = "humTdumt$@t0nAwa11"
    Postgres_agent_username = ""
    Postgres_agent_password = ""
    $Agent_group_id = "123321"
    $Agent_id = "987789"
    $Agent_install_file = "jitterbit-agent-x64-XX.XX.X.XX.exe"
    [bool] $Postgres_listen_address_localhost = 0
    $Postgres_config_dir = "C:\Program Files\PostgreSQL\14\data\postgresql.conf"
    
    Campo Descrição
    Jitterbit_user_name Digite o nome de usuário associado à sua conta Harmony.
    Jitterbit_password Digite a senha da sua conta Harmony.
    Postgres_super_user Se aplicável, insira um nome de usuário para a conta de superusuário do PostgreSQL. Caso contrário, deixe este campo definido como padrão postgres. Essa configuração está disponível somente para o agente versão 10.48 ou posterior.
    Postgres_super_password Digite uma senha a ser usada para o banco de dados PostgreSQL. A senha deve estar em conformidade com as políticas de senha do seu sistema em relação ao comprimento e à complexidade. Se você estiver usando uma instalação existente do PostgreSQL, insira a super senha do banco de dados PostgreSQL existente.
    Postgres_service_account Se aplicável, insira o nome de usuário da conta de serviço do Windows para o serviço PostgreSQL ser executado. Caso contrário, deixe este campo definido como padrão postgres. Essa configuração está disponível somente para o agente versão 10.48 ou posterior.
    Postgres_service_password Digite uma senha a ser usada para o banco de dados PostgreSQL. A senha deve estar em conformidade com as políticas de senha do seu sistema em relação ao comprimento e à complexidade. Se você estiver usando uma instalação existente do PostgreSQL, insira a super senha do banco de dados PostgreSQL existente.
    Postgres_agent_username Por padrão, o instalador usa o nome de usuário do agente PostgreSQL especificado com o User chave no [DbInfo] seção do arquivo de configuração do Agente Privado. Se você quiser que o agente use um nome de usuário alternativo, especifique-o aqui para substituir a definição de configuração do Agente Privado. Caso contrário, deixe este campo em branco. Essa configuração está disponível somente para o agente versão 10.48 ou posterior.
    Postgres_agent_password Se aplicável, insira a senha da conta especificada no Postgres_agent_username campo. Caso contrário, deixe este campo em branco. Essa configuração está disponível somente para o agente versão 10.48 ou posterior.
    Agent_group_id Insira seu ID de Grupo de Agentes Privados. Seu ID de Grupo de Agentes Privados está disponível no Management Console Agents > Agente Groups, passando o mouse sobre o nome do Grupo de Agentes para ver o ID do Grupo de Agentes.
    Agent_id Insira seu ID de Agente Privado. Seu ID de Agente Privado está disponível no Management Console Agentes > Grupos de Agente, passando o mouse sobre o nome do Agente para ver o ID do Agente.
    Agent_install_file Este campo é preenchido automaticamente e não requer modificação. O valor padrão deste campo aponta para a versão do executável do agente do Windows baixado.

    Nota

    O valor deste campo deve corresponder ao valor do arquivo ZIP baixado. Você receberá erros e a instalação falhará se Agent_install_file não aponta para o executável correto do agente do Windows.

    Postgres_listen_address_locahost Insira um valor booleano indicando se o banco de dados PostgreSQL listen_address está configurado para localhost. Qualquer valor diferente de zero corresponde a true e 0 corresponde com false. O padrão é 0 (false).
    Postgres_config_dir Se você estiver usando um banco de dados PostgreSQL existente, insira o diretório do arquivo de configuração do banco de dados PostgreSQL. Se você estiver usando o banco de dados PostgreSQL empacotado com o Agente Privado, esta linha não precisa ser modificada.
  3. Abra silent_install64.ps1 E definir KO_INSTALL_MODE para o modo de instalação apropriado dependendo se você deseja instalar o banco de dados PostgreSQL empacotado com o Agente Privado ou se possui uma instalação existente de um banco de dados PostgreSQL que gostaria de usar:

    Modo de instalação
    Descrição
    KO_INSTALL_MODE=\"0\

    Avançado: instala um Agente Privado e configura um banco de dados de Agente Privado para usar uma instalação existente do PostgreSQL. Este modo pode ser usado para uma atualização de um Agente Privado somente ao atualizar de uma versão 11.x do agente para uma versão 11.x posterior, ou de uma versão 10.x do agente para uma versão 10.61 ou anterior.

    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
    KO_INSTALL_MODE=\"1\ Rápido: Instala todos os componentes necessários para executar o Agente Privado, incluindo um banco de dados e driver do agente PostgreSQL. Use esta opção se você nunca instalou um banco de dados PostgreSQL ou o Agente Privado neste computador antes, ou se você desinstalou corretamente todos os componentes (consulte Desinstalando um Agente Privado).
  4. Execute o Windows PowerShell como administrador. No PowerShell, navegue até o arquivo baixado e descompactado chamado jitterbit-agent-x64-XX.XX.X.XX e execute o silent_install64 script usando o comando ./silent_install64.

  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.