Host Parameters | Citrix Systems 6 guide

Host Parameters

XenServer hosts have the following parameters:

Parameter Name	Description					Type

uuid	The	unique		identifier/object		read only
	reference		for	the	XenServer
	host

name-label	The name of the XenServer host					read/write

name-description	The description string of the					read only
	XenServer host

enabled	false if disabled which prevents					read only
	any new VMs from starting
	on them, which prepares the
	XenServer hosts to be shut
	down or rebooted; true if the
	host is currently enabled

API-version-major	major version number					read only

API-version-minor	minor version number					read only

API-version-vendor	identification of API vendor					read only

API-version-vendor-implementation	details			of	vendor	read only map parameter
	implementation

logging	logging configuration					read/write map parameter

suspend-image-sr-uuid	the	unique		identifier/object		read/write
	reference for the SR where
	suspended images are put

crash-dump-sr-uuid	the	unique		identifier/object		read/write
	reference for the SR where
	crash dumps are put

software-version	list	of versioning			parameters	read only map parameter
	and their values

capabilities	list of Xen versions that the					read only set parameter
	XenServer host can run

other-config	A list of key/value pairs that					read/write map parameter
	specify additional configuration
	parameters		for the		XenServer
	host

chipset-info	A list of key/value pairs that					Read only map parameter
	specify information				about the
	chipset

hostname	XenServer host hostname					read only

address	XenServer host IP address					read only

126

Image 144

