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.