Skip to Content

Jitterbit private agents on Linux

Introduction

This page shows you how to install and run a private agent on Linux.

Install

To install a private agent, check the Prerequisites, then follow the steps in the Download, Run installer, and Configure sections.

Prerequisites

You must have the following:

  • A host that meets the system requirements.

  • Your Harmony account username and password.

  • Your Harmony organization name.

  • The name and ID of a private agent group.

  • An account with root privileges. Use it for all actions on this page.

The following are optional:

  • Add an agent in the Management Console. If you don't have any unregistered private agents in the agent group, one is automatically created with a name that includes the host's name and IP address.

  • A PostgreSQL database server is installed automatically. To use your own, you must set it up before installing the private agent, and have ready its name or IP address, its port number, and the details of the database administrator account.

The following are recommended:

Download

To download the private agent software, go to the Harmony Portal Downloads page. (If you have already added an agent on the Management Console Agents page, click the agent's Download Jitterbit Agent icon.)

Download one of the following private agent Linux packages:

  • Linux Debian (x64): The .deb package file, for installing on Debian or Ubuntu Linux as root.

  • Linux RPM: The .rpm package file, for installing on Red Hat Linux as root.

  • Linux Redhat Non-Root (x64): The .tar file, that can be unpacked on Red Hat Linux by a non-root user.

Note

A root or sudo account is still necessary for installing prerequisite software and adding a user account.

Run installer

In a terminal, run the following commands for the downloaded installer type:

apt-get install <PATH>/jitterbit-agent_<VERSION>_amd64.deb
update-alternatives --install /usr/bin/python python /usr/bin/python2 1

yum install <PATH>/jitterbit-agent-<VERSION>.x86_64.rpm
alternatives --set python /usr/bin/python2
as root
yum install python2 tar unixODBC unzip
alternatives --set python /usr/bin/python2
useradd -U jitterbit -b /opt -G wheel
passwd jitterbit
# Set a password
as jitterbit
tar -C /opt -xf <PATH>/jitterbit-agent-<VERSION>.x86_64.tar
. scripts/set.env.sh
scripts/install.sh

Configure

To configure, register, and restart a private agent on Linux, follow these steps:

  1. Run this command:

    jitterbit-config

    To let the agent communicate via a proxy server, add the required options.

  2. When prompted, enter your Harmony account username and password, and select the options corresponding to your organization, agent group, and agent.

    If you installed the tar package as the jitterbit user, enter y at the following prompt:

    Warning: this tool requires root privileges.
Hint: Use sudo or log on as the root user.
Do you want to continue as the current user? [y/n]:

  3. Run this command:

    jitterbit restart

Upgrade

A minor version private agent upgrade (Private Agent 10, version 10.x to 10.y, or Private Agent 11, version 11.x to 11.y) requires the agent to be stopped and restarted. A major version upgrade (Private Agent 10 to Private Agent 11) is the same, but requires a full synchronization of environments.

Tip

During synchronization, the agent is unable to process operations. To minimize agent downtime affecting your business processes, set up an agent group with multiple agents, and let agents fully synchronize before letting them process operations.

To upgrade a private agent on Linux, follow these steps:

  1. Download an installer package.

  2. Stop the agent.

  3. Make backup copies of the following files:

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

  4. In a terminal, run the following command for the downloaded installer type:

    apt-get upgrade <PATH>/jitterbit-agent_<VERSION>_amd64.deb

    yum upgrade <PATH>/jitterbit-agent-<VERSION>.x86_64.rpm
    as jitterbit
    tar -C /opt -xf <PATH>/jitterbit-agent-<VERSION>.x86_64.tar

  5. Compare the following files with your backup copies and restore any changed settings:

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

  6. If you have backup .crt or .key files that are not already in /opt/jitterbit/apache/conf/, copy them to that location.

  7. (Optional) If you must upgrade other agents in the same group, you can minimize the impact of agent downtime by using a rolling upgrade approach. To do this, open jitterbit-agent-config.properties file for editing, and add or set the property agent.starting.standby=true. (This keeps the agent in Starting status and prevents it from processing operations until the property value is set to false.)

  8. To start the agent, run this command:

    jitterbit start

  9. (Optional) If you are doing a rolling upgrade with the property value agent.starting.standby=true, and before upgrading another agent in the same group, monitor the agent log file for the following message:

    Agent synchronization for environment <123456> and agent group ID <987654> completed at ...

    This message indicates that the agent has completed environment synchronization. When it appears, edit jitterbit-agent-config.properties again, delete the property agent.starting.standby (or set it to false), then restart the agent.

Uninstall

To uninstall a private agent on Linux, follow these steps:

  1. Stop the agent.

  2. (Optional) Make backup copies of the following files:

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

  3. To remove the installation files (including PostgreSQL and its data directory), the service startup file, and the jitterbit user account, run these commands:

    apt-get remove --autoremove jitterbit-agent
userdel --remove --force jitterbit

    yum remove jitterbit-agent
userdel --remove --force jitterbit
    as root or with sudo
    yum remove python2 tar unixODBC unzip
userdel --remove --force jitterbit

Manage

You can start, stop, and show the status of a private agent with the jitterbit command. You can also use the Management Console to stop an agent remotely, but can only restart it again in a terminal on the host. Except for non-root installations, you can also restart the agent by restarting the host.

Agents started with automatic registration automatically de-register when stopped.

Start

It can take several minutes for a private agent to complete synchronization and be in running status. Private agents installed from a .deb or .rpm package file start automatically with the host. For non-root .tar file installations, you must add a system script to start the agent, or start it manually.

To start a private agent on Linux, run this command:

jitterbit start

Stop

A private agent can be stopped by a drain stop or a hard stop, using any of the methods shown in the following table:

Drain stop Hard stop
Management Console
Terminal command

Warning

A hard stop can result in data loss. A drain stop avoids data loss by waiting a configurable period (set by default to 180 seconds in agent.drainstop.api.wait) for any outstanding API calls to complete before shutting down the agent.

Drain stop

To drain stop a private agent on Linux, use either of these options:

  • From the Harmony Portal menu, select Management Console > Agents. From the Action column of the agent to be stopped, select Action > Drain Stop, then click OK in the confirmation dialog.

  • In a terminal, run the jitterbit-utils command:

    jitterbit-utils --drain-stop

Hard stop

To hard stop a private agent on Linux, run this command:

jitterbit stop

Pause

A private agent can be paused. In this state, the agent finishes any operations currently being processed, and does not process further operations. In the Management Console, the status is shown as Stopping.

To pause a private agent on Linux, run this command:

jitterbit-utils --drain-pause

To resume a paused agent on Linux, use the Start command.

Status

To see the agent's status, use either of these options:

  • From the Harmony Portal menu, select Management Console > Agents.

  • In a terminal session, run this command:

    jitterbit status