OpenNebula Upgrade Workflow

This section describes the typical OpenNebula upgrade process incorporating the OneScape.

Important

For each OpenNebula upgrade (even between minor versions, e.g. 5.10.2 and 5.10.3), configuration files must be processed via ‘onecfg upgrade’! If you skip configuration upgrade step for some OpenNebula upgrade, the tool will lose the current version state and you’ll have to handle files upgrade manually and reinitialize the configuration version management state.

onecfg upgrade
FATAL : FAILED - Configuration can't be processed as it looks outdated!
You must have missed to run 'onecfg update' after previous OpenNebula upgrade.
onecfg status
--- Versions ------------------------------
OpenNebula:  5.10.1
Config:      5.8.0
ERROR: Configurations metadata are outdated.

Step 1 - Get OneScape

Follow the installation section to install or update the existing OneScape installation.

Note

New OpenNebula major releases require the latest OneScape. You may experience the following error if your OneScape version is too old:

onecfg status
--- Versions ------------------------------
OpenNebula:  5.10.2
Config:      5.8.0
ERROR: Unsupported OpenNebula version 5.10.2

Step 2 - Upgrade OpenNebula

Update your OpenNebula packages by following Upgrading from OpenNebula X.Y document from official OpenNebula Documentation for the version you are upgrading to.

Important

It’s necessary to upgrade your current OpenNebula directly to 5.10.2 or later, which supports the automatic configuration backups.

Step 3 - Update Configurations

This action is usually mentioned in the Upgrading from OpenNebula X.Y as a manual step before upgrading the database. OneScape configuration module completely automates the step by running onecfg upgrade. Follow onecfg upgrade documentation on how to upgrade and troubleshoot the configurations.

Important

Configuration upgrade must be done after each OpenNebula upgrade!

Step 4 - Finish Upgrade

Follow the rest steps from Upgrading from OpenNebula X.Y document. It might be necessary to upgrade database, or do some other OpenNebula version-specific steps.

Step 5 - Validation

When all steps are done, run the OpenNebula and check the working state.

Check the configuration state via onecfg status. There shouldn’t be any errors and no new updates available. Your configuration should be current to the installed OpenNebula version. For example:

onecfg status
--- Versions ------------------------------
OpenNebula:  5.10.2
Config:      5.10.0

--- Available Configuration Updates -------
No updates available.