Citrix Systems 5.6 manual Task commands, Task parameters, Sr-introduce, Sr-probe, Sr-scan

sr-introduce

sr-introduce name-label=<name>physical-size=<physical_size>type=<type> content-type=<content_type>uuid=<sr_uuid>

Just places an SR record into the database. The device-configparameters are specified by device- config:<parameter_key>=<parameter_value>, for example:

xe sr-introduce device-config:<device>=</dev/sdb1>

Note:

This command is never used in normal operation. It is an advanced operation which might be useful if an SR needs to be reconfigured as shared after it was created, or to help recover from various failure scenarios.

sr-probe

sr-probetype=<type> [host-uuid=<uuid_of_host>] [device-config:<config_name>=<value>]

Performs a backend-specific scan, using the provided device-configkeys. If the device-configis complete for the SR backend, then this will return a list of the SRs present on the device, if any. If the device-configparameters are only partial, then a backend-specific scan will be performed, returning results that will guide you in improving the remaining device-configparameters. The scan results are returned as backend-specific XML, printed out on the CLI.

The exact device-configparameters differ depending on the device type. See Storage for details of these parameters across the different storage backends.

sr-scan

sr-scan uuid=<sr_uuid>

Force an SR scan, syncing the xapi database with VDIs present in the underlying storage substrate.

Task commands

Commands for working with long-running asynchronous tasks. These are tasks such as starting, stopping, and suspending a Virtual Machine, which are typically made up of a set of other atomic subtasks that together accomplish the requested operation.

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

Task parameters

Tasks have the following parameters:

Parameter Name	Description	Type
uuid	the unique identifier/object reference for	read only
	the Task
name-label	the name of the Task	read only

176