Virtual Machines States Reference
This page provides a complete reference of all VM states, useful for developers and administrators when troubleshooting.
The names shown here are the same ones used by hypercloud vm list
under the "STAT" column. For example, prolog
, prolog_migrate
, and prolog_resume
are all displayed as prol
.
List of States
In HyperCloud OS, a Virtual Machine has two variables that define its state: STATE
and LCM_STATE
. The LCM_STATE
is only applicable when STATE
is ACTIVE
. Both variables can be viewed in the CLI (hypercloud vm show
) and in Glasshouse (VM Info panel).
Warning
LCM_INIT
is used as the LCM_STATE
whenever the VM’s STATE
is not ACTIVE
.
HyperCloud VM States Reference
State # | State Name | LCM # | LCM State | Alias | Meaning |
---|---|---|---|---|---|
0 | INIT | init |
Internal VM initialization state (not visible to users) | ||
1 | PENDING | pend |
VM waiting for resources or manual deployment | ||
2 | HOLD | hold |
VM manually held by owner, won't be auto-scheduled | ||
3 | ACTIVE | 0 | LCM_INIT | init |
Internal initialization (not visible to users) |
1 | PROLOG | prol |
Transferring VM files to target host | ||
2 | BOOT | boot |
Waiting for hypervisor to create the VM | ||
3 | RUNNING | runn |
VM is running and being monitored | ||
4 | MIGRATE | migr |
VM migrating between hosts (hot migration) | ||
5 | SAVE_STOP | save |
Saving VM state after stop operation | ||
6 | SAVE_SUSPEND | save |
Saving VM state after suspend operation | ||
7 | SAVE_MIGRATE | save |
Saving VM state for cold migration | ||
8 | PROLOG_MIGRATE | migr |
Transferring files during cold migration | ||
9 | PROLOG_RESUME | prol |
Transferring files to resume from stopped state | ||
10 | EPILOG_STOP | epil |
Transferring files back to datastore after stop | ||
11 | EPILOG | epil |
Cleaning up host and transferring disk images | ||
12 | SHUTDOWN | shut |
Sent shutdown signal, waiting for VM to power down gracefully | ||
15 | CLEANUP_RESUBMIT | clea |
Cleaning up after delete-recreate action | ||
16 | UNKNOWN | unkn |
VM monitoring failed, state unknown | ||
17 | HOTPLUG | hotp |
Disk attach/detach operation in progress | ||
18 | SHUTDOWN_POWEROFF | shut |
Shutdown initiated, will transition to POWEROFF state | ||
19 | BOOT_UNKNOWN | boot |
Booting VM from UNKNOWN state | ||
20 | BOOT_POWEROFF | boot |
Booting VM from POWEROFF state | ||
21 | BOOT_SUSPENDED | boot |
Booting VM from SUSPENDED state | ||
22 | BOOT_STOPPED | boot |
Booting VM from STOPPED state | ||
23 | CLEANUP_DELETE | clea |
Cleaning up after VM deletion | ||
24 | HOTPLUG_SNAPSHOT | snap |
System snapshot operation in progress | ||
25 | HOTPLUG_NIC | hotp |
Network interface attach/detach in progress | ||
26 | HOTPLUG_SAVEAS | hotp |
Disk save-as operation in progress | ||
27 | HOTPLUG_SAVEAS_POWEROFF | hotp |
Disk save-as operation from POWEROFF state | ||
28 | HOTPLUG_SAVEAS_SUSPENDED | hotp |
Disk save-as operation from SUSPENDED state | ||
29 | SHUTDOWN_UNDEPLOY | shut |
Shutdown initiated, will transition to UNDEPLOYED state | ||
30 | EPILOG_UNDEPLOY | epil |
Cleaning up host and transferring files to datastore | ||
31 | PROLOG_UNDEPLOY | prol |
Transferring files to resume from undeployed state | ||
32 | BOOT_UNDEPLOY | boot |
Booting VM from UNDEPLOY state | ||
33 | HOTPLUG_PROLOG_POWEROFF | hotp |
Transferring files for disk attach from poweroff | ||
34 | HOTPLUG_EPILOG_POWEROFF | hotp |
Transferring files for disk detach from poweroff | ||
35 | BOOT_MIGRATE | boot |
Booting VM after cold migration | ||
36 | BOOT_FAILURE | fail |
Boot operation failed | ||
37 | BOOT_MIGRATE_FAILURE | fail |
Boot after migration failed | ||
38 | PROLOG_MIGRATE_FAILURE | fail |
File transfer during migration failed | ||
39 | PROLOG_FAILURE | fail |
File transfer operation failed | ||
40 | EPILOG_FAILURE | fail |
Cleanup operation failed | ||
41 | EPILOG_STOP_FAILURE | fail |
Cleanup after stop failed | ||
42 | EPILOG_UNDEPLOY_FAILURE | fail |
Cleanup after undeploy failed | ||
43 | PROLOG_MIGRATE_POWEROFF | migr |
File transfer for cold migration from POWEROFF | ||
44 | PROLOG_MIGRATE_POWEROFF_FAILURE | fail |
Migration file transfer from POWEROFF failed | ||
45 | PROLOG_MIGRATE_SUSPEND | migr |
File transfer for cold migration from SUSPEND | ||
46 | PROLOG_MIGRATE_SUSPEND_FAILURE | fail |
Migration file transfer from SUSPEND failed | ||
47 | BOOT_UNDEPLOY_FAILURE | fail |
Boot from undeploy failed | ||
48 | BOOT_STOPPED_FAILURE | fail |
Boot from stopped state failed | ||
49 | PROLOG_RESUME_FAILURE | fail |
File transfer for resume failed | ||
50 | PROLOG_UNDEPLOY_FAILURE | fail |
File transfer for undeploy failed | ||
51 | DISK_SNAPSHOT_POWEROFF | snap |
Creating disk snapshot from POWEROFF state | ||
52 | DISK_SNAPSHOT_REVERT_POWEROFF | snap |
Reverting disk snapshot from POWEROFF state | ||
53 | DISK_SNAPSHOT_DELETE_POWEROFF | snap |
Deleting disk snapshot from POWEROFF state | ||
54 | DISK_SNAPSHOT_SUSPENDED | snap |
Creating disk snapshot from SUSPENDED state | ||
55 | DISK_SNAPSHOT_REVERT_SUSPENDED | snap |
Reverting disk snapshot from SUSPENDED state | ||
56 | DISK_SNAPSHOT_DELETE_SUSPENDED | snap |
Deleting disk snapshot from SUSPENDED state | ||
57 | DISK_SNAPSHOT | snap |
Creating disk snapshot from RUNNING state | ||
59 | DISK_SNAPSHOT_DELETE | snap |
Deleting disk snapshot from RUNNING state | ||
60 | PROLOG_MIGRATE_UNKNOWN | migr |
File transfer for cold migration from UNKNOWN state | ||
61 | PROLOG_MIGRATE_UNKNOWN_FAILURE | fail |
Migration file transfer from UNKNOWN failed | ||
62 | DISK_RESIZE | dsrz |
Resizing disk while VM is running | ||
63 | DISK_RESIZE_POWEROFF | dsrz |
Resizing disk while VM is powered off | ||
64 | DISK_RESIZE_UNDEPLOYED | dsrz |
Resizing disk while VM is undeployed | ||
65 | HOTPLUG_NIC_POWEROFF | hotp |
Network interface attach/detach from POWEROFF state | ||
66 | HOTPLUG_RESIZE | hotp |
Hot-resizing CPU and memory resources | ||
67 | HOTPLUG_SAVEAS_UNDEPLOYED | hotp |
Disk save-as operation from UNDEPLOYED state | ||
68 | HOTPLUG_SAVEAS_STOPPED | hotp |
Disk save-as operation from STOPPED state | ||
69 | BACKUP | back |
Backup operation in progress (VM running) | ||
70 | BACKUP_POWEROFF | back |
Backup operation in progress (VM powered off) | ||
71 | RESTORE | rest |
Restoring VM disks from backup image | ||
4 | STOPPED | stop |
VM stopped with state saved and transferred to datastore | ||
5 | SUSPENDED | susp |
VM suspended with files left on host for quick resume | ||
6 | DONE | done |
VM completed and archived (hidden from list but kept for accounting) | ||
8 | POWEROFF | poff |
VM powered off with files left on host (no checkpoint saved) | ||
9 | UNDEPLOYED | unde |
VM shut down with disks transferred to datastore (no checkpoint) | ||
10 | CLONING | clon |
VM waiting for disk image copying to complete | ||
11 | CLONING_FAILURE | fail |
VM cloning failed due to image errors |