Cluster node

A Cluster node represents a group of hosts collaborating to form a cluster. The Cluster node represents the group rather than a single physical entity. They are also used represent mainframe sysplexes. Cluster nodes are under the full control of patterns.

For detailed information about patterns, see the The Pattern Language TPL and Configipedia.

Cluster node lifecycle

The following section describes the scenarios in which a Cluster node is created, updated, or removed.

Creation

The creation of a Cluster node is under the full control of patterns. Clusters are created when they are detected on a host by a pattern which is searching for them. The pattern contains the conditions which enable it to detect a cluster. Once found, the pattern creates the Cluster that it needs. A relationship link is automatically created to the Host node and the Cluster will have a key generated.

The generated key for a Cluster node is entirely dependent on the kind of Cluster.

Update

The update procedure for a Cluster node is also under full control of patterns. When the pattern has identified a cluster, it calculates a key. If a Cluster node with that key already exists, it is updated accordingly.

Removal

A Cluster node can be destroyed either manually or automatically. Cluster nodes are automatically removed when the last remaining Host node or MFPart is unlinked. In some cases, particular patterns might not create a cluster until hosts are detected. In these cases, the pattern will remove the Cluster node when there is only one host linked to it. For vCenter cluster nodes, cluster nodes are removed when a VMware cluster no longer exists.

To manually remove a Cluster node, find the necessary Cluster, select it in the list and pick Destroy from the Actions list. Aging of Clusters node are controlled by a Software Instance node. For more information about cluster aging, see Software Instance node.

This is a Cascade Removal type, see Cascade Removal.

Cluster node attributes

The attributes on a Cluster node as described in the following table:

UI Name Attribute Name and Type	Description
Type `type string`	Type of cluster.
Internal Identifier `id string`	Internal Identifier of cluster.
Internal Name `cluster_name string`	Internal Name of cluster
General Details
Key `key string`	Globally unique key.
Name `name string`	The primary name that the cluster is known by.
Short Name `short_name string`	Short name.
Description `description string`	Description of the cluster. Legacy attribute not currently used. Can be used by patterns if desired
URL `url string`	URL for information about the cluster. Legacy attribute not currently used. Can be used by patterns if desired
Business Continuity Critical `business_continuity_critical boolean`	If true, the cluster is critical to operation of the business. Legacy attribute not currently used. Can be used by patterns if desired
Supported by 3rd Party `third_party_support boolean`	If true, the cluster is supported by a third party. Legacy attribute not currently used. Can be used by patterns if desired.
Synonyms `synonyms list:string`	Other names by which this cluster is known. Legacy attribute not currently used. Can be used by patterns if desired.
Failover `failover boolean`	Whether the cluster supports failover between members.

Cluster node relationships

The relationships on a Cluster node are as described in the following table:

UI name	Relationship	Description
Member Hosts	`Cluster: HostContainer: HostContainment: ContainedHost: Host`	Logical hosts that are part of this logical cluster.
Member MFParts	`Cluster: HostContainer: HostContainment: ContainedHost: MFPart`	MFParts that are part of this Sysplex.
Member Coupling Facilities	`Cluster: HostContainer: HostContainment: CouplingFacility: CouplingFacility`	Coupling Facilities that are part of this Sysplex.
Service Software	`Cluster: Service: SoftwareService: ServiceProvider: SoftwareInstance`	Software instances that provide this logical cluster.
Dependant Software	`Cluster: DependedUpon: Dependency: Dependant: SoftwareInstance`	Software instances that depend upon this logical cluster.
Maintaining Pattern	`Cluster: Element: Maintainer: Pattern: Pattern`	Pattern that is maintaining this cluster.
Managing Software	`Cluster: ManagedElement: Management: Manager: SoftwareInstance`	Software instances that is managing this cluster.
Running Software	cluster: Host: HostedSoftware: RunningSoftware: SoftwareInstance	Software Instances running on this cluster
Members	Cluster: Container: Containment: Contained: ClusterMember	Members of this cluster
Managed Services	Cluster: ServiceHost: HostedService: RunningService: ClusterService	Services managed by this cluster
Not displayed in UI	`Cluster: AttachmentContainer: Attachment: Attachment: Attachment`	A file attached to this element.
Status	`Cluster: ElementInCategory: ElementCategory: Category: LifecycleStatus`	The lifecycle status of this element.
Recovery Time	`Cluster: ElementInCategory: ElementCategory: Category: RecoveryTime`	The recovery time specified for this element.
Family	`Cluster: ElementInCategory: ElementCategory: Category: Family`	Family of this element.
Organizational Unit	`Cluster: OwnedItem: Ownership: Owner: OrganisationalUnit`	The Organizational Unit that this element belongs to.
Location	`Cluster: ElementInLocation: Location: Location: Location`	Location of this element.
Support Manager	`Cluster: OwnedItem: Ownership: SupportOwner: Person`	The person responsible for the support of this element.
Business Owner	`Cluster: OwnedItem: Ownership: BusinessOwner: Person`	The person responsible for this element from a business perspective.
IT Owner	`Cluster: OwnedItem: Ownership: ITOwner: Person`	The person responsible for this element from an IT perspective.
Running Software	`Cluster: Host: HostedSoftware: RunningSoftware: SoftwareInstance`	Software Instances running on this cluster.
Members	`Cluster: Container: Containment: Contained: ClusterMember`	Members of this cluster.
Managed Services	`Cluster: ServiceHost: HostedService: RunningService: ClusterService`	Services managed by this cluster.
Service Software Cluster	`Cluster: Service: SoftwareService: ServiceProvider: SoftwareCluster`	Software Clusters that provide this logical cluster.
Dependant Software Clusters	`Cluster: DependedUpon: Dependency: Dependant: SoftwareCluster`	Software Clusters that depend upon this logical cluster.