Citrix Systems 6 manual

template-export	157
Update Commands	157
update-upload	158
User Commands	158
user-password-change	158
VBD Commands	158
VBD Parameters	158
vbd-create	159
vbd-destroy	160
vbd-eject	160
vbd-insert	160
vbd-plug	160
vbd-unplug	160
VDI Commands	160
VDI Parameters	161
vdi-clone	162
vdi-copy	162
vdi-create	162
vdi-destroy	163
vdi-forget	163
vdi-import	163
vdi-introduce	163
vdi-resize	163
vdi-snapshot	164
vdi-unlock	164
VIF Commands	164
VIF Parameters	164
vif-create	166
vif-destroy	166
vif-plug	166
vif-unplug	166

xv

Image 15

Citrix Systems 6 manual

Contents

Citrix XenServer 6.0 Administrators Guide Trademarks Contents Storage ISO Configuring VM Memory Xen Memory Usage Disaster Recovery and Backup Monitoring and Managing XenServer 106 110 Page Host-bugreport-upload 129 Xiii Xiv Page Vm-compute-maximum-memory Workload Balancing Service Commands 186 Xviii Introducing XenServer Benefits of Using XenServerUsing XenServer reduces costs by Using XenServer increases flexibility by New Features in XenServer Administering XenServerXenServer Editions Microsoft Scvmm and Scom Support Rolling Pool Upgrade WizardDistributed Virtual Switch Improvements Simplified Installer XenCenter Improvements VM Protection and RecoveryXenServer Documentation NFS Support for High Availability Authenticating Users With Active Directory AD XenCenter TermXenServer CLI Term Upgrading XenServer Configuring Active Directory Authentication Port Protocol Use Active Directory integration User Authentication Enabling external authentication on a poolDisabling external authentication Listing subjects with access Removing Access for a UserAllowing a user access to XenServer using the CLI Removing access for a user using the CLI Leaving an AD Domain Role Based Access ControlTerminating all authenticated sessions using xe Terminating individual user sessions using xe Rbac process Roles Definitions of Rbac Roles and Permissions Users role can be changed in two waysPermissions available for each role WLB Permission Allows Assignee To Rationale/Comments Definitions of permissions Permission Allows Assignee To Rationale/Comments Report Generated or its recipient To List All the Available Defined Roles in XenServer Using Rbac with the CLI To Display a List of Current Subjects To Change a Subjects Rbac Role Run the command xe subject-add subject-name=AD user/groupTo 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 CommandsAuditing How Does XenServer Compute the Roles for the Session?Page Requirements for Creating Resource Pools Hosts and Resource Pools Overview Creating a Resource Pool Creating Heterogeneous Resource PoolsNaming a resource pool Adding Shared Storage Adding NFS shared storage to a resource pool using the CLI Preparing a Pool of XenServer Hosts for Maintenance To remove a host from a resource pool using the CLIRemoving a XenServer Host from a Resource Pool High Availability HA OverviewOvercommitting Configuration Requirements Overcommitment WarningHost Fencing Restart Priorities HA Restart Priority Restart ExplanationHA Always Run Explanation Enabling HA Using the CLI Removing HA Protection from a VM using the CLIEnabling HA on a XenServer Pool Shutting Down a VM When it is Protected by HA Host Power OnRecovering an Unreachable Host Shutting Down a host When HA is Enabled Using the CLI to Manage Host Power On To Enable Host Power On Using the CLITo Turn on Hosts Remotely Using the CLI Sample Script Key/Value Pairs Result is only displayed when the script is unsuccessful Physical Block Devices PBDs Storage OverviewStorage Repositories SRs Virtual Disk Images VDIs VHD-based VDIs Virtual Block Devices VBDsSummary of Storage objects Virtual Disk Data Formats VHD Chain Coalescing LUN-based VDIs Storage Repository Types Local LVMStorage type Maximum VDI size Creating a Local EXT3 SR ext Local EXT3 VHDUdev Creating a Local LVM SR lvm XenServer Host iSCSI configuration Software iSCSI SupportCitrix StorageLink SRs Creating a Shared StorageLink SR Upgrading XenServer with StorageLink SRs Parameter name Description Optional? To Create a CSL SR Using XenCenter To Create a CSL SR Using the CLI Page Managing Hardware Host Bus Adapters HBAs Sample QLogic iSCSI HBA setup LVM over iSCSI Removing HBA-based SAS, FC or iSCSI Device EntriesParameter Name Description Parameter Name Description Hitachi NFS VHD Creating a Shared NFS SR NFS Storage ConfigurationLVM over Hardware HBA Creating Storage Repositories Upgrading LVM Storage from XenServer 5.0 or Earlier LVM Performance ConsiderationsVDI Types Creating a Raw Virtual Disk Using the xe CLI Converting Between VDI FormatsProbing an SR Following parameters can be probed for each SR type Page Storage Multipathing To enable storage multipathing using the xe CLI Introducing an SR Managing Storage RepositoriesMPP Rdac Driver Support for LSI Arrays Destroying or Forgetting a SR Converting Local Fibre Channel SRs to Shared SRs Resizing an SR Copying Individual VDIs to a Different SR Adjusting the Disk IO SchedulerMoving Virtual Disk Images VDIs Between SRs Copying All of a VMs VDIs to a Different SR Reclaiming Space Using the Off Line Coalesce Tool Automatically Reclaiming Space When Deleting Snapshots Possible values of qosalgorithmparamsched are Virtual Disk QoS SettingsPage Concept of Dynamic Range What is Dynamic Memory Control DMC? Concept of Static Range DMC BehaviourHow Does DMC Work? Memory Constraints Supported Operating SystemsOperating System Supported Memory Limits Display the Static Memory Properties of a VM Xe CLI Commands Updating Memory Properties Display the Dynamic Memory Properties of a VM Upgrade Issues Update Individual Memory PropertiesWorkload Balancing Interaction Name Default Description Setting Control Domain Memory Name Default Description Networking Support VSwitch Networks Network Objects XenServer Networking Overview Networks VLANsNIC Bonds Page Switch Configuration Active-Active Bonding Active-Passive Bonding Managing Networking Configuration Initial Networking ConfigurationCross-Server Private networks Creating Networks in a Standalone Server Creating VLANs To add a new network using the CLITo connect a network to an external Vlan using the CLI Creating Networks in Resource Pools Creating a NIC bond Bonding two NICsControlling the MAC Address of the Bond Creating NIC bonds in resource pools Reverting NIC bondsAdding NIC bonds to new resource pools Configuring a dedicated storage NIC To assign NIC functions using the xe CLIAdding NIC bonds to an existing pool Using SR-IOV Enabled NICs Controlling the rate of outgoing data QoSAssigning a SR-IOV NIC VF to a VM Networking Stack Configuration Methods Available Changing networking configuration options DNS servers Changing IP address configuration for a standalone hostChanging IP address configuration in resource pools Hostname Adding a new physical NIC Networking TroubleshootingDisabling management access Primary management interface Diagnosing network corruption Recovering from a bad network configuration Understanding XenServer DR Disaster Recovery and Backup DR Infrastructure Requirements Steps to Take Before a Disaster Enabling Disaster Recovery in XenCenterSteps to Take After a Recovery Deployment Considerations Recovering VMs and vApps in the Event of Disaster Failover Test Failover Recovery Wizard VApps Value Description Using the Manage vApps dialog box in XenCenterBacking Up and Restoring XenServer Hosts and VMs Creating vApps To backup VM metadata only To backup pool metadataTo backup host configuration and software To backup a VM Backing up single host installations Backing up pooled installationsBacking up XenServer hosts Restarting a crashed XenServer host To restore a running XenServer hostBacking up VMs To back up a XenServer host Snapshots with memory VM SnapshotsRegular Snapshots Quiesced Snapshots Creating a snapshot with memory To list all of the snapshots on a XenServer poolTo list the snapshots on a particular VM Deleting a snapshot Restoring a VM to its previous state Snapshot Templates Creating a template from a snapshotExporting a snapshot to a template Advanced Notes for Quiesced Snapshots VM Protection and Recovery Coping with machine failuresNaming convention for VM archive folders Opt/xensource/sm/resetvdis.py hostUUID Sruuid master Member failuresMaster failures Coping with Failure due to Configuration Errors Pool failuresPhysical Machine failure To restore a VM when VM storage is not available To restore a pool with all hosts failed Alert Description Alerts Valid VM Elements Customizing Alerts Valid Host Elements Configuring Email Alerts To determine PBD throughput Custom Fields and TagsCustom Searches Determining throughput of physical bus adapters XenServer host logs Sending host log messages to a central serverTo 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 Command Types Special Characters and SyntaxClass-list Parameter Types Low-level Parameter Commands Low-level List CommandsClass-param-list uuid=uuid Appliance Parameters Xe Command ReferenceAppliance Commands Appliance-assert-can-be-recovered Audit Commands CD Commands Bonding Commands Cd-listparams=param1,param2,... parameter=parametervalue Cd-list Drtask-create Console CommandsDisaster Recovery DR Commands Console Parameters Sr-disable-database-replication Vm-assert-can-be-recoveredVm-recover Sr-enable-database-replication Event Commands Event ClassesClass name Description Event-wait GPU Commands GPU Group Parameters Host Selectors Host CommandsVgpu-create Vgpu-destroy Host Parameters Syslogdestination Yyyymmdd-hhmmss-ABC, where ABC is Host-crashdump-destroy Host-backupHost-disable Host-bugreport-upload Host-forget Host-emergency-management-reconfigureHost-enable Host-evacuate Attribute Description Host-get-system-status-capabilities Host-license-add Host-management-disableHost-is-in-emergency-mode Host-apply-edition Host-set-cpu-features Host-management-reconfigureHost-power-on Host-get-cpu-features Host-shutdown Host-restoreHost-syslog-reconfigure Host-set-hostname-live Host-data-source-query Host-data-source-listHost-data-source-record Host-data-source-forget Message Parameters Log CommandsMessage Commands Log-set-output Network Parameters Network CommandsMessage-destroy Message-list Patch Parameters Patch Update CommandsNetwork-create Network-destroy PBD Commands Pbd-plug PIF CommandsPbd-create Pbd-destroy MAC PIF Parameters Full or half Pif-plug Pif-reconfigure-ipPif-forget Pif-introduce Pool Parameters Pool CommandsPif-scan Pif-unplug Pool-dump-database Pool-designate-new-master Pool-recover-slaves Pool-emergency-reset-masterPool-ha-enable Pool-ha-disable SR Parameters Storage Manager CommandsSR Commands SM Parameters User Sr-create Sr-probe Sr-destroySr-forget Sr-introduce Task Parameters Task Commands Template Parameters Template CommandsTask-cancel Task-cancel uuid=taskuuid For memory-dynamic-max Uuid=templateuuid \ Order Order or an YyyymmddThhmmss Not As not in database for Template-export Update Commands User-password-change User CommandsVBD Commands Update-upload Vbd-createvm-uuid=uuidofthevmdevice=devicevalue Vbd-create VDI Commands VDI VDI Parameters Local/domain/0/backend Vdi-cloneVdi-copy Vdi-create Vdi-introduce Vdi-destroyVdi-forget Vdi-import VIF Parameters VIF CommandsVdi-snapshot Vdi-unlock Disable 165 Vif-plug Vlan CommandsVif-create Vif-destroy VM Commands Parameter Name Description Type Uuid=vmuuid \ Order Value pair autopoweron true Vcpu-hotplug command Domain/domid/vm Vm-cd-list Vm-cd-addVm-cd-eject Vm-cd-insert Vm-crashdump-list Vm-cloneVm-compute-maximum-memory Vm-copy Vm-data-source-query Vm-data-source-listVm-data-source-record Vm-data-source-forget Vm-disk-remove Vm-destroyVm-disk-add Vm-disk-list Vm-import Vm-install Vm-migrate Vm-rebootVm-reset-powerstate Vm-memory-shadow-multiplier-set Vm-suspend Vm-resumeVm-shutdown Vm-start Workload Balancing XE Commands Vm-retrieve-wlb-recommendations Pool-retrieve-wlb-diagnosticsPool-certificate-install Host-retrieve-wlb-evacuate-recommendations Pool-retrieve-wlb-report Pool-deconfigure-wlbPool-retrieve-wlb-configuration Pool-retrieve-wlb-recommendations Pool-send-wlb-configuration 185 Service Commands To edit the wlb.conf file Modifying the Workload Balancing configuration optionsEditing the Workload Balancing configuration file To run the wlbconfig command Logging Trace Flag Benefit or Purpose Option Increasing the Detail in the Workload Balancing Log Logging Trace Flag Benefit or Purpose Option