This guide describes the procedure for performing an in-place upgrade of Coriolis service containers using the console upgrade option introduced in Coriolis v2603.0.
The upgrade is performed directly from the Coriolis Console and updates the running Coriolis service containers to the specified version.
1. Prerequisites and Preparation
Before initiating the upgrade, verify the following requirements.
- Confirm the upgrade path with the Coriolis Support Team
- Check for the supported versions and for any major changes.
- Perform the upgrade during a planned maintenance window.
- Create a full backup or snapshot of the Coriolis virtual appliance.
- Verify Available Disk Space
- Ensure the appliance has sufficient free disk space; the recommended usage threshold should be <80%.
- Schedule a Maintenance Window
- The upgrade process temporarily stops Coriolis services, and migration/DR jobs will not run during the upgrade process.
- The Coriolis appliance must have internet access to download the container images, either directly or through an HTTP/HTTPS proxy.
2. Verify Current Coriolis Version
Before starting the upgrade, determine the currently installed Coriolis version.
Step 1 – Access the Coriolis Console
From the Coriolis virtual appliance console, access the CLI.
Step 2 – Check the Installed Version
Run the following command and save the version number.
|
1 |
cat /etc/coriolis/coriolis.release |
Now you can return to the main console menu with the options.
When exiting the CLI, select Not to restart the Coriolis containers.
3. Performing the Upgrade
Step 1 – From the Coriolis Console menu, choose:
|
1 |
13) Upgrade Coriolis Services |
Step 2 – Specify Target Version
You will be prompted to enter the Coriolis version to upgrade to, for example:
|
1 |
2603.2 |
Important:
- The target version must be newer than the currently installed version
- Downgrades are not supported
- Upgrading versions older than 2603.0 to this release is only available through Coriolis Support.
Step 3 – Confirm Upgrade
Confirm the selected version when prompted. After that is provided, the upgrade process begins.
4. Upgrade Process
During the upgrade, the appliance will download the new container images and update all the Coriolis service containers. This operation may take several minutes to complete.
Do not interrupt the upgrade process or press any keys while it is running, as this may corrupt the appliance. The console should be kept open and monitored for any events or messages showing the progress.
5. Upgrade Completion
Once the upgrade process completes successfully, you will see the following screen. Indicating that the Ansible playbook finished and control has returned to the Coriolis Console. This indicates the upgrade process has completed successfully and the Coriolis services are running with the new version.
6. Post-Upgrade Verification
After the upgrade, it is recommended to check the following:
- Verify the installed version as outlined in step 2 above, and confirm that it matches the target upgrade version.
- Log in to the Coriolis web UI interface and browse through the options.
- When using DR, monitor the scheduled jobs to successfully resume and run as set.
- For Migrations, observe for any new settings and verify that new executions are running without errors.