How do I upgrade ItemPath to a specific version? (On-Premise Only)

ItemPath 3

If you are already version 3.0.0.0 or later, you will first need to refresh the Deployment Manager, then follow the steps to update ItemPath. You can find these details instructions, including specifying the exact version you want to upgrade to, here: Updating ItemPath (ItemPath 3)

Upgrading from ItemPath 2 to ItemPath 3

IMPORTANT: If you are upgrading from ItemPath 2, version 2.4.25.10 and earlier, to ItemPath 3 (version 3.0.0.0 and later), you will first need to update to the latest version of ItemPath 2: 2.4.25.11.

Next, you'll want to follow the steps for installing the Deployment Manager and migrating from ItemPath 2 to ItemPath 3. You can find these detailed instructions, including specifying the exact version you want to upgrade to, here: Migrating from ItemPath 2 to ItemPath 3

ItemPath 2

If you are running ItemPath 2 (versions 2.0.0 to 2.4.25.11) and upgrading to a specific version of ItemPath 2, follow these steps.

Step 1: Backing Up

1. Confirm that there is a backup copy of the database.

2. Navigate to the root folder using cd ~. Use ls to check that the docker-compose.yml is there.

3. Make a copy (cp) of the docker-compose.yml file in the ItemPath/data/backups folder. Append the name of the file with -MM-YY so it can be distinguished from other copies.

Here's how the command might look:

cp docker-compose.yml ItemPath/data/backups/docker-compose-06-24.yml

Step 2: Tagging the File

1. Use vi docker-compose.yml to open the file.

2. For first-time tagging, use i to enter insert mode. Then, find each "image" and add a colon and the version number to the end of the line. For example:

image: ppgsupport/redis:2.11.0.0

In most cases, there will be 8 images to tag. "Certbot" does not need to be tagged.

When all 8 images have been tagged, use :wq to save and exit the file.

3. For subsequent tagging, you can use the "find and replace" command detailed here. Replace the version numbers in the command below to use:

:%s/OLDVERSIONNUMBER/NEWVERSIONNUMBER/g

This will replace all instances of the old version number. You can use :wq to save and exit the file.

Step 3: Upgrade

Check the file one last time to make sure all the images have been tagged correctly before upgrading, using docker-compose down && docker-compose pull && docker-compose up -d.

Note: If using Docker Compose V2, you will use docker compose (no hyphen) instead of docker-compose.