6.7 Unique VM Host Cluster Facts

There are several VM host Cluster related facts that are not found in a regular VM host object. This section contains detail about those facts.

6.7.1 Orchestrate Facts in the VM Host Cluster Object

Any vSphere clusters discovered by PlateSpin Orchestrate are listed in the Development Client as members of a convenience group (for example, a group named clusters_vsphere). The following table lists the read-only, cluster-related facts in a VM host Cluster object.

Table 6-1 Cluster-Related Facts in a Cluster Object

Fact Name

Type

Description

vmhost.cluster.vmhosts

String[]

This string array lists all of the VM hosts that are members of this cluster.

vmhost.location

String

The data center Managed Object Reference (MOR) path to the cluster.

vmhost.vphere.cluster.das.admission_control_enabled

Boolean

If this fact value is true, the VM host cluster has HA configuration to use admission control.

NOTE:HA was originally named “Dynamic Availability Service” (DAS) in VMware. This is the origin of the .das. prefix.

vmhost.vphere.cluster.das.enabled

Boolean

If this fact value is true, HA is turned on in this cluster.

vmhost.vphere.cluster.drs.allow_behavior_override

Boolean

Whether VMs can specify their own placement behavior.

vmhost.vphere.cluster.drs.default_behavior

String

Specifies manual, partially automated, or fully automated VM placement.

vmhost.vphere.cluster.drs.enabled

Boolean

If this fact value is true, DRS is turned on in this cluster.

vmhost.vphere.pools

Dictionary

The mapping of the pool MOR path to dictionaries of pool configuration values.

vmhost.type

String

The “type” differentiation for clusters vs. VM hosts (the value is either vmhost or vmhostcluster.

6.7.2 Orchestrate Facts in a VM Host Residing in a Cluster

The following table lists the read-only, cluster-related facts in a virtual or physical machine with an installed Orchestrate Agent and residing in a cluster.

Table 6-2 Cluster-Related Facts in a VM Host Residing in a vSphere Cluster

Fact Name

Type

Description

vmhost.cluster

String[]

The ID of the cluster that contains this host.

vmhost.type

String

The “type” differentiation for clusters vs. VM hosts (the value is either vmhost or vmhostcluster.

6.7.3 Orchestrate Facts in VMs Hosted in Clusters

The following table lists the read-only, cluster-related facts in a VM hosted in vSphere clusters.

Table 6-3 Cluster-Related Facts in VMs Hosted in Clusters

Fact Name

Type

Description

resource.provision.vmhost

String

The ID of the VM host cluster or VM host that contains this VM.

When provisioning or migrating to a cluster, this value is initially the cluster ID. On subsequent resync or discovery or when using the VsphereUpdate daemon, this is set to the value of the selected VM host within the cluster.

resource.vm.pool

String

The MOR path of the resource pool that contains this VM.

This value is also a key in the vmhost.vsphere.pools dictionary.

resource.vm.vmhost.location

String

The MOR path of the VM host cluster that contains this VM.

This is always the cluster if the VM host is in a cluster; otherwise, it is the MOR path of the VM host itself.

resource.vm.vsphere.cpu.limit

Integer

The maximum amount (in MHz) of CPU resources to be used by this VM.

resource.vm.vsphere.cpu.reservation

Integer

The minimum amount (in MHz) of CPU resources guaranteed to this VM.

resource.vm.vsphere.cpu.shares.level

String

The relative amount (assigned a value of low, normal, high, or custom) of CPU allocated for this VM.

resource.vm.vsphere.cpu.shares.custom

Integer

The custom amount of relative CPU for this VM.

This fact is valid only when the value for the resource.vm.vsphere.cpu.shares.level fact is “custom.”

resource.vm.vsphere.memory.limit

Integer

The maximum amount (measured in MB) of memory resources to be used by this VM.

resource.vm.vsphere.memory.reservation

Integer

The minimum amount (measured in MB) of memory resources guaranteed to this VM.

resource.vm.vsphere.memory.shares.level

String

The relative amount (assigned a value of low, normal, high, or custom) of memory specified for this VM.

resource.vm.vsphere.memory.shares.custom

Integer

The custom amount of relative memory for this VM.

This fact is valid only when the value for the resource.vm.vsphere.memory.shares.level fact is “custom.”