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

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.