Upgrading Tines on Docker Compose

❗️Important

Pre-upgrade recommendations 

Before upgrading, we advise that you backup your data following the recommendations here.

Step 1. Downloading upgrade package  

You will need to have an active Cloud tenant to access the latest self-hosted version of Tines. Download the Tines installation package using the following link:

https://<your cloud tenant name>.tines.com/admin/upgrade

For example

https://quiet-sky-3834.tines.com/admin/upgrade

The file will be a zip archive named as follows: tines_<build id>.zip. 

Unzip the archive and upload it to the host machine where Tines is installed. 

Step 2. Move files to the installation directory  

Unzip the installation package and move all the files to the tines installation directory: 

unzip tines_<build_id>.zip 

cp -rT tines_<build_id>/ /opt/tines  

Step 3. Running upgrade script  

The installation package includes an upgrade script, upgrade.sh. Ensure it is executable with the following command: 

chmod +x upgrade.sh

Run the upgrade script: 

./upgrade.sh 

When the upgrade script runs it will attempt to back up the database. To do this, it will print a list of volumes where the database data may be stored. When prompted, type the correct volume (under default conditions there will only be one). 

 

Troubleshooting  

If Tines did not start after running ​docker-compose up​, check the console for relevant errors. You can also use steps in our Troubleshooting Tines on Docker Compose to diagnose the issue.

Contact ​support@tines.io​ with the output of ​upgrade.sh script and docker-compose logs​.

Upgrading Redis 

Tines 14.0 and above requires Redis 6.2 or above, Tines 31.2 recommends using Redis 7.0. If you were previously running Tines 13.x or below then you'll need to change the version of the Redis Docker image used in your installation. This can be done at any stage before upgrading to 14.x or above - Redis 6.2 is compatible with all previous Tines versions.

To do this you need to:

  1. Open a terminal in your installation directory (typically /opt/tines).

  2. Run docker-compose stop to stop your installation's Docker containers. This will completely stop your installation until you restart the containers later, so be aware that this will cause downtime.

  3. Open the docker-compose.yml file in your installation directory.

  4. Edit the image key under the redis service in that file to use the image you require, redis:x.x-alpine.

  5. Save your changes to the docker-compose.yml file and run docker-compose up -d - this will restart your installation with the new Redis image.

Was this helpful?