Citrix XenServer 5.6 Administrators Guide
Trademarks
Managing users
Table of Contents
Storage
ISO
NFS VHD
Configuring VM memory
Viii
Workload Balancing
Page
Page
Backup and recovery 123
Monitoring and managing XenServer 136
Xiv
Page
Xvi
Xvii
Xviii
Xix
Index 214
How this Guide relates to other documentation
Document Overview
Managing users
Authenticating users using Active Directory AD
Upgrading from XenServer
Configuring Active Directory authentication
Enabling external authentication on a pool
Removing access for a user using the CLI
User authentication
Disabling external authentication
Allowing a user access to XenServer using the CLI
Terminating individual user sessions using xe
Removing access for a user
Listing subjects with access
Terminating all authenticated sessions using xe
Role Based Access Control
Rbac process
Roles
Definitions of Rbac roles and permissions
Users role can be changed in two ways
Permissions available for each role
WLB
Definitions of permissions
Permission Allows Assignee To Rationale/Comments
Definitions of permissions
Permission Allows Assignee To Rationale/Comments
Permission Allows Assignee To Rationale/Comments
To list all the available defined roles in XenServer
Working with Rbac using the xe CLI
To display a list of current subjects
Run the command xe subject-add subject-name=AD user/group
To add a subject to Rbac
To assign an Rbac role to a created subject
To obtain all audit records from the pool
Audit log xe CLI commands
Auditing
To change a subjects Rbac role
How does XenServer compute the roles for the session?
Requirements for creating resource pools
Hosts and resource pools overview
Naming a resource pool
Creating a resource pool
Adding shared storage
Creating heterogeneous resource pools
Adding NFS shared storage to a resource pool using the CLI
To remove a host from a resource pool using the CLI
Removing a XenServer host from a resource pool
Overcommitment Warning
High Availability
HA Overview
Overcommitting
Restart priorities
Configuration Requirements
Enabling HA on a XenServer pool
Enabling HA using the CLI
Shutting down a VM when it is protected by HA
Removing HA protection from a VM using the CLI
Recovering an unreachable host
Shutting down a host when HA is enabled
Host Power On
Powering on hosts remotely
Using the CLI to Manage Host Power On
To enable Host Power On using the CLI
To turn on hosts remotely using the CLI
Key/Value Pairs
Possible values
Sample Script
Physical Block Devices PBDs
Storage Overview
Storage Repositories SRs
Virtual Disk Images VDIs
Virtual Block Devices VBDs
Summary of Storage objects
Virtual Disk Data Formats
VHD Chain Coalescing
VHD-based VDIs
Storage configuration
Creating Storage Repositories
LUN-based VDIs
VDI types
Creating a raw virtual disk using the xe CLI
Upgrading LVM storage from XenServer 5.0 or earlier
LVM performance considerations
Probing an SR
Converting between VDI formats
Following parameters can be probed for each SR type
Page
Storage Multipathing
To enable storage multipathing using the xe CLI
Storage Repository Types
Creating a local EXT3 SR ext
Local LVM
Local EXT3 VHD
Creating a local LVM SR lvm
Udev
EqualLogic
Creating a shared EqualLogic SR
Parameter Name Description Optional?
NetApp
Creating a VDI using the CLI
Aggregates
FlexVols
Licenses
Access Control
Thick or thin provisioning
FAS Deduplication
Creating a shared NetApp SR over iSCSI
Software iSCSI Support
Managing VDIs in a NetApp SR
Taking VDI snapshots with a NetApp SR
XenServer Host iSCSI configuration
Sample QLogic iSCSI HBA setup
Managing Hardware Host Bus Adapters HBAs
Removing HBA-based SAS, FC or iSCSI device entries
LVM over iSCSI
Parameter Name Description Optional?
Hitachi
NFS VHD
Creating a shared NFS SR nfs
LVM over hardware HBA
Creating a shared StorageLink SR
Citrix StorageLink Gateway Cslg SRs
Parameter name Description Optional?
To create a Cslg SR
Page
Managing Storage Repositories
Introducing an SR
Destroying or forgetting a SR
Copying all of a VMs VDIs to a different SR
Resizing an SR
Converting local Fibre Channel SRs to shared SRs
Moving Virtual Disk Images VDIs between SRs
Adjusting the disk IO scheduler
Virtual disk QoS settings
Possible values of qosalgorithmparamsched are
Concept of dynamic range
What is Dynamic Memory Control DMC?
Concept of static range
DMC Behaviour
How does DMC Work?
Supported operating systems
Memory constraints
Xe CLI commands
Display the static memory properties of a VM
Display the dynamic memory properties of a VM
Updating memory properties
Upgrade issues
Update individual memory properties
Workload Balancing interaction
XenServer networking overview
Networking
Networks
Using VLANs with host management interfaces
Using VLANs with virtual machines
Network objects
NIC bonds
Using VLANs with dedicated storage NICs
Managing networking configuration
Initial networking configuration
Creating networks in a standalone server
Creating VLANs
To add a new network using the CLI
To connect a network to an external Vlan using the CLI
Creating networks in resource pools
Creating NIC bonds on a standalone host
Creating a NIC bond on a dual-NIC host
Bonding two NICs together
Creating NIC bonds in resource pools
Controlling the MAC address of the bond
Reverting NIC bonds
Adding NIC bonds to new resource pools
Adding NIC bonds to an existing pool
To add NIC bonds to the pool master and other hosts
To assign NIC functions using the xe CLI
Configuring a dedicated storage NIC
Controlling Quality of Service QoS
Changing networking configuration options
DNS servers
Changing IP address configuration for a standalone host
Changing IP address configuration in resource pools
Hostname
To change the NIC used for the management interface
Disabling management access
To change the IP address of a pool master host
Management interface
Re-ordering NICs
NIC/PIF ordering in resource pools
Adding a new physical NIC
Verifying NIC ordering
Diagnosing network corruption
Networking Troubleshooting
Recovering from a bad network configuration
Whats New?
New Features
Changes
Workload Balancing Overview
Workload Balancing Basic Concepts
Workload Balancing Installation Overview
Recommended Hardware
Workload Balancing System Requirements
Supported XenServer Versions
Supported Operating Systems
Workload Balancing Data Store Requirements
SQL Server Database Authentication Requirements
Operating System Language Support
Preinstallation Considerations
WLB Access Control Permissions
Installing Workload Balancing
To install Workload Balancing server
To verify your Workload Balancing installation
Upgrading Workload Balancing
Configuring Firewalls
Upgrading Workload Balancing and the Operating System
Initializing Workload Balancing
Upgrading Workload Balancing on the Same Operating System
Upgrading SQL Server
To initialize Workload Balancing
Authorization for Workload Balancing
Configuring Antivirus Software
Configuring Workload Balancing Settings
Scheduled
To display the Workload Balancing Configuration dialog box
Adjusting the Optimization Mode
Fixed
Optimizing and Managing Power Automatically
To set an optimization mode for all time periods
To edit or delete an automatic optimization interval
Accepting Optimization Recommendations Automatically
Enabling Workload Balancing Power Management
102
To select servers for power management
Changing the Critical Thresholds
To apply optimization recommendations automatically
Tuning Metric Weightings
Default Settings for Critical Thresholds
To change the critical thresholds
Excluding Hosts from Recommendations
To edit metric weighting factors
VM Optimization Criteria
Historical Data Storage Time
Number of Times an Optimization Recommendation is Made
To configure VM Recommendation intervals
To resume a virtual machine on the optimal server
To start a virtual machine on the optimal server
Administering Workload Balancing
Accepting Optimization Recommendations
To accept an optimization recommendation
Disabling Workload Balancing
Reconfiguring a Pool to Use Another WLB Server
Updating Workload Balancing Credentials
Click Update Credentials
Entering Maintenance Mode with Workload Balancing Enabled
Uninstalling Workload Balancing
Customizing Workload Balancing
Subscribing to Workload Balancing Reports
To enter maintenance mode with Workload Balancing enabled
Working with Workload Balancing Reports
Introduction
To subscribe to a Workload Balancing report
Using Workload Balancing Reports for Tasks
Generating and Managing Workload Balancing Reports
To generate a Workload Balancing report
To cancel a report subscription
To navigate in a Workload Balancing Report
Report Toolbar Buttons
Toolbar Buttons
Report Generation Features
Displaying Workload Balancing Reports
To print a Workload Balancing report
Host Health History
Workload Balancing Report Glossary
Pool Audit Log History
Pool Optimization Performance History
Audit Log Event Names
Pool Health
Pool Optimization History
Pool Health History
Virtual Machine Performance History
Virtual Machine Motion History
To backup a VM
Backups
To backup pool metadata
To backup host configuration and software
Full metadata backup and disaster recovery DR
DR and metadata backup overview
Backup and restore using xsconsole
Moving SRs between hosts and Pools
VM Snapshots
Using Portable SRs for Manual Multi-Site Disaster Recovery
Creating a VM Snapshot
Regular Snapshots
Quiesced Snapshots
Snapshots with memory
Creating a snapshot with memory
To list all of the snapshots on a XenServer pool
To list the snapshots on a particular VM
Deleting a snapshot
Restoring a VM to its previous state
Creating a template from a snapshot
Snapshot Templates
Advanced Notes for Quiesced Snapshots
Exporting a snapshot to a template
132
Coping with machine failures
Member failures
Master failures
Coping with Failure due to Configuration Errors
Pool failures
Physical Machine failure
To restore a VM when VM storage is not available
To restore a pool with all hosts failed
Alerts
Monitoring and managing XenServer
Valid VM Elements
Customizing Alerts
Valid Host Elements
Configuring Email Alerts
To determine PBD throughput
Custom Fields and Tags
Custom Searches
Determining throughput of physical bus adapters
XenServer host logs
Sending host log messages to a central server
To write logs to a remote server
Userprofile%\AppData\Citrix\XenCenter\logs\XenCenter.log
XenCenter logs
Basic xe syntax
Xe command-name argument=value argument=value
Special characters and syntax
Class-list
Command types
Low-level param commands
Parameter types
Class-param-list uuid=uuid
Low-level list commands
Bond-create
Xe command reference
Bonding commands
Bond parameters
CD parameters
CD commands
Cd-listparams=param1,param2,... parameter=parametervalue
Console commands
Console parameters
Cd-list
Event commands
Event classes
Event-wait
Host XenServer host commands
Host selectors
Host parameters
Parameter Name Description Type
Syslogdestination
Host-backupfile-name=backupfilenamehost=hostname
Host-backup
Host-crashdump-destroy
Host-disable
Host-emergency-management-reconfigure
Host-bugreport-upload
Host-get-system-status
Host-enable
Host-evacuate
Host-forget
Attribute Description
Host-get-system-status-capabilities
License-server-port
Host-is-in-emergency-mode
Host-apply-edition
License-server-address
Host-logs-download
Host-management-disable
Host-management-reconfigure
Host-license-view
Host-restore
Host-power-on
Host-set-power-on
Host-reboot
Log commands
Message-list
Message commands
Message parameters
Message-create
192.168.0.4
Network commands
Network parameters
Subnet/netmask/gateway
Network-destroy
Patch update commands
Patch parameters
Network-create
PBD parameters
PBD commands
Pbd-plug
PIF commands
Pbd-create
Pbd-destroy
MAC
PIF parameters
Dhcp
Pif-forget
Pif-introduce
Pif-forget uuid=uuidofpif
Pool parameters
Pool commands
Parameter Name Description Type
Pool-dump-database
Pool-emergency-reset-master
Pool-ha-enable
Pool-designate-new-master
SM parameters
Storage Manager commands
SR parameters
SR commands
Sr-destroy uuid=sruuid
Sr-create
Sr-destroy
Sr-forget
Sr-probe
Task commands
Task parameters
Sr-introduce
Template commands
Task-cancel
Task-cancel uuid=taskuuid
Template parameters
For memory-dynamic-max
Uuid=vmuuid \
Parameter Name Description Type
YyyymmddThhmmss z
As not in database for
Not in database for a
Form yyyymmddThhmmss
User-password-change
Update commands
User commands
Update-upload
VBD parameters
VBD commands
Vbd-create
VDI commands
VDI parameters
Tree /local/domain/0/backend
Vdi-clone
Vdi-copy
Vdi-create
Vdi-introduce
Vdi-destroy
Vdi-forget
Vdi-import
Vdi-unlockuuid=uuidofvditounlock force=true
VIF commands
VIF parameters
Vdi-unlock
Uuid=vifuuid \
Vif-unplug
Vif-create
Vif-destroy
Vif-plug
VM parameters
Vlan commands
VM commands
VM selectors
Parameter Name Description Type
Uuid=templateuuid \
Parameter Name Description Type
Value pair autopoweron true
VCPUs-number to a value
Domain/domid/vm
Vm-cd-add
Vm-cd-eject
Vm-cd-ejectvm-selector=vmselectorvalue
Vm-clone
Vm-cd-insert
Vm-cd-list
Vm-cd-remove
Vm-data-source-list
Vm-copy
Vm-crashdump-list
Vm-data-source-forget
Vm-disk-add
Vm-data-source-query
Vm-data-source-record
Vm-destroy
Vm-import
Vm-disk-list
Vm-disk-remove
Vm-export
Vm-install
Vm-memory-shadow-multiplier-set
Vm-migrate
Vm-shutdown
Vm-reboot
Vm-reset-powerstate
Vm-resume
Vm-vcpu-hotplug
Vm-uninstall
Vm-start
Vm-suspend
Workload Balancing commands
Pool-certificate-install
Pool-certificate-list
Pool-certificate-sync
Pool-retrieve-wlb-recommendations
Pool-deconfigure-wlb
Pool-retrieve-wlb-configuration
Pool-param-set
Pool-send-wlb-configuration
Pool-send-wlb-configuration
Index