Skip to main content
System StatusContact Support

Documentation related to the following products will soon be moved to a new portal: ( Agility, Agility Connect and Agility Integrations Continuum and ALM Connect
Links from the site will automatically redirect to the new site.
If you have any questions, please contact Support. Agility Community

Upgrading Agility Connect


At the present time upgrading Agility Connect is a manual, decision-based process. The upgrade process is quick and painless but does require an outage. This means that you will need to select a period of downtime where pipelines, automation, user logins, etc. may be interrupted. Usually, this period of time is seconds, not minutes. Our goal is to get to a zero-downtime upgrade in the future.

If the Agility Connect server does not have direct outbound access to the internet you will need to download the file to the Agility Connect server using an intermediate step such as your desktop, then get the file to the server using sftp or some other protocol.

Step 1. Download the Upgrade File

You may have received an email with a link to download the latest release of Agility Connect. Use this link in the following command.

curl -O "download link here"

Or if you prefer `wget`:

wget -O "download link here"

Step 2. Run the Upgrade

Make sure you run the following steps as the Agility Connect application owner on the Agility Connect server.

# make the installer executable

chmod +x downloadedfile

# run the executable, using silent mode (no prompting)


The upgrade process performs the following actions:

  • Stops the Agility Connect services

  • Installs the new files into a new directory under $CONTINUUM_HOME (usually under /opt/continuum unless you have changed the default Agility Connect installation directories. See Change the Default Installation Directories for more information.)

If you have Agility Connect installed on a custom location and are now upgrading, the Agility Connect installer installs Agility Connect on the same directories where it was installed earlier. Any new paths passed with the installer script during such upgrades are ignored.

  • Changes a symbolic link /opt/continuum/current to point to the new directory

  • Performs any database change scripts that may be included

  • Restarts the Agility Connect services

At this point you should be able to log back into the Agility Connect application and its service is returned to normal.

Rolling Back to a Previous Release

If for any reason you need to rollback to a previous release, you can use the following commands to perform the rollback.

First do a directory listing of the Agility Connect install directory. The following link will list in chronological order from oldest to newest.

ls -ltr /opt/continuum
total 12
drwxrwxr-x  3 continuum continuum 4096 Jan 30 11:20 python
drwxrwxr-x  9 continuum continuum 4096 Mar 24 13:57
drwxrwxr-x  9 continuum continuum 4096 Apr  3 14:50
lrwxrwxrwx  1 continuum continuum   25 Apr  3 14:56 current -> /opt/continuum/

You will notice at least one symbolic link named "current" and another actual directory containing the Agility Connect software. If there has been more than one installation, there will be other directories with a different naming convention for the older installs.

The objective of the rollback will be to stop the Agility Connect services, change the symbolic link named "current" to point to one of the other Agility Connect install directories and restart the services. 

From the "ls" command output, choose the Agility Connect install directory to switch to. Then substitute it in the commands below where you see "". 

rm /opt/continuum/current
ln -s /opt/continuum/ /opt/continuum/current

Login and check your data.

At this time there is no way to rollback the database version in Agility Connect. However we make our best effort to make database modification additive so as to not affect previous releases adversely.