Citrix Systems 5.6 User Manual

208

Migrate the specified VMs between physical hosts. The 

 parameter can be either the name or the

UUID of the XenServer host.

By default, the VM will be suspended, migrated, and resumed on the other host. The 

 parameter

activates  XenMotion  and  keeps  the  VM  running  while  performing  the  migration,  thus  minimizing  VM

downtime to less than a second. In some circumstances such as extremely memory-heavy workloads in

the VM, XenMotion automatically falls back into the default mode and suspends the VM for a brief period

of time before completing the memory transfer.

The VM or VMs on which this operation should be performed are selected using the standard selection

mechanism (see 

VM selectors

). Optional arguments can be any number of the 

VM parameters

 listed at the

beginning of this section.

vm-reboot

 [

<vm-selector>

=

<vm_selector_value>

...] [force=

<true>

]

Reboot the specified VMs.

The VM or VMs on which this operation should be performed are selected using the standard selection

mechanism (see 

VM selectors

). Optional arguments can be any number of the 

VM parameters

 listed at the

beginning of this section.

Use the 

 argument to cause an ungraceful shutdown, akin to pulling the plug on a physical server.

vm-reset-powerstate

 [

<vm-selector>

=

<vm_selector_value>

...] {force=true}

The VM or VMs on which this operation should be performed are selected using the standard selection

mechanism (see 

VM selectors

). Optional arguments can be any number of the 

VM parameters

 listed at the

beginning of this section.

This is an advanced command only to be used when a member host in a pool goes down. You can use this

command to force the pool master to reset the power-state of the VMs to be 

halted

. Essentially this forces

the lock on the VM and its disks so it can be subsequently started on another pool host. This call requires

the force flag to be specified, and fails if it is not on the command-line.

vm-resume

 [

<vm-selector>

=

<vm_selector_value>

...] [force=

<true | false>

] [on=

<XenServer host UUID>

]

Resume the specified VMs.

The VM or VMs on which this operation should be performed are selected using the standard selection

mechanism (see 

VM selectors

). Optional arguments can be any number of the 

VM parameters

 listed at the

beginning of this section.

If the VM is on a shared SR in a pool of hosts, use the 

 argument to specify which host in the pool

on which to start it. By default the system will determine an appropriate host, which might be any of the

members of the pool.

vm-shutdown

 [

<vm-selector>

=

<vm_selector_value>

...] [force=

<true | false>

]