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.
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.
See the warning above. After you get the ‘opennebula-migration-community’ package, you need to install it in the OpenNebula Front-end:
rpm -i opennebula-migration-community*.rpm
dpkg -i opennebula-migration-community*.deb
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.
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.
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.