Pool-designate-new-master, Pool-dump-database | Citrix Systems 6

Parameter Name	Description	Type

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

supported-sr-types	SR types that can be used by this	read only
	pool

ha-enabled	True if HA is enabled for the	read only
	pool, false otherwise

ha-configuration	reserved for future use.	read only

ha-statefiles	lists the UUIDs of the VDIs	read only
	being used by HA to determine
	storage health

ha-host-failures-to-tolerate	the number of host failures	read/write
	to tolerate before sending a
	system alert

ha-plan-exists-for	the number of hosts failures	read only
	that can actually be handled,
	according to the calculations of
	the HA algorithm

ha-allow-overcommit	True if the pool is allowed	read/write
	to be overcommitted, False
	otherwise

ha-overcommitted	True if the pool is currently	read only
	overcommitted

blobs	binary data store	read only

wlb-url	Path to the WLB server	read only

wlb-username	Name of the user of the WLB	read only
	service

wlb-enabled	True is WLB is enabled	read/write

wlb-verify-cert	True if there is a certificate to	read/write
	verify

pool-designate-new-master

pool-designate-new-masterhost-uuid=<UUID of member XenServer host to become new master>

Instruct the specified member XenServer host to become the master of an existing pool. This performs an orderly hand over of the role of master host to another host in the resource pool. This command only works when the current master is online, and is not a replacement for the emergency mode commands listed below.

pool-dump-database

pool-dump-databasefile-name=<filename_to_dump_database_into_(on_client)>

Download a copy of the entire pool database and dump it into a file on the client.

145

Image 163

Citrix Systems 6 manual Pool-designate-new-master, Pool-dump-database

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 Administering XenServer New Features in 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 XenCenter Term Authenticating Users With Active Directory ADXenServer CLI Term Upgrading XenServer Configuring Active Directory Authentication Port Protocol Use Active Directory integration Enabling external authentication on a pool User AuthenticationDisabling 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 Users role can be changed in two ways Definitions of Rbac Roles and PermissionsPermissions 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 Heterogeneous Resource Pools Creating a Resource PoolNaming a resource pool Adding Shared Storage Adding NFS shared storage to a resource pool using the CLI To remove a host from a resource pool using the CLI Preparing a Pool of XenServer Hosts for MaintenanceRemoving a XenServer Host from a Resource Pool HA Overview High AvailabilityOvercommitting Overcommitment Warning Configuration RequirementsHost Fencing HA Restart Priority Restart Explanation Restart PrioritiesHA Always Run Explanation Removing HA Protection from a VM using the CLI Enabling HA 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 To Enable Host Power On Using the CLI Using the CLI to Manage Host Power OnTo 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 Local LVM Storage Repository TypesStorage type Maximum VDI size Creating a Local EXT3 SR ext Local EXT3 VHDUdev Creating a Local LVM SR lvm Software iSCSI Support XenServer Host iSCSI configurationCitrix 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 Removing HBA-based SAS, FC or iSCSI Device Entries LVM over iSCSIParameter Name Description Parameter Name Description Hitachi NFS VHD Creating a Shared NFS SR NFS Storage ConfigurationLVM over Hardware HBA Creating Storage Repositories LVM Performance Considerations Upgrading LVM Storage from XenServer 5.0 or EarlierVDI Types Converting Between VDI Formats Creating a Raw Virtual Disk Using the xe CLIProbing 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? DMC Behaviour Concept of Static RangeHow Does DMC Work? Supported Operating Systems Memory ConstraintsOperating 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 Update Individual Memory Properties Upgrade IssuesWorkload Balancing Interaction Name Default Description Setting Control Domain Memory Name Default Description Networking Support VSwitch Networks Network Objects XenServer Networking Overview VLANs NetworksNIC Bonds Page Switch Configuration Active-Active Bonding Active-Passive Bonding Initial Networking Configuration Managing 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 Bonding two NICs Creating a NIC bondControlling the MAC Address of the Bond Reverting NIC bonds Creating NIC bonds in resource poolsAdding NIC bonds to new resource pools To assign NIC functions using the xe CLI Configuring a dedicated storage NICAdding NIC bonds to an existing pool Controlling the rate of outgoing data QoS Using SR-IOV Enabled NICsAssigning 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 pooled installations Backing up single host 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 To list all of the snapshots on a XenServer pool Creating a snapshot with memoryTo list the snapshots on a particular VM Deleting a snapshot Restoring a VM to its previous state Creating a template from a snapshot Snapshot TemplatesExporting a snapshot to a template Advanced Notes for Quiesced Snapshots Coping with machine failures VM Protection and RecoveryNaming convention for VM archive folders Member failures Opt/xensource/sm/resetvdis.py hostUUID Sruuid masterMaster failures Pool failures Coping with Failure due to Configuration ErrorsPhysical 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 Sending host log messages to a central server XenServer host logsTo 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 Command TypesClass-list Parameter Types Low-level List Commands Low-level Parameter 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 Classes Event CommandsClass 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