Chapter 10. Clusters
Chapter 10. Clusters 10.1. Cluster Elements The clusters collection provides information about clusters in a Red Hat Virtualization environment. An API user accesses this information through the rel="clusters" link obtained from the entry point URI. The following table shows specific elements contained in a cluster resource representation. Table 10.1. Cluster elements Element Type Description Properties name string A user-supplied, human-readable name for the cluster. The name is unique across all cluster resources. description string A free-form, user-supplied, human-readable description of the cluster. link rel="networks" relationship A link to the sub-collection for networks associated with this cluster. link rel="permissions" relationship A link to the sub-collection for cluster permissions. link rel="glustervolumes" relationship A link to the sub-collection for Red Hat Gluster Storage volumes associated with this cluster. link rel="glusterhooks" relationship A link to the sub-collection for Red Hat Gluster Storage volume hooks associated with this cluster. link rel="affinitygroups" relationship A link to the sub-collection for virtual machine affinity groups associated with this cluster. cpu id= complex A server CPU reference that defines the CPU type all hosts must support in the cluster. data_center id= GUID A reference to the data center membership of this cluster. memory_policy complex Defines the cluster's policy on host memory utilization. scheduling_policy complex Defines the load-balancing or power-saving modes for hosts in the cluster. version major= minor= complex The compatibility level of the cluster. supported_versions complex A list of possible version levels for the cluster. error_handling complex/enumerated Defines virtual machine handling when a host within a cluster becomes non-operational. Requires a single on_error element containing an enumerated type property listed in capabilities . virt_service Boolean Defines whether to expose virtualization services for this cluster. gluster_service Boolean Defines whether to expose Red Hat Gluster Storage services for this cluster. threads_as_cores Boolean Defines whether hosts can run virtual machines with a total number of processor cores greater than the number of cores in the host. tunnel_migration Boolean Defines whether virtual machines use a libvirt-to-libvirt tunnel during migration. trusted_service Boolean Defines whether an OpenAttestation server is used to verify hosts. ballooning_enabled Boolean Defines whether ballooning is enabled for the cluster. ksm Boolean Defines whether ksm is enabled for the cluster. Note When a host's free memory drops below 20%, ballooning commands like mom.Controllers.Balloon - INFO Ballooning guest:half1 from 1096400 to 1991580 are logged to /etc/vdsm/mom.conf . /etc/vdsm/mom.conf is the Memory Overcommit Manager log file. An event will also be added to the event log if a virtual machine does not respect a balloon.