Skip to Content

Migrate a private agent

Overview

To migrate a private agent from one host (A) to another host (B), you must do the following:

  1. Migrate the private agent (host A):
    1. Drain pause the agent.
    2. Copy configuration files from host A to a temporary location on host B.
  2. Manage private agents in the Management Console:
    1. Download the private agent software.
    2. Add a new agent, or make one available.
  3. Install and configure a migrated private agent (host B):
    1. Install the downloaded private agent software.
    2. Copy configuration files from the temporary location.
    3. Start the agent.
  4. (Optional) Uninstall the migrated private agent.

Important

There should be no existing private agent installation on the new host. If there is, you must completely remove it.

Migrate the private agent (host A)

To migrate a private agent, follow these steps:

  1. In a terminal, run this command:

    jitterbit-utils --drain-pause

    JitterbitUtils.exe --drain-pause

    This stops the agent from accepting new operations, and allows currently running operations to finish.

  2. Copy the following files from host A to a temporary location on host B, where JITTERBIT_HOME is the private agent installation location (by default C:\Program Files\Jitterbit Agent\ on Microsoft Windows, /opt/jitterbit/ on Linux):

    Location File
    JITTERBIT_HOME/ JdbcDrivers.conf
    JITTERBIT_HOME/Resources/ jitterbit-agent-config.properties
    JITTERBIT_HOME/apache/conf/ httpd.conf
    JITTERBIT_HOME/apache/conf/ *.crt
    JITTERBIT_HOME/apache/conf/ *.key
    JITTERBIT_HOME/apache/conf/extra/ *.conf
    JITTERBIT_HOME/jre/lib/security/ cacerts

  3. (Optional) If you have custom settings in the JITTERBIT_HOME/jitterbit.conf file on host A, you should merge them individually with the default copy on host B.

    Important

    Do not overwrite the Password value in the DbInfo section on host B.

Manage private agents in the Management Console

Follow these steps:

  1. Open the Management Console > Agents page.

  2. Hover on the entry for host A, then select Download Jitterbit Agent in the Actions column. In the menu that opens, select Currently installed version (under Choose a Jitterbit version), select the OS running on host B (under Choose an operating system), then click the Download button.

  3. Copy the downloaded software package to a temporary location on host B.

  4. If your Harmony license allows, add a private agent. If you have reached the limit for the number of agents allowed by your Harmony license, delete host A's agent.

Install and configure a migrated private agent (host B)

To install and configure a migrated private agent on the new host (B), follow these steps:

  1. Install the downloaded private agent software package:

    Run the installer and configure the agent. When prompted for the name of the private agent, select the one just added.

    Run the installer. When prompted for the name of the private agent, select the one just added.

  2. Copy the configuration files from their temporary to their original locations on the new host.

  3. Restart the agent.

(Optional) Uninstall a migrated private agent

When the JITTERBIT_HOME/jitterbit-agent.log log file on host A indicates that no more operations are being processed, and the private agent on host B is successfully processing operations, you may stop the agent on host A, then uninstall it to prevent it restarting when the host reboots.