Skip to end of metadata
Go to start of metadata

Overview

The Windows Quiet Agent Installer lets you configure and run a silent and unattended installation of a Private Agent. This page provides the instructions on downloading, installing, and configuring a Private Agent using the Jitterbit Harmony Windows Quiet Agent Installer.  For more information on system requirements, restarting, rolling back, and uninstalling a Private Agent, see Installing a Jitterbit Harmony Windows Agent

These instructions assume and require that you have already created an Agent Group and Private Agent(s) for your organization within the Management Console. Refer to Agents > Agent Groups and Agents > Agents for more information.

Downloading the Windows Quiet Agent Installer

To download the Windows Quiet Agent Installer, follow these instructions:

  1. Log in to the Jitterbit Harmony Portal and navigate to the Downloads page. 
  2. In the Jitterbit Agent row, click Windows Quiet Agent Installer (x64) in the Download column. A ZIP file for the Windows Quiet Agent Installer will be downloaded. The ZIP file contains various scripts that must be edited to install the agent (see Installing and Configuring an Agent below).

NOTE: The Windows Quiet Agent Installer ZIP file can be downloaded, stored locally, and reused as needed for any additional Private Agents as they are added.

Installing and Configuring an Agent

To install and configure a Private Agent using the Windows Quiet Agent Installer, follow these steps:

  1. Unzip jitterbit-agent-x64-XX.XX.X.XX.zip
  2. Open config64.ps1 and populate the parameters within the double quotes for each field:

    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\9.6\data\postgresql.conf"
    FieldDescription
    Jitterbit_user_nameEnter the username associated with your Jitterbit Harmony account.
    Jitterbit_passwordEnter the password for your Jitterbit Harmony account.
    Postgres_super_user If applicable, enter a username for the PostgreSQL superuser account. Otherwise, leave this field set to the default postgresThis setting is available only for agent version 10.48 or later. 
    Postgres_super_passwordEnter a password to be used for the PostgreSQL database. The password must conform to your system's password policies regarding length and complexity. If you are using an existing installation of PostgreSQL, enter the super password for the existing PostgreSQL database. 

    Postgres_service_account

    If applicable, enter the username of the Windows service account for the PostgreSQL service to run under. Otherwise, leave this field set to the default postgresThis setting is available only for agent version 10.48 or later. 
    Postgres_service_passwordEnter a password to be used for the PostgreSQL database. The password must conform to your system's password policies regarding length and complexity. If you are using an existing installation of PostgreSQL, enter the super password for the existing PostgreSQL database. 

    Postgres_agent_username

    By default, the installer uses the PostgreSQL agent username specified with the User key in the [DbInfo] section of the Private Agent configuration file. If you want the agent to use an alternative username, specify it here to override the Private Agent configuration setting. Otherwise, leave this field blank. This setting is available only for agent version 10.48 or later. 

    Postgres_agent_password

    If applicable, enter the password for the account specified in the Postgres_agent_username field. Otherwise, leave this field blank. This setting is available only for agent version 10.48 or later. 
    Agent_group_idEnter your Private Agent Group ID. Your Private Agent Group ID is available from the Management Console Agents > Agent Groups page, by hovering over the Agent Group name to see the Agent Group ID.
    Agent_idEnter your Private Agent ID. Your Private Agent ID is available from the Management Console Agents > Agent Groups page, by hovering over the Agent name to see the Agent ID.
    Agent_install_file

    This field is automatically populated and does not require modification. The default value of this field points to the version of the downloaded Windows agent executable. 

    NOTE: The value of this field should match the value of the downloaded ZIP file. You will receive errors and the installation will fail if Agent_install_file does not point to the correct Windows agent executable. 

    Postgres_listen_address_locahostEnter a boolean value indicating whether the PostgreSQL database listen_address is set to localhost. Any non-zero value corresponds with true and 0 corresponds with false. The default is 0 (false). 
    Postgres_config_dirIf you are using an existing PostgreSQL database, enter the directory of your PostgreSQL database configuration file. If you are using the PostgreSQL database packaged with the Private Agent, this line does not need to be modified. 
  3. Open silent_install64.ps1 and set KO_INSTALL_MODE to the appropriate install mode depending on whether you want to install the PostgreSQL database packaged with the Private Agent or have an existing installation of a PostgreSQL database that you would like to use:

    Installation ModeDescription
    KO_INSTALL_MODE=\"0\ Advanced: Installs the Private Agent and configures the Private Agent database to use an existing installation of PostgreSQL. This mode can be used for an upgrade of a Private Agent. 
    KO_INSTALL_MODE=\"1\Quick: Installs all components needed to run the Private Agent including a PostgreSQL agent database and driver. Use this option if you have never installed a PostgreSQL database or the Private Agent on this computer before, or if you have properly uninstalled all components (see Uninstalling a Private Agent).
    KO_INSTALL_MODE=\"2\SQLite: Installs the Private Agent and configures the Private Agent database to use an existing installation of a PostgreSQL database and ODBC driver.
  4. Run Windows PowerShell as an administrator. Within PowerShell, navigate to the downloaded and unzipped file named jitterbit-agent-x64-XX.XX.X.XX and run the silent_install64 script using the command ./silent_install64
  5. After installation, the agent should start automatically. You can check the status of the agent in the Management Console Agents page, which should be Running.

    NOTE: It can take more than a minute for the Jitterbit Harmony Agent to start up and register with Jitterbit Harmony.
    WARNING: If you experience errors related to PostgreSQL, see Troubleshoot PostgreSQL ErrorsIf you experience an Error 1722 message, see Troubleshoot Error 1722. If you are still experiencing any problems during installation, please contact support.

  • No labels