Skip to end of metadata
Go to start of metadata

Overview

These are the instructions on downloading and installing the Harmony Private Agent on a RPM-based Linux system. Prior to installation, we recommend reviewing Agent Groups High Availability and Load Balancing and Private Agents Best Practices Tech Talk.

For information on system requirements, see System Requirements for Linux Private Agents.

For information on configuring the installed Linux Private Agent, see Configuring a Linux Private Agent.

For Debian-based Linux systems, see Installing a Linux Private Agent on Debian.

NOTE: As of Jitterbit Harmony release 10.34, 32-bit Private Agents will no longer be available for download. If you are currently using a 32-bit agent and want to follow our recommendation of staying on the current release, download a 64-bit agent and perform an upgrade. Instructions for upgrading to a 64-bit agent are available. This change does not affect Cloud Agents.

Software Prerequisites

Required Commands

To install the jitterbit-agent package, these commands must be available:

Required Commands
python
sed
sudo
tar
unixodbc
unzip

You can test the availability of a command by running the which command.

NOTE: The root user on your server must have access to the sudo command.

Required Libraries

Though Jitterbit Harmony Private Agents are not built natively to run in 64-bit mode on 64-bit distributions, Jitterbit requires running the agent on a 64-bit operating system with the required 32-bit libraries installed.

You will need these 32-bit libraries (they should come as part of even a minimal installation of any supported distribution; these packages may be named differently depending on the distribution):

32-bit Libraries
libc.so.6
libgcc_s.so.1
libm.so.6
librt.so.1
libstdc++.so.6
libuuid.so.1
libz.so.1

Installing Required 32-bit Libraries

If using Amazon Linux AMI, first run this command to update required packages:

Amazon Linux AMI
$ sudo dnf update
$ sudo yum -y install libgcc44.i686 libstdc++44.i686

To install the required 32-bit libraries and update the required packages on 64-bit RHEL (CentOS) 6 and 7, or Amazon Linux AMI, run this command:

$ sudo dnf -y install glibc.i686 libgcc.i686 libstdc++.i686 libuuid.i686 zlib.i686 pam.i686 cyrus-sasl-lib.i686 libicu.i686 python2 sed sudo unixODBC unzip tar
$ sudo dnf -y install libnsl.so.1
$ sudo dnf -y install libnsl
$ sudo ln -s /usr/bin/python2 /usr/bin/python

Troubleshooting

Multilib version problems found: If installing 32-bit libraries fails on Red Hat systems with "Error: Multilib version problems found", then you may need to apply upgrades to the operating system (using $ sudo yum update) and try again in order to bring the 64-bit libraries up-to-date with the 32-bit version that you are trying to install.

You may find that installing the development version of the libraries may resolve these errors. Replace the install step listed above for RPM-based systems with:

$ sudo yum update
$ sudo yum -y install libuuid-devel.i686 zlib.i686 pam.i686 cyrus-sasl-lib.i686 libicu.i686 python sed sudo unixODBC unzip tar

Broken or missing dependency: If you have a library with a broken or missing dependency, check for proper links to the source by using the ldd command to return a list of dependencies. For example:

$ sudo ldd /opt/jitterbit/lib/libkonga-zip.so

You can also use the package name to check the installation status of the dependency, using the same naming convention as for installation:

$ sudo yum list installed libgcc.i686

Downloading the Linux Private Agent

These instructions on downloading a Linux Private Agent assume you have already created an Agent Group, Agent(s), and an environment for your organization within the Management Console. Refer to Agents > Agent Groups and Agents > Agents for more information.

  1. Log in to the Jitterbit Harmony Portal and go to the Management Console > Agents > Agent Groups
  2. In the upper portion of the screen, select the Agent Group row. The lower half of the screen should now list the Available Agents within the selected Agent Group.
  3. In the lower portion of the screen, select the agent row. Then click the Action dropdown on the far right and select Download for Linux RPM.
  4. The Linux agent executable can be downloaded once, stored locally, and reused to install any additional Private Agents as they are added.

Installing an Agent

All installation commands require root access. We recommend using a command line for installation, as the installation generates important messages.

NOTE: The root user on your server must have access to the sudo command.

To install and configure a Private Agent using a RPM-based operating system, follow these steps:

  1. Use this command to navigate to the directory where the Private Agent download is located:

    $ sudo cd <DIRECTORY>
  2.  Use this yum command to install the RPM package. All package dependencies will be automatically downloaded and installed:

    $ sudo yum install jitterbit-agent-<VERSION>.x86_64.rpm
  3. The Jitterbit Harmony Private Agent is installed in /opt/jitterbit This location cannot be changed.
  4. Upon successful installation, the name of the installed package is jitterbit-agent.

Installing an Agent with wget

Alternatively, you can install a Linux Private Agent using the wget command following these steps:

  1. Log in to the Jitterbit Harmony Portal and navigate to the Downloads page.
  2. In the Jitterbit Agent row, right-click Linux RPM (x64) or Linux Redhat Non-Root (x64) in the Download column and copy the link address.
  3. Install the Private Agent using these commands: 

    $ sudo ln -s /usr/bin/python2 /usr/bin/python
    $ sudo dnf install wget
    $ sudo wget <URL FROM DOWNLOADS PAGE> 
    $ sudo dnf install jitterbit-agent-<VERSION>-38.x86_64.rpm
  4. The Jitterbit Harmony Private Agent is installed in /opt/jitterbit This location cannot be changed.
  5. Upon successful installation, the name of the installed package is jitterbit-agent.

Next Steps

For information on configuring the installed Linux Private Agent, see Configuring a Linux Private Agent.

NOTE: Jitterbit Harmony Private Agents cannot be started without completing the configuration step.

For additional information on Linux Private Agents, see these resources: 

  • No labels