Citrix Systems 6 manual Host Parameters

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 Benefits of Using XenServer Using XenServer reduces costs byUsing XenServer increases flexibility by Introducing XenServer New Features in XenServer Administering XenServerXenServer Editions Rolling Pool Upgrade Wizard Distributed Virtual Switch ImprovementsSimplified Installer Microsoft Scvmm and Scom Support VM Protection and Recovery XenServer DocumentationNFS Support for High Availability XenCenter Improvements Authenticating Users With Active Directory AD XenCenter TermXenServer CLI Term Configuring Active Directory Authentication Upgrading XenServer Active Directory integration Port Protocol Use User Authentication Enabling external authentication on a poolDisabling external authentication Removing Access for a User Allowing a user access to XenServer using the CLIRemoving access for a user using the CLI Listing subjects with access Role Based Access Control Terminating all authenticated sessions using xeTerminating individual user sessions using xe Leaving an AD Domain Roles Rbac process Definitions of Rbac Roles and Permissions Users role can be changed in two waysPermissions available for each role WLB Definitions of permissions Permission Allows Assignee To Rationale/Comments Permission Allows Assignee To Rationale/Comments Report Generated or its recipient Using Rbac with the CLI To List All the Available Defined Roles in XenServer To Display a List of Current Subjects Run the command xe subject-add subject-name=AD user/group To Add a Subject to RbacTo Assign an Rbac Role to a Created subject To Change a Subjects Rbac Role Audit Log xe CLI Commands AuditingHow Does XenServer Compute the Roles for the Session? To Obtain All Audit Records From the PoolPage Hosts and Resource Pools Overview Requirements for Creating Resource Pools Creating a Resource Pool Creating Heterogeneous Resource PoolsNaming a resource pool Adding NFS shared storage to a resource pool using the CLI Adding Shared Storage 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 Host Power On Recovering an Unreachable HostShutting Down a host When HA is Enabled Shutting Down a VM When it is Protected by HA Using the CLI to Manage Host Power On To Enable Host Power On Using the CLITo Turn on Hosts Remotely Using the CLI Key/Value Pairs Sample Script Result is only displayed when the script is unsuccessful Storage Overview Storage Repositories SRsVirtual Disk Images VDIs Physical Block Devices PBDs Virtual Block Devices VBDs Summary of Storage objectsVirtual Disk Data Formats VHD-based VDIs LUN-based VDIs VHD Chain Coalescing Storage Repository Types Local LVMStorage type Maximum VDI size Local EXT3 VHD UdevCreating a Local LVM SR lvm Creating a Local EXT3 SR ext XenServer Host iSCSI configuration Software iSCSI SupportCitrix StorageLink SRs Upgrading XenServer with StorageLink SRs Creating a Shared StorageLink SR To Create a CSL SR Using XenCenter Parameter name Description Optional? To Create a CSL SR Using the CLI Page Sample QLogic iSCSI HBA setup Managing Hardware Host Bus Adapters HBAs LVM over iSCSI Removing HBA-based SAS, FC or iSCSI Device EntriesParameter Name Description Parameter Name Description Hitachi NFS VHD Storage Configuration LVM over Hardware HBACreating Storage Repositories Creating a Shared NFS SR NFS 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 To enable storage multipathing using the xe CLI Storage Multipathing Managing Storage Repositories MPP Rdac Driver Support for LSI ArraysDestroying or Forgetting a SR Introducing an SR Resizing an SR Converting Local Fibre Channel SRs to Shared SRs Adjusting the Disk IO Scheduler Moving Virtual Disk Images VDIs Between SRsCopying All of a VMs VDIs to a Different SR Copying Individual VDIs to a Different SR Automatically Reclaiming Space When Deleting Snapshots Reclaiming Space Using the Off Line Coalesce Tool Virtual Disk QoS Settings Possible values of qosalgorithmparamsched arePage What is Dynamic Memory Control DMC? Concept of Dynamic Range Concept of Static Range DMC BehaviourHow Does DMC Work? Memory Constraints Supported Operating SystemsOperating System Supported Memory Limits 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 PropertiesWorkload Balancing Interaction Setting Control Domain Memory Name Default Description Name Default Description VSwitch Networks Networking Support XenServer Networking Overview Network Objects 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 To add a new network using the CLI To connect a network to an external Vlan using the CLICreating Networks in Resource Pools Creating VLANs 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 Changing networking configuration options Networking Stack Configuration Methods Available Changing IP address configuration for a standalone host Changing IP address configuration in resource poolsHostname DNS servers Networking Troubleshooting Disabling management accessPrimary management interface Adding a new physical NIC Recovering from a bad network configuration Diagnosing network corruption Disaster Recovery and Backup Understanding XenServer DR DR Infrastructure Requirements Enabling Disaster Recovery in XenCenter Steps to Take After a RecoveryDeployment Considerations Steps to Take Before a Disaster Recovering VMs and vApps in the Event of Disaster Failover Recovery Wizard Test Failover VApps Using the Manage vApps dialog box in XenCenter Backing Up and Restoring XenServer Hosts and VMsCreating vApps Value Description To backup pool metadata To backup host configuration and softwareTo backup a VM To backup VM metadata only Backing up single host installations Backing up pooled installationsBacking up XenServer hosts To restore a running XenServer host Backing up VMsTo back up a XenServer host Restarting a crashed XenServer host VM Snapshots Regular SnapshotsQuiesced Snapshots Snapshots with memory Creating a snapshot with memory To list all of the snapshots on a XenServer poolTo list the snapshots on a particular VM Restoring a VM to its previous state Deleting a snapshot 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 pool with all hosts failed To restore a VM when VM storage is not available Alerts Alert Description Customizing Alerts Valid VM Elements Configuring Email Alerts Valid Host Elements Custom Fields and Tags Custom SearchesDetermining throughput of physical bus adapters To determine PBD throughput XenServer host logs Sending host log messages to a central serverTo write logs to a remote server XenCenter logs Userprofile%\AppData\Citrix\XenCenter\logs\XenCenter.log Xe command-name argument=value argument=value Basic xe Syntax Command Types Special Characters and SyntaxClass-list Parameter Types Low-level Parameter Commands Low-level List CommandsClass-param-list uuid=uuid Xe Command Reference Appliance CommandsAppliance-assert-can-be-recovered Appliance Parameters Audit Commands Bonding Commands CD Commands Cd-list Cd-listparams=param1,param2,... parameter=parametervalue Console Commands Disaster Recovery DR CommandsConsole Parameters Drtask-create Vm-assert-can-be-recovered Vm-recoverSr-enable-database-replication Sr-disable-database-replication Event Commands Event ClassesClass name Description GPU Commands Event-wait GPU Group Parameters Host Commands Vgpu-createVgpu-destroy Host Selectors Host Parameters Syslogdestination Yyyymmdd-hhmmss-ABC, where ABC is Host-backup Host-disableHost-bugreport-upload Host-crashdump-destroy Host-emergency-management-reconfigure Host-enableHost-evacuate Host-forget Host-get-system-status-capabilities Attribute Description Host-management-disable Host-is-in-emergency-modeHost-apply-edition Host-license-add Host-management-reconfigure Host-power-onHost-get-cpu-features Host-set-cpu-features Host-restore Host-syslog-reconfigureHost-set-hostname-live Host-shutdown Host-data-source-list Host-data-source-recordHost-data-source-forget Host-data-source-query Log Commands Message CommandsLog-set-output Message Parameters Network Commands Message-destroyMessage-list Network Parameters Patch Update Commands Network-createNetwork-destroy Patch Parameters PBD Commands PIF Commands Pbd-createPbd-destroy Pbd-plug PIF Parameters MAC Full or half Pif-reconfigure-ip Pif-forgetPif-introduce Pif-plug Pool Commands Pif-scanPif-unplug Pool Parameters Pool-designate-new-master Pool-dump-database Pool-emergency-reset-master Pool-ha-enablePool-ha-disable Pool-recover-slaves Storage Manager Commands SR CommandsSM Parameters SR Parameters Sr-create User Sr-destroy Sr-forgetSr-introduce Sr-probe Task Commands Task Parameters Template Commands Task-cancelTask-cancel uuid=taskuuid Template Parameters For memory-dynamic-max Uuid=templateuuid \ Order or an Order Not YyyymmddThhmmss As not in database for Update Commands Template-export User Commands VBD CommandsUpdate-upload User-password-change Vbd-create Vbd-createvm-uuid=uuidofthevmdevice=devicevalue VDI Commands VDI Parameters VDI Vdi-clone Vdi-copyVdi-create Local/domain/0/backend Vdi-destroy Vdi-forgetVdi-import Vdi-introduce VIF Commands Vdi-snapshotVdi-unlock VIF Parameters Disable 165 Vlan Commands Vif-createVif-destroy Vif-plug VM Commands Parameter Name Description Type Uuid=vmuuid \ Order Value pair autopoweron true Vcpu-hotplug command Domain/domid/vm Vm-cd-add Vm-cd-ejectVm-cd-insert Vm-cd-list Vm-clone Vm-compute-maximum-memoryVm-copy Vm-crashdump-list Vm-data-source-list Vm-data-source-recordVm-data-source-forget Vm-data-source-query Vm-destroy Vm-disk-addVm-disk-list Vm-disk-remove Vm-install Vm-import Vm-reboot Vm-reset-powerstateVm-memory-shadow-multiplier-set Vm-migrate Vm-resume Vm-shutdownVm-start Vm-suspend Workload Balancing XE Commands Pool-retrieve-wlb-diagnostics Pool-certificate-installHost-retrieve-wlb-evacuate-recommendations Vm-retrieve-wlb-recommendations Pool-deconfigure-wlb Pool-retrieve-wlb-configurationPool-retrieve-wlb-recommendations Pool-retrieve-wlb-report Pool-send-wlb-configuration 185 Service Commands Modifying the Workload Balancing configuration options Editing the Workload Balancing configuration fileTo run the wlbconfig command To edit the wlb.conf file Increasing the Detail in the Workload Balancing Log Logging Trace Flag Benefit or Purpose Option Logging Trace Flag Benefit or Purpose Option