clearml-docs/docs/deploying_clearml/upgrade_server_gcp.md

title

title
Google Cloud Platform

MongoDB major version was upgraded from v5.x to 6.x. Please note that if your current ClearML Server version is older than v1.17 (where MongoDB v5.x was first used), you'll need to first upgrade to ClearML Server v1.17.

First upgrade to ClearML Server v1.17 following the procedure below and using this docker-compose file. Once successfully upgraded, you can proceed to upgrade to v2.x.

To upgrade ClearML Server Docker deployment:

1. Shut down the docker containers with the following command:

   docker-compose -f docker-compose.yml down
   

2. If upgrading from Trains Server version 0.15 or older to ClearML Server, do the following:

   1. Follow these data migration instructions, and then continue this upgrade.

   2. Rename /opt/trains and its subdirectories to /opt/clearml:

      sudo mv /opt/trains /opt/clearml
      

3. If upgrading from ClearML Server version older than 1.2, you need to migrate your data before upgrading your server. See instructions here.

4. Backing up data is recommended, and if the configuration folder is not empty, backing up the configuration.

5. Download the latest docker-compose.yml file:

   curl https://raw.githubusercontent.com/allegroai/clearml-server/master/docker/docker-compose.yml -o /opt/clearml/docker-compose.yml
   

6. Startup ClearML Server. This automatically pulls the latest ClearML Server build.

   docker-compose -f /opt/clearml/docker-compose.yml pull
   docker-compose -f /opt/clearml/docker-compose.yml up -d
   

If issues arise during your upgrade, see the FAQ page, How do I fix Docker upgrade errors?