Start Here

This guide describes the upgrade procedure for systems that are already running a 5.12.x OpenNebula Enterprise Edition or older. The upgrade to OpenNebula 6.0 can be done directly by following this section; you don’t need to perform intermediate version upgrades. The upgrade will preserve all current users, Hosts, resources and configurations, for both SQLite and MySQL/MariaDB Back-ends.

Read the Compatibility Guide and Release Notes to know what’s new in OpenNebula 6.0.

Important

Users of the Community Edition of OpenNebula can upgrade from the previous stable version if they are running a non-commercial OpenNebula cloud. In order to access the migrator package a request needs to be made through this online form.

Previous Steps

Community Edition

See the warning above. After you get the ‘opennebula-migration-community’ package, you need to install it in the OpenNebula Front-end:

CentOS/RHEL

rpm -i opennebula-migration-community*.rpm

Debian/Ubuntu

dpkg -i opennebula-migration-community*.deb

Enterprise Edition

Enterprise Edition is distributed with a tool onecfg as part of the main server package (in 5.12 and earlier it was provided via the OneScape project and repository). This tool simplifies the upgrade process of configuration files and always comes in the latest version of OpenNebula.

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 the configuration upgrade step for an OpenNebula upgrade, the tool will lose the current version state and you’ll have to handle the 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
...
ERROR: Configurations metadata are outdated.

Upgrade OpenNebula

Update your OpenNebula packages by following only the guide that applies to your current OpenNebula configuration:

Follow onecfg upgrade documentation for information on how to upgrade and troubleshoot the configurations.

Important

Please read the corresponding guides (only the one that applies to the specific version you are upgrading from) if you are upgrading from OpenNebula 5.6 or 5.8 and make sure you apply all the required changes described in the corresponding guide.

Validate OpenNebula

When all steps are done, run 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 up-to-date for the currently installed OpenNebula version. For example:

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

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