vdi-uuid=<uuid_of_the_vdi_the_vbd_will_connect_to>[bootable=true] [type=<Disk CD>] [mode=<RW RO>]

Create a new VBD on a VM.

Appropriate values for the device field are listed in the parameter allowed-VBD-deviceson the specified VM. Before any VBDs exist there, the allowable values are integers from 0-15.

If the type is Disk, vdi-uuidis required. Mode can be RO or RW for a Disk.

If the type is CD, vdi-uuidis optional; if no VDI is specified, an empty VBD will be created for the CD. Mode must be RO for a CD.

vbd-destroy

vbd-destroy uuid=<uuid_of_vbd>

Destroy the specified VBD.

If the VBD has its other-config:ownerparameter set to true, the associated VDI will also be destroyed.

vbd-eject

vbd-ejectuuid=<uuid_of_vbd>

Remove the media from the drive represented by a VBD. This command only works if the media is of a removable type (a physical CD or an ISO); otherwise an error message VBD_NOT_REMOVABLE_MEDIA is returned.

vbd-insert

vbd-insertuuid=<uuid_of_vbd> vdi-uuid=<uuid_of_vdi_containing_media>

Insert new media into the drive represented by a VBD. This command only works if the media is of a removable type (a physical CD or an ISO); otherwise an error message VBD_NOT_REMOVABLE_MEDIA is returned.

vbd-plug

vbd-pluguuid=<uuid_of_vbd>

Attempt to attach the VBD while the VM is in the running state.

vbd-unplug

vbd-unplug uuid=<uuid_of_vbd>

Attempts to detach the VBD from the VM while it is in the running state.

VDI Commands

Commands for working with VDIs (Virtual Disk Images).

A VDI is a software object that represents the contents of the virtual disk seen by a VM, as opposed to the VBD, which is a connector object that ties a VM to the VDI. The VDI has the information on the physical attributes of the virtual disk (which type of SR, whether the disk is shareable, whether the media is read/write or read only, and so on), while the VBD has the attributes which tie the VDI to the VM (is it bootable, its read/write metrics, and so on).

160

Page 178
Image 178
Citrix Systems 6 manual VDI Commands