Skip to Content

Install a Linux Jitterbit private agent on Debian

Overview

These are the instructions on downloading and installing the Jitterbit 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 Configure a Linux private agent.

For RPM-based Linux systems, see Install a Linux private agent on RPM.

Software prerequisites

Note

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

Required libraries

Debian-based Linux private agents require these libraries to be installed:

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

Note

The listed libraries and the packages that contain them may be named differently depending on the Linux distribution used.

Install 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
$ sudo apt-get install python3
$ sudo ln -sf /usr/bin/python3 /usr/bin/python
$ sudo apt-get install libc6 libgcc1 libstdc++6 libuuid1 zlib1g

$ sudo apt-get update
$ sudo apt-get install python2
$ sudo ln -sf /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

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

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

  1. Log in to the Harmony portal and go to Management Console > Agents.

  2. Expand the agent group row.

  3. In the details pane, select the agent. 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.

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

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

  3. The Jitterbit 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.

Install 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 apt-get install ./jitterbit-agent_<VERSION>_amd64.deb

  4. The Jitterbit 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 Configure a Linux private agent.

Note

Jitterbit private agents cannot be started without completing the configuration step.

Important

Jitterbit private agents installed on Microsoft Azure servers require a reduced agent heartbeat interval.

For additional information on Linux private agents, see these resources: