Upgrading Magnolia in the cloud
When a new version of Magnolia is released and available on the Cloud, you can upgrade your cloud environments directly from the cockpit.
|
We urge all cloud customers to upgrade their projects to the latest Magnolia LTS release within 60 days of the version release date. All new deployments must be based on the latest LTS version of Magnolia. |
You can also manage the automatic upgrade backup that is created for the Live environment from the cockpit. You can extend the period for which the backup is stored or restore it to roll back the upgrade. Alternatively, you can delete the upgrade backup manually to be able to tear down the Live environment again.
The Upgrade Flow
When you upgrade Magnolia in the Cloud, replica environments are created and checked before traffic is switched to the upgraded environment. This is the blue/green deployment model and it ensures that continuous delivery is possible and that there is a reliable production backup at all times. The visual below details the upgrade flow.
Upgrading the version of Magnolia
Before upgrading, we recommend you read the release notes for the version of Magnolia you are upgrading to.
|
Tips
|
-
In the Package overview page, click Manage updates in the Promoted releases section.
-
Click Change the version of Magnolia used in your environments:
-
Select the environment you want to upgrade: Live, UAT or Integration.
Note that we recommend starting with upgrading the integration environment and testing before moving on to UAT and, finally Live. -
Select the version of Magnolia you want to upgrade to. If nothing is displayed, this means there are no new versions of Magnolia available.
-
Confirm the consequences of the upgrade and click Install.
The upgrade process takes some time. As all actions in the cockpit are asynchronous, you can click on OK before the upgrade is complete: the action runs in the background and a notification appears once it is complete. The action also appears in the activity log.
Every automatic backup of the Live environment is stored for 48 hours. You can extend this to 5 days.
Until the automatic backup is removed, you cannot tear down your upgraded environment or upgrade the Live environment to the newer version.
| If you need to tear down the environment or upgrade the Live environment, you can remove the upgrade backup manually. |
Extending the upgrade backup storage period
Every automatic backup of the Live environment is stored for 48 hours. You can extend this to 5 days from the Package overview page by clicking on the Extend upgrade backup storage period link:
This link takes you to a wizard where you must confirm the extension you requested.
| If you need an extension for more than 5 days, please contact the Cloud Helpdesk. |
Deleting the upgrade backup
Until the automatic backup is removed, you cannot tear down your upgraded environment or upgrade the Live environment to the newer version.
| If you need to tear down the environment or upgrade the Live environment, you can delete the upgrade backup manually. |
-
In the Package overview page, click Manage environments in the Environments section.
-
Under Back up and Restore, click Delete Previous Installation.
-
Select the Live environment.
-
Click the Delete the upgrade backup button.
-
Confirm the consequences of the deletion and click Delete.
| Once the backup is deleted, you can tear down the Live environment. |
Restoring the upgrade backup
If you want to roll back the upgrade, you can restore the automatic upgrade backup.
-
In the Package overview page, click Manage environments in the Environments section.
-
Under Back up and Restore, click Restore Installation:
-
Select the Live environment.
-
Click the Restore the upgrade backup button.
-
Confirm the consequences of the deletion and click Restore.
| If you encounter issues with the upgrade process, please contact the Cloud Helpdesk. |