Overview

These are the instructions on upgrading or uninstalling a Linux Private Agent on Debian and RPM based Linux distributions. 

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

For documentation on how to accomplish certain tasks with Jitterbit Harmony Private Agents, see Private Agent How-tos

For documentation on overcoming challenges with Jitterbit Harmony Private Agents, see Private Agent Troubleshooting

Upgrading an Agent

WARNING: Upgrading from a 32-bit to a 64-bit Linux Private Agent

  • Existing 32-bit agent versions must be uninstalled prior to upgrading (see instructions for Linux Uninstall).
  • Existing PostgreSQL and PostgreSQL driver (psqlODBC or pODBC) installations must be uninstalled.
  • Existing 32-bit ODBC drivers are not supported.

NOTE: If you are upgrading an existing 64-bit version agent to a higher 64-bit version agent, you do not need to uninstall the existing agent before upgrading. 

NOTE: If you are upgrading from version 10.37 to 10.38, see Known Issues on Installing a Jitterbit Harmony Linux Agent for information on a known issue that occurs during the Private Agent upgrade. 

Upgrading the Private Agent package on Linux can be performed by using the same commands used during initial installation. You do not need to run the configuration script when upgrading an existing Private Agent.

When upgrading a Linux Private Agent from a pre-10.37 version to a version that is 10.37 or later, the PostgreSQL database will be reinitialized as it is upgraded to version 9.6. This upgrade will recreate the database on your Private Agent and your data will be recovered during this upgrade process. After the upgrade, any backups created using an earlier PostgreSQL version will not be compatible. The upgrade process can take more than 30 minutes depending on the number of projects and the size of the environments associated with your Private Agent group. Any pending jobs will be put in a pending queue to be run after the upgrade is complete.

A Private Agent takes a short time to upgrade—approximately three minutes—depending on the server. If having an outage is a concern, you can use high availability (two or more agents) and have no downtime. If your current subscription does not have additional agents available for this, contact your Customer Success Manager (CSM).

To upgrade a Private Agent, follow these steps:

  1. Check if you need to uninstall the agent first, based on the installed Private Agent type: is it 32-bit or 64-bit? (optional; see Determining Installed Agent Type and Uninstall Agent below)
  2. Install the new version of the agent. For more information, see Installing a Jitterbit Harmony Linux Agent (Debian or RPM)

    NOTE: All configuration files are retained during a Private Agent upgrade.

Determining the Installed Agent Type

To determine the type of agent that you have installed (either a 32-bit or a 64-bit), you can use a command to check which packages are installed. If you are upgrading from 32-bit to 64-bit Private Agent, you must uninstall the current agent first.

Use the  dpkg  command to check the installed jitterbit-agent package:

$ dpkg -l | grep 'jitterbit-agent'

This will return output that includes either i386 (for 32-bit) or amd64 (for 64-bit), such as:

ii  jitterbit-agent:i386      10.xx.x.x      i386       Jitterbit Agent
ii  jitterbit-agent:amd64     10.xx.x.x      amd64      Jitterbit Agent

Use the rpm command to check the installed jitterbit-agent package:

$ rpm -qi `rpm -qa | grep jitterbit-agent` | grep Architecture:

This will return output that includes either i386 (for 32-bit) or amd64 (for 64-bit), such as:

Architecture: i386
Architecture: amd64

Rolling Back an Agent

It is not expected to be required to revert to a previous version of a Private Agent. However, should it be required, these are the steps:

  1. Back up the configuration files and security certificates (optional; see Uninstall Agent below).
  2. Uninstall the agent (see Uninstall Agent below).
  3. Remove all Jitterbit-related files (see Uninstall Agent below).
  4. Install the selected version of the agent. See Installing a Jitterbit Harmony Linux Agent (Debian or RPM).
  5. To use your backup files (optional):
    1. Stop agent services (see Restarting a Linux Private Agent).
    2. Place your saved configuration files and security certificates in the installation directory.
    3. Start agent services (see Restarting a Linux Private Agent).

Uninstalling an Agent

Before uninstalling, it is recommended to copy the configuration files and security certificates for your current installation in case you want to reinstall with the same configuration in the future. These are typically located at:

/opt/jitterbit/jitterbit.conf
/opt/jitterbit/apache/conf/httpd.conf
/opt/jitterbit/JdbcDrivers.conf
/opt/jitterbit/Resources/jitterbit-agent-config.properties 
/opt/jitterbit/Resources/credentials.txt
/opt/jitterbit/apache/conf/extra/
/opt/jitterbit/apache/conf/ssl.crt/
/opt/jitterbit/apache/conf/ssl.key/

NOTE: To be able to use your backup files in a future installation, you must stop services while you move the files over, then restart services once completed (see Restarting a Linux Private Agent).

Use this dpkg command to uninstall the Jitterbit Harmony Private Agent:

$ sudo dpkg --remove jitterbit-agent

 You can also use the apt-get command to uninstall the Jitterbit Harmony Private Agent:

$ sudo apt-get remove jitterbit-agent

Use this yum command to uninstall the Jitterbit Harmony Private Agent:

$ yum remove jitterbit-agent

You can also use this rpm command to uninstall the Jitterbit Harmony Private Agent:

$ rpm --erase jitterbit-agent

Removing All Jitterbit-related Files

The uninstall will remove the files installed during the installation. The /opt/jitterbit directory and Jitterbit Harmony Private Agent database are not automatically erased, and may include log files and application files generated when running operations. To completely remove all Jitterbit-related files, use these two commands:

$ sudo rm -rf /opt/jitterbit
$ sudo rm -rf /tmp/jitterbit

Next Steps

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

For documentation on how to accomplish certain tasks with Jitterbit Harmony Private Agents, see Private Agent How-tos

For documentation on overcoming challenges with Jitterbit Harmony Private Agents, see Private Agent Troubleshooting