Virtual Machines States Reference¶
This page is a complete reference of all the VM states that will be useful for administrators doing troubleshooting and developers.
The simplified life-cycle is explained in the Managing Virtual Machines guide. That simplified diagram uses a smaller number of state names. These names are the ones used by onevm list, e.g. prolog
, prolog_migrate
and prolog_resume
are all presented as prol
. It is intended as a reference for end-users. That section should be enough for end-users and every-day administration tasks.
List of States¶
In OpenNebula a Virtual Machine has 2 variables to define its state: STATE
and LCM_STATE
. The LCM_STATE
is only relevant when the STATE
is ACTIVE
. Both states can be seen from the CLI (onevm show
) and from Sunstone (Info panel for the VM).
Note
LCM_INIT
state is used as LCM_STATE
when the VM is in a state different than ACTIVE
.
# |
State |
# |
LCM State |
Short State Alias |
Meaning |
---|---|---|---|---|---|
0 |
INIT |
|
Internal initialization state right after VM creation, this state is not visible for the end users. And hence this state cannot be used to hook any action. |
||
1 |
PENDING |
|
By default a VM starts in the pending state, waiting for a resource to run on. It will stay in this state until the scheduler decides to deploy it, or the user deploys it using the |
||
2 |
HOLD |
|
The owner has held the VM and it will not be scheduled until it is released. It can be, however, deployed manually. |
||
3 |
ACTIVE |
0 |
LCM_INIT |
|
Internal initialization state, not visible for the end users |
1 |
PROLOG |
|
The system is transferring the VM files (disk images and the recovery file) to the host in which the virtual machine will be running. |
||
2 |
BOOT |
|
OpenNebula is waiting for the hypervisor to create the VM |
||
3 |
RUNNING |
|
The VM is running (note that this stage includes the internal virtualized machine booting and shutting down phases). In this state, the virtualization driver will periodically monitor it |
||
4 |
MIGRATE |
|
The VM is migrating from one host to another. This is a hot migration |
||
5 |
SAVE_STOP |
|
The system is saving the VM files after a stop operation |
||
6 |
SAVE_SUSPEND |
|
The system is saving the VM files after a suspend operation |
||
7 |
SAVE_MIGRATE |
|
The system is saving the VM files for a cold migration |
||
8 |
PROLOG_MIGRATE |
|
File transfers during a cold migration |
||
9 |
PROLOG_RESUME |
|
File transfers after a resume action (from stopped) |
||
10 |
EPILOG_STOP |
|
File transfers from the Host to the system datastore |
||
11 |
EPILOG |
|
The system cleans up the Host used to virtualize the VM, and additionally disk images to be saved are copied back to their datastores |
||
12 |
SHUTDOWN |
|
OpenNebula has sent the VM the shutdown ACPI signal, and is waiting for it to complete the shutdown process. If after a timeout period the VM does not disappear, OpenNebula will assume that the guest OS ignored the ACPI signal and the VM state will be changed to running, instead of done |
||
15 |
CLEANUP_RESUBMIT |
|
Cleanup after a delete-recreate action |
||
16 |
UNKNOWN |
|
The VM couldn’t be monitored, it is in an unknown state |
||
17 |
HOTPLUG |
|
A disk attach/detach operation is in progress |
||
18 |
SHUTDOWN_POWEROFF |
|
OpenNebula has sent the VM the shutdown ACPI signal, and is waiting for it to complete the shutdown process. If after a timeout period the VM does not disappear, OpenNebula will assume that the guest OS ignored the ACPI signal and the VM state will be changed to running, instead of poweroff |
||
19 |
BOOT_UNKNOWN |
|
OpenNebula is waiting for the hypervisor to create the VM (from UNKNOWN) |
||
20 |
BOOT_POWEROFF |
|
OpenNebula is waiting for the hypervisor to create the VM (from POWEROFF) |
||
21 |
BOOT_SUSPENDED |
|
OpenNebula is waiting for the hypervisor to create the VM (from SUSPENDED) |
||
22 |
BOOT_STOPPED |
|
OpenNebula is waiting for the hypervisor to create the VM (from STOPPED) |
||
23 |
CLEANUP_DELETE |
|
Cleanup after a delete action |
||
24 |
HOTPLUG_SNAPSHOT |
|
A system snapshot action is in progress |
||
25 |
HOTPLUG_NIC |
|
A NIC attach/detach operation is in progress |
||
26 |
HOTPLUG_SAVEAS |
|
A disk-saveas operation is in progress |
||
27 |
HOTPLUG_SAVEAS_POWEROFF |
|
A disk-saveas operation (from POWEROFF) is in progress |
||
28 |
HOTPLUG_SAVEAS_SUSPENDED |
|
A disk-saveas operation (from SUSPENDED) is in progress |
||
29 |
SHUTDOWN_UNDEPLOY |
|
OpenNebula has sent the VM the shutdown ACPI signal, and is waiting for it to complete the shutdown process. If after a timeout period the VM does not disappear, OpenNebula will assume that the guest OS ignored the ACPI signal and the VM state will be changed to running, instead of undeployed |
||
30 |
EPILOG_UNDEPLOY |
|
The system cleans up the Host used to virtualize the VM, and VM files are transferred to the system datastore |
||
31 |
PROLOG_UNDEPLOY |
|
File transfers after a resume action (from undeployed) |
||
32 |
BOOT_UNDEPLOY |
|
OpenNebula is waiting for the hypervisor to create the VM (from UNDEPLOY) |
||
33 |
HOTPLUG_PROLOG_POWEROFF |
|
File transfers for a disk attach from poweroff |
||
34 |
HOTPLUG_EPILOG_POWEROFF |
|
File transfers for a disk detach from poweroff |
||
35 |
BOOT_MIGRATE |
|
OpenNebula is waiting for the hypervisor to create the VM (from a cold migration) |
||
36 |
BOOT_FAILURE |
|
Failure during a BOOT |
||
37 |
BOOT_MIGRATE_FAILURE |
|
Failure during a BOOT_MIGRATE |
||
38 |
PROLOG_MIGRATE_FAILURE |
|
Failure during a PROLOG_MIGRATE |
||
39 |
PROLOG_FAILURE |
|
Failure during a PROLOG |
||
40 |
EPILOG_FAILURE |
|
Failure during an EPILOG |
||
41 |
EPILOG_STOP_FAILURE |
|
Failure during an EPILOG_STOP |
||
42 |
EPILOG_UNDEPLOY_FAILURE |
|
Failure during an EPILOG_UNDEPLOY |
||
43 |
PROLOG_MIGRATE_POWEROFF |
|
File transfers during a cold migration (from POWEROFF) |
||
44 |
PROLOG_MIGRATE_POWEROFF_FAILURE |
|
Failure during a PROLOG_MIGRATE_POWEROFF |
||
45 |
PROLOG_MIGRATE_SUSPEND |
|
File transfers during a cold migration (from SUSPEND) |
||
46 |
PROLOG_MIGRATE_SUSPEND_FAILURE |
|
Failure during a PROLOG_MIGRATE_SUSPEND |
||
47 |
BOOT_UNDEPLOY_FAILURE |
|
Failure during a BOOT_UNDEPLOY |
||
48 |
BOOT_STOPPED_FAILURE |
|
Failure during a BOOT_STOPPED |
||
49 |
PROLOG_RESUME_FAILURE |
|
Failure during a PROLOG_RESUME |
||
50 |
PROLOG_UNDEPLOY_FAILURE |
|
Failure during a PROLOG_UNDEPLOY |
||
51 |
DISK_SNAPSHOT_POWEROFF |
|
A disk-snapshot-create action (from POWEROFF) is in progress |
||
52 |
DISK_SNAPSHOT_REVERT_POWEROFF |
|
A disk-snapshot-revert action (from POWEROFF) is in progress |
||
53 |
DISK_SNAPSHOT_DELETE_POWEROFF |
|
A disk-snapshot-delete action (from POWEROFF) is in progress |
||
54 |
DISK_SNAPSHOT_SUSPENDED |
|
A disk-snapshot-create action (from SUSPENDED) is in progress |
||
55 |
DISK_SNAPSHOT_REVERT_SUSPENDED |
|
A disk-snapshot-revert action (from SUSPENDED) is in progress |
||
56 |
DISK_SNAPSHOT_DELETE_SUSPENDED |
|
A disk-snapshot-delete action (from SUSPENDED) is in progress |
||
57 |
DISK_SNAPSHOT |
|
A disk-snapshot-create action (from RUNNING) is in progress |
||
59 |
DISK_SNAPSHOT_DELETE |
|
A disk-snapshot-delete action (from RUNNING) is in progress |
||
60 |
PROLOG_MIGRATE_UNKNOWN |
|
File transfers during a cold migration (from UNKNOWN) |
||
61 |
PROLOG_MIGRATE_UNKNOWN_FAILURE |
|
Failure during a PROLOG_MIGRATE_UNKNOWN |
||
62 |
DISK_RESIZE |
|
Disk resize with the vm on RUNNING state. |
||
63 |
DISK_RESIZE_POWEROFF |
|
Disk resize with the vm on POWEROFF state. |
||
64 |
DISK_RESIZE_UNDEPLOYED |
|
Disk resize with the vm UNDEPLOYED. |
||
65 |
HOTPLUG_NIC_POWEROFF |
|
A NIC attach/detach operation (from POWEROFF) is in progress. |
||
66 |
HOTPLUG_RESIZE |
|
Hotplug resize VCPU and memory is in progress. |
||
67 |
HOTPLUG_SAVEAS_UNDEPLOYED |
|
A disk-saveas operation (from UNDEPLOYED) is in progress. |
||
68 |
HOTPLUG_SAVEAS_STOPPED |
|
A disk-saveas operation (from STOPPED) is in progress. |
||
69 |
BACKUP |
|
A backup operation is in progress (VM running). |
||
70 |
BACKUP_POWEROFF |
|
A backup operation is in progress (VM poweroff). |
||
71 |
RESTORE |
|
A VM disks are restored from backup image. |
||
4 |
STOPPED |
|
The VM is stopped. VM state has been saved and it has been transferred back along with the disk images to the system datastore |
||
5 |
SUSPENDED |
|
Same as stopped, but the files are left in the host to later resume the VM there (i.e. there is no need to re-schedule the VM) |
||
6 |
DONE |
|
The VM is done. VMs in this state won’t be shown with |
||
8 |
POWEROFF |
|
Same as suspended, but no checkpoint file is generated. Note that the files are left in the host to later boot the VM there. When the VM guest is shutdown, OpenNebula will put the VM in this state |
||
9 |
UNDEPLOYED |
|
The VM is shut down. Similar to STOPPED, but no checkpoint file is generated. The VM disks are transferred to the system datastore. The VM can be resumed later |
||
10 |
CLONING |
|
The VM is waiting for one or more disk images to finish the initial copy to the repository (image state still in |
||
11 |
CLONING_FAILURE |
|
Failure during a CLONING. One or more of the images went into the ERROR state |
Diagram¶
You can click on the following image to open it in a new window. For a simplified version of this diagram, please visit the Managing Virtual Machines guide.