Start Here

This guide describes the upgrade procedure for systems that are already running an OpenNebula Enterprise Edition 5.12.x or older. The upgrade to OpenNebula EE 6.8 can be done directly by following this section; you don’t need to perform intermediate version upgrades (for CE deployments, please see the Important Note below). 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.8.


Users of the Community Edition of OpenNebula can upgrade to the latest version only if they are running a non-commercial deployment, but they will need to upgrade first to the previous stable version. In order to access the latest migrator package, a request needs to be submitted through this online form.

Previous Steps

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.


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.


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.