Data Object - ClusterDasConfigInfo

Property of
ClusterConfigInfo, ClusterConfigInfoEx, ClusterConfigSpec, ClusterConfigSpecEx
Extends
DynamicData
See also
ClusterDasAdmissionControlPolicy, ClusterDasVmSettings, Datastore, OptionValue

Data Object Description

The ClusterDasConfigInfo data object contains configuration data about the HA service on a cluster.

All fields are optional. If you set the modify parameter to true when you call ReconfigureComputeResource_Task, an unset property has no effect on the existing property value in the cluster configuration on the Server. If you set the modify parameter to false when you reconfigure a cluster, the cluster configuration is reverted to the default values, then the new configuration values are applied.

Properties

Name Type Description
admissionControlEnabled*xsd:boolean

Flag that determines whether strict admission control is enabled. When you use admission control, the following operations are prevented, if doing so would violate the admissionControlPolicy.
  • Powering on a virtual machine in the cluster.
  • Migrating a virtual machine into the cluster.
  • Increasing the CPU or memory reservation of powered-on virtual machines in the cluster.

With admission control disabled, there is no assurance that all virtual machines in the HA cluster can be restarted after a host failure. VMware recommends that you do not disable admission control, but you might need to do so temporarily, for the following reasons:

  • If you need to violate the failover constraints when there are not enough resources to support them (for example, if you are placing hosts in standby mode to test them for use with DPM).
  • If an automated process needs to take actions that might temporarily violate the failover constraints (for example, as part of an upgrade directed by VMware Update Manager).
  • If you need to perform testing or maintenance operations.

admissionControlPolicy*ClusterDasAdmissionControlPolicy

Virtual machine admission control policy for vSphere HA. The policies specify resource availability for failover support.
  • Failover host admission policy ClusterFailoverHostAdmissionControlPolicy - currently you can specify only one failover host.
  • Failover level policy ClusterFailoverLevelAdmissionControlPolicy - the limit of host failures for which resources are reserved. When you use the failover level policy, HA partitions resources into slots. A slot represents the minimum CPU and memory resources that are required to support any powered on virtual machine in the cluster. To retrieve information about partitioned resources, use the RetrieveDasAdvancedRuntimeInfo method.
  • Resources admission policy ClusterFailoverResourcesAdmissionControlPolicy - CPU and memory resources reserved for failover support. When you use the resources policy, you can reserve a percentage of the aggregate cluster resource for failover.

Since vSphere API 4.0
defaultVmSettings*ClusterDasVmSettings

Cluster-wide defaults for virtual machine HA settings. When a virtual machine has no HA configuration (ClusterDasVmConfigSpec), it uses the values specified here.

Since VI API 2.5
enabled*xsd:boolean

Flag to indicate whether or not vSphere HA feature is enabled.
failoverLevel*xsd:intDeprecated. As of vSphere API 4.0, use ClusterFailoverLevelAdmissionControlPolicy to set admissionControlPolicy.

Configured failover level. This is the number of physical host failures that can be tolerated without impacting the ability to satisfy the minimums for all running virtual machines. Acceptable values range from one to four.
hBDatastoreCandidatePolicy*xsd:string

The policy on what datastores will be used by vCenter Server to choose heartbeat datastores. See ClusterDasConfigInfoHBDatastoreCandidate for all options. The default value is allFeasibleDsWithUserPreference.

Since vSphere API 5.0
heartbeatDatastore*ManagedObjectReference[]
to a Datastore[]

The list of preferred datastores to use for storage heartbeating. Each of the specified datastores should be active and mounted by more than one host. There is no limit on the number of specified datastores and no priority among them. The specified datastores will replace those previously specified and an empty list will delete all such earlier specified ones.

vCenter Server chooses the heartbeat datastores for a host from the set specified by hBDatastoreCandidatePolicy. The choice is made based on datastore connectivity and storage array redundancy (in case of VMFS).

The final set of selected heartbeat datastores is reported via heartbeatDatastoreInfo.

Since vSphere API 5.0
hostMonitoring*xsd:string

Determines whether HA restarts virtual machines after a host fails. The default value is ClusterDasConfigInfoServiceState.enabled. This property is meaningful only when ClusterDasConfigInfo.enabled is true.

When hostMonitoring is enabled, HA restarts virtual machines after a host fails.

When hostMonitoring is disabled, HA does not restart virtual machines after a host fails. The status of Host Monitoring does not affect other services such as virtual machine Health Monitoring or Fault Tolerance. The rest of the cluster operations follow normal processing. No configuration information is lost and re-enabling the service is a quick operation.

Since vSphere API 4.0
option*OptionValue[]

Advanced settings.
vmMonitoring*xsd:string

Level of HA Virtual Machine Health Monitoring Service. You can monitor both guest and application heartbeats, guest heartbeats only, or you can disable the service. See ClusterDasConfigInfoVmMonitoringState. The default value is vmMonitoringDisabled.

The Service level specified for the cluster determines the possible monitoring settings that you can use for individual virtual machines. See ClusterVmToolsMonitoringSettings.vmMonitoring.

Since vSphere API 4.0
Properties inherited from DynamicData
dynamicProperty, dynamicType
*Need not be set
Show WSDL type definition