Skip to end of metadata
Go to start of metadata

Overview

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 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-<VERSION NUMBER>
  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_password = "Ea$yAs123"
    $Postgres_service_password = "humTdumt$@t0nAwa11"
    $Agent_group_id = "123321"
    $Agent_id = "987789"
    $Agent_install_file = "jitterbit-agent-x64-10.42.0.38.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_paswordEnter 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_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. 
    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

    The default value of jitterbit-agent-x64-10.35.1.1.exe must be edited to point to the correct version of Windows agent executable. The version for your Windows agent executable can be found in the ZIP file named jitterbit-agent-x64-<VERSION NUMBER>.

    NOTE: 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 Uninstall 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-<VERSION NUMBER> 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