XenServer Administrator's Guide 4.1.0

Command line interface

5.4.19.5. vdi-forget

vdi-forget uuid=UUID of VDI

Unconditionally removes a VDI record from the database without touching the storage backend. In normal

operation, you should be using vdi-destroy instead.

5.4.19.6. vdi-import

vdi-import uuid=UUID of VDI filename=filename of raw VDI

Import a raw VDI.

5.4.19.7. vdi-introduce

vdi-introduce uuid=UUID of VDI sr-uuid=UUID of SR to import into name-label=name of

the new VDI type=system | user | suspend | crashdump location=device location (varies

by storage type) [name-description=description of VDI ] [sharable=yes | no ] [read-only=yes

| no ] [other-config=map to store misc user-specific data ] [xenstore-data=map to of

additional Xenstore keys ] [sm-configstorage-specific configuration data ]

Create a VDI object representing an existing storage device, without actually modifying or creating any

storage. This command is primarily used internally to automatically introduce hot-plugged storage devices.

5.4.19.8. vdi-resize

vdi-resize uuid=VDI UUID disk-size=new size for disk

Resize the VDI specified by UUID.

5.4.19.9. vdi-snapshot

vdi-snapshot uuid=UUID of the VDI [driver-params= ]

Produces a read-write version of a VDI that can be used as a reference for backup and/or templating pur-

poses. 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-params map 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's driver docu-

mentation for details.

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

5.4.19.10. vdi-unlock

vdi-unlock uuid=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.

5.4.20. VIF commands

Commands for working with VIFs (Virtual network interfaces).