Skip to main content

Jama Connect Interchange User Guide

Upgrade Jama Connect Interchange (self-hosted)

Complete the following procedure to upgrade your self-hosted instance of Jama Connect Interchange to a new version.

To upgrade Jama Connect Interchange:

  1. Open the upgrade notification email from Jama Software, download the installation package, and copy it to the host system.

  2. While JCI services are running, create a backup of the database before performing the upgrade:

    sudo docker exec mysql-interchange /usr/bin/mysqldump -u root --password=password configDB > config_backup.sql
sudo docker exec mysql-interchange /usr/bin/mysqldump -u root --password=password logDB > log_backup.sql

  3. Navigate to the Jama Connect Interchange installation directory and stop the service:

    cd /opt/jci 
sudo docker compose down  

  4. Untar the archive of Docker images to the target directory:

    sudo tar -xf jci-self-host-{VERSION_TAG}.tar.gz -C /opt/jci/   

    The archive includes an additional tarball and a Docker compose file.

  5. Load the images into the system registry from the tarball:

    sudo docker load < /opt/jci/jci-self-host-{VERSION_TAG}.tar   

  6. Navigate to the installation directory and restart Jama Connect Interchange:

    cd /opt/jci 
sudo docker compose up -d
In this section: