HP BL680c XenServer Administrator's Guide 4.1.0

HP BL680c - ProLiant - G5 Manual

Get HP BL680c - ProLiant - G5 PDF manuals and user guides
UPC - 884420396314
View all HP BL680c manuals
Add to My Manuals
Save this manual to your list of manuals

HP BL680c manual content summary:

  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 1
    XenServer Administrator's Guide 4.1.0 Published March 2008 1.0 Edition 1
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 2
    Serial Number 11/487,945, filed on July 17, 2006, and entitled "Using Writeable Page Tables for Memory Address Translation in a Hypervisor Environment". 2. United States Non-Provisional Utility Patent Application Serial Number 11/879,338, filed on July 17, 2007, and entitled "Tracking Current Time
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 3
    XenServer Administrator's Guide 3
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 4
    ...1 1.3. Storage ...1 1.4. Command Line Interface 2 1.5. How this Guide relates to other documentation 2 2. XenServer Hosts and resource pools 3 8 2.7.3. Pool failures 8 2.7.4. Coping with Failure due to Configuration Errors 8 2.7.5. Physical Machine failure 9 3. Storage ...11 3.1. Overview
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 5
    pools 38 4.3.3. Changing XenServer Host IP address configuration in resource pools....... 42 4.3.4. NIC/PIF ordering 43 4.4. Networking Troubleshooting 45 4.4.1. Diagnosing network corruption 45 4.4.2. Recovering from a bad network configuration 46 5. Command line interface 47 5.1. Basic xe
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 6
    XenServer Administrator's Guide 6.2. Troubleshooting connections between XenCenter and the XenServer Host ........ 100 6.3. Special debug boot options 100 Index ...101 6
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 7
    guide so that you can find the information you need. The following topics are covered: • XenServer Hosts and resource pools • XenServer network configuration • XenServer storage configuration Channel) • create virtual disk images within storage repositories as part of the process of installing VMs 1
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 8
    P2V. • XenServer Software Development Kit Guide presents an overview of the XenServer SDK -- a selection of code samples that demonstrate how to write applications that interface with XenServer Hosts. • XenAPI Specification provides a programmer's reference guide to the XenServer API. • Release
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 9
    XenServer Host which has sufficient memory and then dynamically moved between resource pool. Up to 16 hosts are supported per resource pool, although this restriction clock synchronized to the pool master server (for example, via NTP) • it has no shared storage configured • there are no running or
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 10
    Host to have a static IP address to be part of a resource pool also applies to the servers providing the shared NFS or iSCSI storage. Although not a was installed. 2.3. Adding shared storage For a complete list of supported shared storage types, see the Storage chapter. This section demonstrates how
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 11
    XenServer Hosts and resource pools xe pool-list 4. Set the shared storage as the pool-wide default with the command xe pool-param-set uuid=pool-uuid default-SR=sr-uuid Since the shared storage has been set as the pool-wide default, all future VMs will have their disks created on shared storage by
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 12
    perform as many of the following backup procedures as possible to recover from possible server and / or software failure. Procedure 2.5. To backup pool metadata 1. Run the succeed. Procedure 2.6. To backup host configuration and software • Run the command: xe host-backup host=host file-name=
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 13
    the member is dead. There are two ways to recover from this problem: • Repair the dead member (e.g. by physically rebooting it). When the connection to the member is restored, the master will mark the member as alive again. • Instruct the master to forget about the member node using the xe host
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 14
    pool are enforced to be homogeneous, there is no real need to make the replaced server the master. When a member XenServer Host is transitioned to being a master, you should . 2.7.4. Coping with Failure due to Configuration Errors If the physical host machine is operational but the software or host
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 15
    sure that the machines (and VMs) are offline you can reset the VM power state to Halted: xe vm-reset-powerstate vm=vm-uuid --force VMs can the original machine, modify the storage configuration using pbd-destroy and pbd-create to recreate storage configurations. See Section 5.4.9, "PBD commands"
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 16
    XenServer Hosts and resource pools xe vm-import filename=backup --metadata 2. If the metadata import fails, run the command: xe vm-import filename=backup --metadata --force This command will attempt to restore the VM metadata on a 'best effort' basis. 3. Restart all VMs. 10
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 17
    fast cloning to be exposed on storage targets that support them. For storage subsystems that do not inherently support advanced operations directly, a software stack is provided based on Microsoft's Virtual Hard Disk (VHD) specification which implements these features. Each XenServer Host host can
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 18
    LUNs are accessible via the Netapp SR driver type, and are hosted on a represent the interface between a physical server and an attached SR. PBDs of parameters regarding QoS (quality of service), statistics, and the bootability of that XenServer supports. Device configuration options and examples
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 19
    supported. However, visibility and customization of low-level storage management is of considerable value to some power may be configured with a local EXT SR to serve VDIs disk in the physical CD- or DVD-ROM drive of the XenServer Host; the other is for servers that support NFS V3 over TCP/
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 20
    server. The sr-probe command can provide a list of valid destination paths exported by the server on which the SR may be created. The NFS server must be configured specific requirements of their installation. XenServer has been tuned for enterprise-class filers that use non-volatile RAM -end filers
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 21
    cloning. iSCSI SRs utilize the entire LUN specified at creation time and may not span more than one LUN. CHAP support is provided for client authentication, during both the data path initialization and the LUN discovery phases. 3.2.4.1. XenServer Host iSCSI configuration All iSCSI initiators and
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 22
    support for Fibre Channel has the following restrictions: • Dual Multipath is not supported • Direct mapping of a LUN to a VM is not supported driver also uses the built-in software initiator and its assigned server vary per Filer type, however as a general guide, a FlexVol may contain up to 200 LUNs,
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 23
    can use between 1 and 32 FlexVols; the default is 8. driver can be probed for non-traditional type aggregates, that is, newer-style aggregates that support FlexVols, and then lists all aggregates available and the unused disk space on each. We strongly recommend that you configure ever utilizing the
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 24
    filer A-SIS parameters, typically every 24 hours. It must be enabled at the point the SR is created and any custom A-SIS configuration managed directly on the filer. Access Control Since FlexVol operations such as volume creation and volume snapshotting require administrator privileges on the filer
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 25
    type. When an incomplete set of parameters is supplied sr-probe returns an error message indicating parameters are missing and the possible available on the server will be returned: # xe sr-probe type=lvmoiscsi device-config:target=192.168.1.10 Error code: SR_BACKEND_FAILURE_96 Error parameters: ,
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 26
    .168.1.10 \ device-config:targetIQN=iqn.192.168.1.10:filer1 Error code: SR_BACKEND_FAILURE_107 Error parameters: , The SCSIid parameter is missing or incorrect, \ Probing the same target and supplying all three parameters will return a list of SRs that exist on
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 27
    Storage SR type nfs lvm ext device-config parameter, in order of dependency username password chapuser chappassword aggregate FlexVols allocation asis server serverpath device device Can be probed? No No No No No No No No No Yes No No 3.3.3. Creating a local LVM SR (lvm) Device-config
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 28
    user \ name-label="Example shared NFS SR" shared=true \ device-config:server=192.168.1.10 device-config:serverpath=/export1 type=nfs 3.3.6. Creating a shared port number on which to query the target usediscoverynumber the specific iscsi record index to use Optional yes yes yes no no no no
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 29
    more LUNs to each XenServer Host in the pool. This process is highly specific to the SAN equipment in use. Please refer to the documentation for your /opt/QLogic_Corporation/SANsurferiCLI Section 3.3.13 provides an example for configuring the QLogic iSCSI HBA. For more information on Fibre Channel
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 30
    host-uuid=1212c7b3-f333-4a8d-a6fb-80c5b79b5b31 Error code: SR_BACKEND_FAILURE_90 Error parameters: , The request is missing BlockDevice> Host4 qla2xxx QLogic HBA Driver 4 4. On the master host of
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 31
    and plugging portions of the sr-create operation. This can be valuable in cases where the LUN zoning was incorrect for one or more member servers in a pool when the SR was created. Correct the zoning for the affected hosts and use Repair Storage Repository instead of removing and recreating the
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 32
    has been forgotten requires introducing an SR, creating a PBD, and manually plugging the PBD to the appropriate XenServer Host in order to activate . 3.4.3. Converting local Fibre Channel SRs to shared SRs Previous XenServer releases supported only local (non-shared) Fibre Channel (FC) SRs. In cases
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 33
    be copied from one SR to another to accommodate maintenance requirements or tiered storage configurations. XenCenter provides the ability to copy a VM and all of its VDIs the VDI UUIDs for the VDIs to be moved. If the VM has a DVD drive it's vdi- uuid will be listed as and can be
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 34
    of the following 2 commands, a VDI created manually via the CLI can be assigned to a specific FlexVol: xe vdi-create uuid= sr-uuid LUN clones. By default, if no snapshot hint is passed into the backend driver it will generate a random ID with which to name the FlexVol snapshot. There
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 35
    This step is not required. Citrix recommends that only power users perform this process if it is necessary. Each a SR " for details. 2. Remove the zoning configuration within the SAN for the desired LUN to the disks have an optional I/O priority Quality of Service (QoS) setting. This setting can be
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 36
    that QoS settings will not have any effect on VHD-based storage types. Before configuring any QoS parameters for a VBD, ensure that the disk scheduler for the SR the value ionice, which is the only type of QoS algorithm supported for virtual disks in this release. The QoS parameters themselves are
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 37
    within Virtual Machines (VMs). XenServer supports up to 4 physical NICs per XenServer to create, destroy and modify three types of server-side objects which represent networking entities. These objects network. Additional CLI commands allow configuration of networking options, control over which
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 38
    all other PIFs are left unconfigured In both cases the resulting networking configuration allows connection to the XenServer Host by XenCenter, the xe CLI, is typically only required to: • use an internal network • support advanced operations such as VLANs or NIC bonding To add or is internal. 32
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 39
    is created, the VIF must be manually connected, or hot-plugged. Hot-plugging VIFs VM. Refer to the XenServer Virtual Machine Installation Guide for details on installing the XenServer Tools. VLANs) allow a single physical network to support multiple logical networks. To use VLANs with
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 40
    Networking xe pif-list 4. Create a VLAN object specifying the desired physical PIF and VLAN tag. A new PIF will be created and plugged into the specified network. The UUID of the new PIF object is returned. xe vlan-create network-uuid= pif-uuid= vlan=5 5. Attach VM VIFs to
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 41
    of the new bond PIF: xe pif-list device=bond0 6. Use the pif-reconfigure-ip command to configure the desired management interface IP address settings for the bond PIF. See Chapter 5, Command line interface for subsumed by the bond. If DHCP is used to supply IP addresses to the host in most cases 35
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 42
    4.2.4.3. Reverting NIC bonds If reverting a XenServer Host to a non-bonded configuration, be aware of the following requirements: • As when creating a bond, Quality of Service (QoS) value to be set on VM virtual network interfaces (VIFs) using the CLI. The only QoS algorithm type supported in this
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 43
    -name=example The underlying control domain hostname will also change dynamically to reflect the new hostname. 4.2.7.2. DNS servers To add or remove DNS servers in the IP addressing configuration of a XenServer Host, use the pif-reconfigure-ip command. For example, for a PIF with a static IP: pif
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 44
    in resource pools Whenever possible, create NIC bonds as part of initial resource pool creation prior to joining additional member servers to the pool or creating VMs. Doing so allows the bond configuration to be automatically replicated to member servers as they are joined to the pool and reduces
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 45
    -list command to determine the UUID of the new bond PIF: xe pif-list device= 6. Use the pif-reconfigure-ip command to configure the desired management interface IP address settings for the bond PIF. See Chapter 5, Command line interface for more detail on the options available for the
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 46
    . This step is not strictly necessary but might help reduce confusion when reviewing the host networking configuration. xe pif-reconfigure-ip uuid= mode=None 3. Join a member server to the pool. The network and bond information will be automatically replicated to the member
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 47
    the pool and repeat 3 and 4 to move the management interface on the member server to enable the bond. 4.3.2.2. Adding NIC bonds to an existing pool When adding a NIC bond to an existing pool, the bond must be manually created on each host in the pool. The steps below can be used to
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 48
    the management interface. This step is not strictly necessary, but might help reduce confusion when reviewing the host networking configuration. This command must be run directly on the member server to be affected: xe pif-reconfigure-ip uuid= mode=None 10. Move existing VMs to
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 49
    the master host. 3. On the master XenServer Host, use the pool-recover-slaves command to force the master to contact each of the member servers and inform them of the master's new IP address: xe pool-recover-slaves Refer to the Section 2.7.2, "Master failures" for more information on emergency
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 50
    in the example below. Because the management interface must first be disabled the commands must be entered directly on the host console. For the example configuration shown above use the following steps to change the NIC ordering so that eth0 corresponds to the device with a MAC address of 00:19:bb
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 51
    -62ed-a477-2c71-3974d75972eb 4.4. Networking Troubleshooting If you are having problems with configuring networking, first ensure that you have should first try to obtain the latest recommended firmware from your vendor and apply a BIOS update. If the problem still persists, then you can use the CLI
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 52
    on the console of the XenServer Host to be affected, or use the xe -s, -u, and -pw remote connection options. • When the xapi service starts, it will apply configuration to the management interface first. The name of the management interface is saved in the /etc/xensource-inventory file. In extreme
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 53
    is: xe command-name argument=value argument=value ... Each specific command contains its own set of arguments that are of the form argument=argument_value. The server argument is used to specify the the specified file (stripping CRs and LFs off the end of the file if necessary), and use that to
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 54
    , in order to enter commands on one XenServer Host that are run on a remote XenServer Host, you could do the following: export XE_EXTRA_ARGS="server=jeffbeck,port=443,username=root,password=pass" and thereafter you would not need to specify the remote XenServer Host parameters in each xe command
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 55
    Command line interface 5.3. Command types Broadly speaking, the CLI commands can be split in two halves: Low-level commands concerned with listing and parameter manipulation of API objects, and higher level commands for interacting with VMs or hosts in a more abstract level. The low-level commands
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 56
    Command line interface Note that not every value of class has the full set of class-param- commands; some have just a subset. 5.3.1. Parameter types The objects that are addressed with the xe commands have sets of parameters that identify them and define their states. Most parameters take a single
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 57
    Command line interface Lists all of the parameters and their associated values. Unlike the class-list command, this will list the values of 'expensive' fields. • [class]-param-get uuid=uuid param-name=parameter [param-key=key ] Returns the value of a particular parameter. If the parameter is a map,
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 58
    -policy="BIOS order" power-state=halted will only list those VMs for which both the field [power-state] has the value halted, and for which the field [HVM-boot-policy] has the value BIOS order. Host, or if fewer than 2 PIFs are supplied. 5.4.1.2. bond-destroy host-bond-destroy uuid=bond UUID 52
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 59
    Commands for working with physical CD/DVD drives on XenServer Hosts. CD parameters CDs have only the SR this CD is part of The name for the SR this CD is part of read only A list of Reference to the parent disk, if this CD is read only part of a chain true if SR scan operation reported this CD
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 60
    protocol (as used in VNC), or rdp: Remote Desktop Protocol read only URI for the console service read only A list of key/value pairs that specify read/write map parameter additional configuration parameters for the console. 5.4.4. Event commands Commands for working with events. 54
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 61
    specific VM to be running xe event-wait class=vm name-label=myvm power-state=running blocks until a VM called myvm is in the power-state "running." Example: wait for a specific with XenServer Hosts. XenServer Hosts are the physical servers running XenServer software. They have VMs running on
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 62
    which to perform the operation. The simplest is by supplying the argument host=. XenServer Hosts can other-config hostname address supported-bootloaders Description Type specify read/write map parameter additional configuration parameters for the XenServer Host XenServer
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 63
    line interface Parameter Name Description Type memory-total total amount of physical RAM on the XenServer Host, in bytes read only memory-free total amount of physical RAM remaining read only that can be allocated to VMs, in bytes host-metrics-last-updated Timestamp of the date and time
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 64
    backup command will work if executed on the local host (that is, without a specific hostname specified), do not use it this way. Doing so would fill up the are not used, no proxy server is identified and the destination will be the default Citrix Support ftp site. 5.4.5.3. host-crashdump-destroy
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 65
    ftp site or other location. If optional parameters are not used, no proxy server is identified and the destination will be default Citrix Support ftp site. Optional parameters are http-proxy: use specified http proxy, and url: upload to this destination url. 5.4.5.5. host-disable host-disable
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 66
    without contacting it explicitly. Tip This command is useful if the XenServer Host to "forget" is dead; however, if the XenServer Host is live and part of the pool, you should use xe pool-eject instead. 5.4.5.11. host-get-system-status host-get-system-status filename=name for status file [entries
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 67
    Command line interface Attribute pii Description Indicate an approximate range for the time, in seconds, taken to collect this entry. -1 indicates the time is unimportant. Personally identifiable information. Indicates whether the entry would have information that would identify the system owner,
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 68
    download command will work if executed on the local host (that is, without a specific hostname specified), do not use it this way. Doing so will clutter the first using the xe host-disable command, otherwise a "HOST_IN_USE" error message is displayed. The host(s) on which this operation should
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 69
    disabled first using the xe host-disable command, otherwise a "HOST_IN_USE" error message is displayed. The host(s) on which this operation should be performed on the specified XenServer Hosts. This command will apply the configuration information defined in the host logging parameter. The host(s) on
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 70
    rotating log files. 5.4.6.3. log-set-output log-set-output output=nil | stderr | file:filename | syslog:sysloglocation [key=key ] [level= debug | info | warning | error] Set the output of the specified logger. Log messages are filtered by the subsystem in which they originated and the log level of
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 71
    key/value pairs that specify read/write map parameter additional configuration parameters for the network. 5.4.7.1. network-create network-create name an existing network. 5.4.8. Patch (update) commands Commands for working with XenServer host patches (updates). These are for the standard non
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 72
    printed out. If the patch has previously been uploaded, a PATCH_ALREADY_EXISTS error is returned instead and the patch is not uploaded again. 5.4.9. PBD points read only to additional configuration information that is provided to the XenServer Host's SRbackend-driver read only map parameter Is
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 73
    following example: To add a mapping of 'path' -> '/tmp', the command line should contain the argument device-config:path=/tmp For a full list of supported device-config key/value pairs on each SR type see Chapter 3, Storage. 5.4.9.2. pbd-destroy pbd-destroy uuid=UUID of PBD Destroy the specified PBD
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 74
    DHCP read only Netmask of the PIF, defined here if IPconfiguration-mode is static; undefined if supplied by DHCP read only Gateway address of the PIF, defined here if IP-configuration-mode is static; undefined if supplied by DHCP read only DNS address of the PIF, defined here if IP- read only
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 75
    pif-metrics-last-updated other-config Description Type Timestamp of the date and time that the read only metrics for this PIF were read, in the form yyyymmddThh:mm:ss z, where z is the single-letter military timezone indicator, for example, Z for UTC (GMT) additional configuration read/write
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 76
    suspend-image-SR other-config supported-sr-types Description Type the unique pairs that specify read/write map parameter additional configuration parameters for the pool SR types that can of member XenServer Host to become new master Instruct the specified member XenServer Host to become the
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 77
    Host to leave an existing pool. 5.4.11.4. pool-emergency-reset-master pool-emergency-reset-master master-address=address of the pool's master XenServer Host Instruct a member XenServer Host to reset its master address. 5.4.11.5. pool-emergency-transition-to-master pool-emergency-transition-to-master
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 78
    vendor who created this plugin copyright statement for this SM plugin Minimum SM API version required on the XenServer Host names and descriptions of device configuration keys capabilities of the SM plugin Type read only read only read only read only read only read only read only read only read
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 79
    attached to this SR physical space currently utilized on this SR, in bytes. Note that type of the SR, used to specify the SR backend driver to use read only the type of the SR’s content. that specify read/write map parameter additional configuration parameters for the SR . The storage
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 80
    will return a list of the SRs present on the device, if any. If the [device-config] parameters are only partial, then a backend-specific scan will be performed, returning results that will guide the user in improving the remaining [device-config] parameters. The scan results are returned as backend
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 81
    associated error strings specific VM. XenServer ships with a base set of templates, which range from generic "raw" VMs that can boot an OS vendor installation CD (RHEL, CentOS, SLES, Windows) to complete pre-configured OS instances (Debian Etch and Sarge). With XenServer you can create VMs, configure
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 82
    -domain power-state power-state memory-dynamic-max memory-dynamic-min memory-static-max memory-static-min suspend-VDI-uuid VCPUs-params Note that setting is-a-template using the CLI is not supported. true if this is a control domain (domain 0 or read only a driver domain) Current power state
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 83
    VCPUs read/write action to take if a VM based on this template crashes read/write virtual console devices read only set parameter platform-specific configuration read/write map parameter list of the operations allowed in this state read only set parameter A list of the operations that are
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 84
    xe vm-start command to decide where to run the VM read/write A list of key/value pairs that specify read/write map parameter additional configuration parameters for the template Timestamp of the date and time read only that the metrics for a VM based on this template were read, in the
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 85
    -actual VCPUs-number VCPUs-utilisation vm-metrics-last-updated os-version PV-drivers-version PV-drivers-up-to-date memory disks networks other guest-metrics-lastupdated actions-after-shutdown actions-after-reboot Description Type 1970 Z (beginning of Unix/POSIX epoch) for a template The actual
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 86
    guest domain ID (if available, -1 otherwise) read only An XML specification of recommended read only values and ranges for properties of this VM data updating the standard non-OEM editions of XenServer, see Section 5.4.8, "Patch (update) commands" for details. 5.4.16.1. update-upload update-
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 87
    , this represents an empty drive read only device the device code error/success code associated with the last read only attach operation status-detail error VBD read only vbd-metrics-last-updated Timestamp of the date and time list is advisory only and the server state may have changed by the
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 88
    the task. true if this VBD will support hot-unplug true if the device can be attached additional configuration Type read/write read only read/write map the drive represented by a VBD. This command only works if the media is of a removeable type (a physical CD or an ISO); otherwise an error message
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 89
    at the storage level read only References the parent VDI, if this VDI is read only part of a chain true if SR scan operation reported this VDI read only as not present additional configuration information for this read/write map parameter VDI name of the containing storage repository read only
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 90
    image clone facilities where they exist. 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 documentation for details. 5.4.19.2. vdi-copy vdi-copy
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 91
    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 documentation for details. A clone of a snapshot should always
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 92
    key/value pairs that specify read/write map parameter additional configuration parameters for this VIF. network-uuid The unique identifier/object average write rate in kB/s for this VIF read only vif-metrics-last-updated Timestamp of the date and time that the metrics for the VIF were read
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 93
    Command line interface Parameter Name Description Type single-letter military timezone indicator, for example, Z for UTC (GMT) 5.4.20.1. vif-create vif-create vm-uuid=UUID of the VM device=see below network-uuid=UUID of the network the VIF will connect to [mac=MAC address ] Create a new VIF
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 94
    the operation. The simplest way is by supplying the argument vm=name or uuid . power-state memory-dynamic-max memory-dynamic-min memory-static-max Note that setting is-a-template using the CLI is not supported. true if this is a control domain (domain 0 or read only a driver domain) Current power
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 95
    -params VCPUs-max VCPUs-at-startup actions-after-crash Command line interface Description Type The VDI that a suspend image is stored on read only configuration parameters for the selected read/write map parameter VCPU policy. You can tune a VCPU's pinning with xe vm-param-set uuid=
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 96
    ). virtual console devices read only set parameter platform-specific configuration read/write map parameter list of the operations allowed map parameter Floating point value which controls the read/write amount of shadow memory overhead to grant the VM. Defaults to 1.0 (the minimum value),
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 97
    Command line interface Parameter Name start-time install-time memory-actual VCPUs-number VCPUs-utilisation os-version PV-drivers-version PV-drivers-up-to-date memory disks networks other guest-metrics-lastupdated Description Type config parameter includes the key/value pair auto_poweron: true
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 98
    available, -1 otherwise) read only An XML specification of recommended read only values and ranges for VM is created time when VM metrics were last updated read only 5.4.22.1. vm-cd-add vm-cd selector value...] Eject a CD from the virtual CD drive. This command will only work if there is one
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 99
    of the VM parameters listed at the beginning of this section. 5.4.22.7. vm-compute-maximum-memory vm-compute-maximum-memory total=amount of available physical RAM in bytes [approximate=add overhead memory for additional vCPUS? true | false ] [ vm-selector=vm selector value...] Calculate the maximum
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 100
    fast disk clone operation (even if this is available). The disk images of the copied VM are guaranteed to be "full images" - that is, not part of a copy-on-write (CoW) chain. Specify the name and the optional description for the resulting copied VM using the new-name-label and new
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 101
    file. Subsequent exports of the imported legacy guest will automatically be upgraded to the new filename-based format, which stores much more data about the configuration of the VM. 95
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 102
    import/export represents a fast way of moving VMs between disjoint pools (e.g. as part of a disaster recovery plan). 5.4.22.17. vm-install vm-install new-name be updated with the actual value which Xen has assigned to the VM. If there is not enough XenServer Host memory free, then an error will
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 103
    argument to cause an ungraceful shutdown, akin to pulling the plug on a physical server. 5.4.22.21. vm-reset-powerstate vm-reset-powerstate [ vm-selector=vm . You can use this command to force the pool master to reset the power-state of the VMs to be "halted". Essentially this forces the lock on
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 104
    Command line interface Start the specified VMs. The VM or VMs on which this operation should be performed are selected via the standard selection mechanism (see VM selectors). Optional arguments can be any number of the VM parameters listed at the beginning of this section. If the VMs are on a
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 105
    troubleshooting information in this chapter solely under the guidance of your Citrix Solution Provider or Citrix Support. Citrix provides two forms of support: you can receive free self-help support via the Support site, or you may purchase our Support Services the server logs report only errors and
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 106
    boot options Safe mode and serial mode are special boot options that are made available for debugging boot problems. They should not be used in normal operation, but only under explicit instruction from the appropriate Support organization. Both debug options require use of a serial console. 100
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 107
    xe syntax, 48 special characters and syntax, 48 Storage Manager commands, 71 Storage repository (SR) commands, 72 task commands, 74 Template commands, 75 update commands, 80 user commands, 80 VBD commands, 80 VDI commands, 83 VIF commands, 85 VLAN commands, 87 VM commands, 87 xe command reference
  • HP BL680c | XenServer Administrator's Guide 4.1.0 - Page 108
    (NFS), 13 USB read/write device, 13 T Task commands, xe CLI, 74 Template commands, xe CLI, 75 Troubleshooting special debug boot options, 100 xen-bugtool, , XenServer Host logs, 99, 99 U Update commands, xe CLI, 80 User commands, xe CLI, 80 V VBD commands, xe CLI, 80 VDI commands, xe
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108
1
XenServer Administrator's Guide
4.1.0
Published March 2008
1.0 Edition