Compatibility Guide 4.0
This guide is aimed at OpenNebula 3.8 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 guide
Visit the Features list and the Release Notes for a comprehensive list of what's new in OpenNebula 4.0.
onevm –schedule
option (#1483)<xterm> $ onetemplate instantiate 6 –cpu 2 –memory 1024 </xterm>
<xterm> VIRTUAL MACHINE HISTORY SEQ HOST ACTION REAS START TIME PROLOG
0 host02 live-migrate user 04/05 15:21:10 0d 00h00m 0h00m03s 1 host01 suspend user 04/05 15:21:24 0d 00h00m 0h00m00s
VID HOSTNAME ACTION REAS START_TIME END_TIME MEMORY CPU NET_RX NET_TX
0 host02 live-migrate user 04/05 15:21:10 04/05 15:21:27 128M 1 0.6K 0.2K 0 host01 suspend user 04/05 15:21:24 04/05 15:21:32 128M 1 0.6K 0.2K
</xterm>
@106 HOST/%100 MANAGE
Some onevm commands have been renamed. This is the complete list of onevm sub-commands:
OpenNebula 3.8 | OpenNebula 4.0 | |
---|---|---|
Creation | create | |
hold | ||
release | ||
Attribute updates | update | |
rename | ||
resize | ||
chgrp | ||
chown | ||
chmod | ||
Disk actions | attachdisk | disk-attach |
detachdisk | disk-detach | |
saveas | disk-snapshot | |
disk-snapshot –live | ||
Nic actions | nic-attach | |
nic-detach | ||
Scheduling and deployment | deploy | |
migrate | ||
livemigrate | migrate –live | |
resched | ||
unresched | ||
Power on and off | poweroff | |
poweroff –hard | ||
shutdown | ||
cancel | shutdown –hard | |
reboot | ||
reset | reboot –hard | |
restart | boot | |
undeploy | ||
undeploy –hard | ||
Deletion | delete | delete |
resubmit | delete –recreate | |
Stop/Resume | stop | |
suspend | ||
resume | ||
VM Snapshots | snapshot-create | |
snapshot-revert | ||
snapshot-delete | ||
Query | list | |
show | ||
top |
New CLI commands:
Changed CLI commands:
–hold
for 'onevm create' and 'onetemplate instantiate'. Using this flag, the new VMs are created on hold state instead of pending. VMs in this state are ignored by the scheduler, giving users the chance release them later or to deploy them manually.–enforce
for 'onevm deploy' and 'onevm migrate'. Using this flag, the core will enforce that the target host's capacity is not overcommitted.Options:
–user
and –password
are available for all commands. They replace the current credentials, making it easier for administrators to quicky execute commands as another user.Some of these changes are better explained, with examples, in this blog post.
REQUIREMENTS=“\”/HOST/HOST_SHARE/MAX_MEM\“ > 0”
(#1747)sunstone-plugins
are now configured using the new Sunstone views. This is a new feature that allows you to customize the UI for different users or user groups, so the interface implements the provisioning model for each role.3.8 values: NONE = 0 Normal termination ERROR = 1 The VM ended in error STOP_RESUME = 2 Stop/resume request USER = 3 Migration request CANCEL = 4 Cancel request 4.0 values: NONE = 0 History record is not closed yet ERROR = 1 History record was closed because of an error USER = 2 History record was closed because of a user action
New xml-rpc methods:
Changed xml-rpc methods:
require 'opennebula'
<xterm> $ gem install opennebula-oca –pre </xterm>
X509:
RAW = "<devices><serial type=\"pty\"><source path=\"/dev/pts/5\"/><target port=\"0\"/></serial><console type=\"pty\" tty=\"/dev/pts/5\"><source path=\"/dev/pts/5\"/><target port=\"0\"/></console></devices>"
Changes in /ect/one/oned.conf
im_kvm
changed to kvm
, vmm_xen
to xen
and so on. To add a kvm
host the command will be:<xterm> $ onehost create host_name –im kvm –vm kvm –net dummy </xterm>
Changes in /etc/one/sunstone-server.conf
Changes in /etc/one/auth/x509_auth.conf
:check_crl: true
Changes in /var/lib/one/remotes/vmm/kvm/kvmrc
Changes in /etc/one/occi-server.conf
Changes in EC2 Server configuration files: