Citrix Systems 5.6 User Manual

207

The 

 parameter can also point to an XVA-format VM, which is the legacy export format from

XenServer 3.2 and is used by some third-party vendors to provide virtual appliances. This format uses a

directory to store the VM data, so set 

 to the root directory of the XVA export and not an actual

file. Subsequent exports of the imported legacy guest will automatically be upgraded to the new filename-

based format, which stores much more data about the configuration of the VM.

Note:

The older directory-based XVA format does not fully preserve all the VM attributes. In particular, imported
VMs will not have any virtual network interfaces attached by default. If networking is required, create one
using vif-create and vif-plug.

If  the 

  is 

true

,  then  a  previously  exported  set  of  metadata  can  be  imported  without  their

associated  disk  blocks.  Metadata-only  import  will  fail  if  any  VDIs  cannot  be  found  (named  by  SR  and

) unless the 

 option is specified, in which case the import will proceed regardless.

If disks can be mirrored or moved out-of-band then metadata import/export represents a fast way of moving

VMs between disjoint pools (e.g. as part of a disaster recovery plan).

Note:

Multiple VM imports will be performed faster in serial that in parallel.

vm-install

 new-name-label=

<name>

[ template-uuid=

<uuid_of_desired_template>

 | [template=

<uuid_or_name_of_desired_template>

]]

[ sr-uuid=

<sr_uuid>

 | sr-name-label=

<name_of_sr>

 ]

[ copy-bios-strings-from=

<uuid of host>

 ]

Install a VM from a template. Specify the template name using either the 

 or 

argument. Specify an SR other than the default SR using either the 

 or 

 argument.

Specify to install BIOS-locked media using the 

 argument.

vm-memory-shadow-multiplier-set

 [

<vm-selector>

=

<vm_selector_value>

...]

[multiplier=

<float_memory_multiplier>

]

Set the shadow memory multiplier for the specified VM.

This is an advanced option which modifies the amount of shadow memory assigned to a hardware-assisted

VM. In some specialized application workloads, such as Citrix XenApp, extra shadow memory is required

to achieve full performance.

This memory is considered to be an overhead. It is separated from the normal memory calculations for

accounting memory to a VM. When this command is invoked, the amount of free XenServer host memory

will decrease according to the multiplier, and the 

 field will be updated with the

actual value which Xen has assigned to the VM. If there is not enough XenServer host memory free, then

an error will be returned.

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

(see 

VM selectors

 for more information).

vm-migrate

  [[host-uuid=

<destination  XenServer  host  UUID>

  ]  |  [host=

<name  or  UUID  of  destination

XenServer host>

 ]] [

<vm-selector>

=

<vm_selector_value>

...] [live=

<true | false>

]