ClearML/clearml-docs
1
0
Fork 0
mirror of https://github.com/clearml/clearml-docs synced 2025-01-31 06:27:22 +00:00
Code Issues Actions 1 Packages Projects Releases Wiki Activity
58740d31e9
clearml-docs/docs/deploying_clearml/upgrade_server_win.md

2.6 KiB
Raw Blame History

title
Windows

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.

  2. Execute one of the following commands, depending upon the version that is being upgraded:

    • Upgrading ClearML Server version:

      docker-compose -f c:\opt\clearml\docker-compose-win10.yml down

    • Upgrading from Trains Server to ClearML Server:

      docker-compose -f c:\opt\trains\docker-compose-win10.yml down

  3. If upgrading from Trains Server version 0.15 or older, a data migration is required before continuing this upgrade. See instructions here.

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

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

    :::note For example, if the configuration is in c:\opt\clearml, then backup c:\opt\clearml\config and c:\opt\clearml\data. Before restoring, remove the old artifacts in c:\opt\clearml\config and c:\opt\clearml\data, and then restore. :::

  6. If upgrading from Trains Server to ClearML Server, rename /opt/trains and its subdirectories to /opt/clearml.

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

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

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

    docker-compose -f c:\opt\clearml\docker-compose-win10.yml pull
docker-compose -f c:\opt\clearml\docker-compose-win10.yml up -d

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