update-upload

update-uploadfile-name=<name_of_upload_file>

Streams a new software image to a OEM edition XenServer host. You must then restart the host for this to take effect.

User Commands

user-password-change

user-password-changeold=<old_password> new=<new_password>

Changes the password of the logged-in user. The old password field is not checked because you require supervisor privilege to make this call.

VBD Commands

Commands for working with VBDs (Virtual Block Devices).

A VBD is a software object that connects a VM to the VDI, which represents the contents of the virtual disk. The VBD has the attributes which tie the VDI to the VM (is it bootable, its read/write metrics, and so on), while 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).

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

VBD Parameters

VBDs have the following parameters:

Parameter Name

Description

 

Type

 

 

 

 

 

uuid

the

unique

identifier/object

read only

 

reference for the VBD

 

 

 

 

 

 

vm-uuid

the

unique

identifier/object

read only

 

reference for the VM this VBD is

 

 

attached to

 

 

 

 

 

vm-name-label

the name of the VM this VBD is

read only

 

attached to

 

 

 

 

 

 

 

vdi-uuid

the

unique

identifier/object

read only

 

reference for the VDI this VBD is

 

 

mapped to

 

 

 

 

 

vdi-name-label

the name of the VDI this VBD is

read only

 

mapped to

 

 

 

 

 

empty

if true, this represents an empty

read only

 

drive

 

 

 

 

 

 

device

the device seen by the guest, for

read only

 

example hda1

 

 

 

 

 

userdevice

user-friendly device name

read/write

 

 

 

bootable

true if this VBD is bootable

read/write

 

 

 

 

 

158

Page 176
Image 176
Citrix Systems 6 manual User Commands, VBD Commands, Update-upload, User-password-change, VBD Parameters