Install a Linux Private Agent on Debian¶

Overview¶

These are the instructions on downloading and installing the Harmony Private Agent on a Debian-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 RPM-based Linux systems, see Installing a Linux Private Agent on RPM.

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¶

Debian-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 Debian or Ubuntu operating systems, run these commands:

$ sudo apt-get update

# Required for Ubuntu 22.04:
$ sudo apt-get install odbcinst

# Required for all operating systems:
$ sudo apt-get install python2
$ sudo ln -s /usr/bin/python2.7 /usr/bin/python
$ sudo apt-get install libc6 libgcc1 libstdc++6 libuuid1 zlib1g unixodbc sed unzip tar

Troubleshooting¶

If installing libraries fails with a message that you have broken packages (such as libgcc1), you can fix the installation and continue it with these commands. Follow any prompts you receive:

$ sudo apt --fix-broken install
$ sudo apt-get install libc6 libgcc1 libstdc++6 libuuid1 zlib1g unixodbc python sed sudo unzip tar

GLIBC Errors: If you are unable to install due to "GLIBC_2.14 not found" on certain older systems, edit /etc/apt/sources.list and add this line:

$ deb http://ftp.debian.org/debian/ jessie main

Then run:

$ sudo apt-get update
$ sudo apt-get -t experimental install libc6-dev

# Check that GLIBC is greater than or equal to 2.14:
$ ldd --version

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:

$ 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:

$ dpkg -s zlib1g

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 DEB.
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 a Private Agent using a Debian-based Linux 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 dpkg command to install the Debian package:

   $ dpkg --install jitterbit-agent_<VERSION>_amd64.deb
   

   If the command fails due to missing dependencies, the Harmony Private Agent package will be installed but not configured. Make sure all dependencies are satisfied (as described above), purge the package, and install it again:

   $ sudo dpkg --purge jitterbit-agent
   $ sudo dpkg --install jitterbit-agent_<VERSION>_amd64.deb
   

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 Debian (x64) in the Download column and copy the link address.

3. Install the Private Agent using these commands:

   $ sudo wget <URL FROM DOWNLOADS PAGE>
   $ sudo dpkg --install jitterbit-agent_<VERSION>_amd64.deb
   

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