Start Here

This guide describes the upgrade procedure for systems that are already running OpenNebula 6.0.x or newer. 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 learn what’s new in OpenNebula 7.2.

Previous Steps

OpenNebula 7.0 or newer is distributed with onecfg as part of the main server package. This tool simplifies the upgrade process of configuration files, and is always included in the latest version of OpenNebula.

Important

For each OpenNebula upgrade (even between minor versions, e.g. 6.10.2 and 6.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:

Upgrading Contextualization Packages

When upgrading your OpenNebula infrastructure, you do not need to execute a massive update of the contextualization packages of all your running Virtual Machines. For details on the highly flexible compatibility support between contextualization and infrastructure versions, see the Contextualization page

To ensure stability and minimize disruption, follow these best practice recommendations:

Keep Running VMs as They Are: Do not update the context packages of currently running VMs during an infrastructure upgrade. The new OpenNebula version will continue to manage them without issue.
Update Context on Golden Images: Update the contextualization packages on your customized “golden” images and templates. This ensures that all new VMs provisioned after the upgrade will utilize the latest contextualization features.
Targeted Updates for Running VMs: Only update the context package on an actively running VM if you specifically need a new feature introduced in the newer context version, or if you need to resolve a known bug that impacts that specific VM.

You can find the installation and upgrade instructions in the one-apps wiki for Linux and Windows guest VMs.

GIVE FEEDBACK

Was this resource helpful?

Glad to hear it

Sorry to hear that