Installing 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

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

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

To install the required 32-bit libraries and update the required packages on 64-bit Debian or Ubuntu operating system, run this command:

$ sudo apt-get update
$ sudo apt-get install libc6:i386 libgcc1:i386 libstdc++6:i386 libuuid1:i386 zlib1g:i386 libc6 libgcc1 libstdc++6 libuuid1 zlib1g python sed sudo unixodbc unzip tar
$ sudo apt-get -t experimental install libc6-dev
$ ldd --version   
// check that GLIBC is greater than or equal to 2.14
$ sudo dpkg -s zlib1g:i386

Troubleshooting

If the installation of 32-bit libraries fails, you may have to add the repository for 32-bit packages with these commands:

$ sudo dpkg --add-architecture i386
$ sudo apt-get update    

If installing libraries fails with a message that you have broken packages (such as libgcc1 and libgcc1:i386), 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
$ ldd --version
// check that GLIBC is greater than or equal to 2.14

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

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

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

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