Install a Linux Private Agent on RPM¶

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.

Software Prerequisites¶

Required Commands¶

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

python
sed
sudo
tar
unixodbc
unzip

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

Required Libraries¶

RPM-based Linux Private Agents require these libraries to be installed:

libc.so.6
libgcc_s.so.1
libm.so.6
librt.so.1
libstdc++.so.6
libuuid.so.1
libz.so.1

Installing Required Libraries¶

To install the required libraries and update the required packages on 64-bit RHEL 7 and 8, or Amazon Linux AMI, run these commands:

$ sudo dnf update

# Required for Amazon Linux AMI:
$ sudo dnf -y install libgcc44 libstdc++44

# Required for all operating systems:
$ sudo dnf -y install python2 sed sudo unixODBC unzip tar
$ sudo dnf install libnsl.so.1
$ sudo dnf install libnsl
$ sudo ln -s /usr/bin/python2.7 /usr/bin/python

Troubleshooting¶

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

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 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.

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 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 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 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.

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

• Restarting a Linux Private Agent
• Upgrading or Uninstalling a Linux Private Agent