This guide is aimed at OpenNebula 5.10.x users and administrators who want to upgrade to the latest version. The following sections summarize the new features and usage changes that should be taken into account, or prone to cause confusion. You can check the upgrade process in the following section
Network Driver actions interface¶
The way arguments are passed to the pre/post/clean/update_sg has changed as follows:
- The old argument 1
vm xml templateit is now sent through by
- The old argument 2
vm deploy idnow is argument 1
- There is no argument 2
This change has been introduced because of this bug.
Storage Driver actions interface¶
On premigrate and postmigrate scripts, the old last argument
vm xml template it is now sent via by
stdin. In consequence, there is an argument less.
This change has been introduced due to this bug.
Bridge Interface options¶
Bridge utils (brctl) became obsolete they were replaced by
ip-route2. Bridge options for
ip command could be specified in
:ip_bridge_conf but for backward compatibility the section
:bridge_conf is still accepted and options are transformed to the
Password Hashing Algorithm Update¶
User passwords and login tokens are now generated using SHA256 instead of SHA1. OpenNebula core will update users passwords in the database when they first login in the system. It is recommened to request your users to login after the upgrade.
OpenNebula now ships with distribution packages for all required Ruby gems, executing of the
install_gems script after installation or upgrade is not necessary anymore. Ruby dependencies are installed into a dedicated directory
/usr/share/one/gems-dist/ and OpenNebula uses them exclusively via symlinked location
/usr/share/one/gems/. System-wide Ruby gems are not used anymore! Any Ruby gems needed by the custom drivers need to be installed again into a new dedicated location. Check the details in Front-end Installation.
If Sunstone is running via Passenger in Apache, it might be necessary to set
GEMS_PATH environment variables to
/usr/share/one/gems/ to force the Ruby running inside the web server to use these new location. Check the details in Sunstone for Large Deployments.
IPAM driver scripts now recieve the template of the AR via STDIN instead of via arguments.
DEFAULT_DEVICE_PREFIX configuration variable is now set to
sd by default.
Hooks have been redesign and you need to update your hook definition to the new system. Please, follow the instructions in the upgrade guide to update your hooks.