The filename 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 filename 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-createand vif-plug.

If the metadata 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 VDI.location) unless the --forceoption 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

vm-installnew-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 template-uuidor template argument. Specify an SR other than the default SR using either the sr-uuidor sr-name-labelargument. Specify to install BIOS-locked media using the copy-bios-strings-fromargument.

vm-memory-shadow-multiplier-set

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 HVM_shadow_multiplier 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

vm-migrate[[host-uuid=<destination XenServer host UUID> ] [host=<name or UUID of destination XenServer host> ]] [<vm-selector>=<vm_selector_value>...] [live=<true false>]

207

Page 227
Image 227
Citrix Systems 5.6 manual Vm-install, Vm-memory-shadow-multiplier-set, Vm-migrate