Citrix Systems 5.6 manual VIF commands, VIF parameters, Vdi-unlock

Produces a read-write version of a VDI that can be used as a reference for backup and/or template creation purposes. You can perform a backup from a snapshot rather than installing and running backup software inside the VM. The VM can continue running while external backup software streams the contents of the snapshot to the backup media. Similarly, a snapshot can be used as a "gold image" on which to base a template. A template can be made using any VDIs.

The optional driver-paramsmap parameter can be used for passing extra vendor-specific configuration information to the back end storage driver that the VDI is based on. See the storage vendor driver documentation for details.

A clone of a snapshot should always produce a writable VDI.

vdi-unlock

vdi-unlockuuid=<uuid_of_vdi_to_unlock> [force=true]

Attempts to unlock the specified VDIs. If force=true is passed to the command, it will force the unlocking operation.

VIF commands

Commands for working with VIFs (Virtual network interfaces).

The VIF objects can be listed with the standard object listing command (xe vif-list), and the parameters manipulated with the standard parameter commands. See the section called “Low-level param commands” for details.

VIF parameters

VIFs have the following parameters:

Parameter Name	Description	Type
uuid	the unique identifier/object	read only
	reference for the VIF
vm-uuid	the unique identifier/object	read only
	reference for the VM that this
	VIF resides on
vm-name-label	the name of the VM that this	read only
	VIF resides on
allowed-operations	a list of the operations	read only set parameter
	allowed in this state
current-operations	a list of the operations that	read only set parameter
	are currently in progress on
	this VIF
device	integer label of this VIF,	read only
	indicating the order in which
	VIF backends were created
MAC	MAC address of VIF, as	read only
	exposed to the VM

192