deb-python-pyvmomi/docs/vim/cluster/DasConfigInfo.rst

vim.cluster.DasConfigInfo

The ClusterDasConfigInfo data object contains configuration data about the HA service on a cluster.All fields are optional. If you set themodifyparameter totruewhen 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 themodifyparameter tofalsewhen you reconfigure a cluster, the cluster configuration is reverted to the default values, then the new configuration values are applied.

extends

vmodl.DynamicData

Attributes:

enabled (bool, optional):

Flag to indicate whether or not vSphere HA feature is enabled.

vmMonitoring (str, optional):

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 .

hostMonitoring (str, optional):

Determines whether HA restarts virtual machines after a host fails. The default value is ClusterDasConfigInfoServiceState . enabled . This property is meaningful only when ClusterDasConfigInfo . enabled istrue.WhenhostMonitoringis enabled , HA restarts virtual machines after a host fails.WhenhostMonitoringis 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.

failoverLevel (int, optional):

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.

admissionControlPolicy (vim.cluster.DasAdmissionControlPolicy, optional):

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.

admissionControlEnabled (bool, optional):

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.

defaultVmSettings (vim.cluster.DasVmSettings, optional):

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

option ([vim.option.OptionValue], optional):

Advanced settings.

heartbeatDatastore ([vim.Datastore], optional):

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 .

hBDatastoreCandidatePolicy (str, optional):

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 .