XenServer Administrator's Guide 4.1.0

Command line interface
77
Parameter Name Description Type
You can tune a VCPU's pinning with
xe vm-param-set uuid=<VM UUID> VCPUs-params:mask=1,2,3
A VM created from this template will then
run on physical CPUs 1, 2, and 3 only.
You can also tune the VCPU priority
(xen scheduling) with the cap and weight
parameters; for example
xe vm-param-set uuid=<VM UUID> VCPUs-params:weight=512
xe vm-param-set uuid=<VM UUID> VCPUs-params:cap=100
A VM based on this template with a
weight of 512 will get twice as much CPU
as a domain with a weight of 256 on a
contended XenServer Host. Legal weights
range from 1 to 65535 and the default is
256.
The cap optionally fixes the maximum
amount of CPU a VM based on this
template will be able to consume, even if
the XenServer Host has idle CPU cycles.
The cap is expressed in percentage of
one physical CPU: 100 is 1 physical CPU,
50 is half a CPU, 400 is 4 CPUs, etc. The
default, 0, means there is no upper cap.
VCPUs-max Maximum number of VCPUs read/write
VCPUs-at-startup Boot number of VCPUs read/write
actions-after-crash action to take if a VM based on this
template crashes
read/write
console-uuids virtual console devices read only set parameter
platform platform-specific configuration read/write map parameter
allowed-operations list of the operations allowed in this state read only set parameter
current-operations A list of the operations that are currently in
progress on this template
read only set parameter
allowed-VBD-devices list of VBD identifiers available for use,
represented by integers of the range 0-15.
This list is informational only, and other
devices may be used (but may not work).
read only set parameter