Cluster

A Cluster is a set of one or more networked Virtual I/O Server (VIOS) partitions, where each VIOS within the cluster has access to a common set of physical volumes.

Cluster provides a distributed storage repository for Power systems. The Cluster is formed by shared storage pool which is a collection of physical volumes that can be accessed by every VIOS that is a part of the Cluster. A VIOS that is a part of the Cluster is called as a Node in the Cluster. All Nodes in the Cluster can read, write, and access data on physical volumes that are part of the shared storage pool.

The cluster repository disk is used as the central repository for the cluster configuration data. The minimal size of the repository is dependent on the cluster configuration.

The cluster capabilities attribute specifies whether the cluster is Tier capable and Tier Mirror capable

The major attributes in the Cluster are :

ClusterName : User defined name for Cluster
ClusterID : VIOS generated ID for Cluster
RepositoryDisk : Physical volume used for book keeping
ClusterSharedStoragePool : Atom-link generated for associated Shared Storage Pool created for Cluster
Node : Collection of VIOS that are part of Cluster
ClusterCapabilities : Capabilities to show if Cluster is Tier & Tier Mirror Capable

Resource

/rest/api/uom/Cluster/{Cluster_uuid}

Table 1. Supported methods
Method	Description	Internet media type
GET	Fetch the cluster information from all managed VIOS.	`application/atom+xml, application/vnd.ibm.powervm.uom+xml; type=Cluster`
POST	Update the existing Cluster such as : Add Nodes to Cluster. Remove Nodes from Cluster. Replace Repository disk in the Cluster.	`application/atom+xml, application/vnd.ibm.powervm.uom+xml; type=Cluster`

Quick Properties

User can fetch the only specified property.

Resource

/rest/api/uom/Cluster/quick/All

Supported property names available at /rest/api/uom/Cluster/quick/All URI.

Table 2. List of Quick properties
Property Name	Description
ClusterName	User defined name for Cluster.
ClusterID	VIOS generated ID for Cluster.
UUID	UUID of Cluster.

Resource

/rest/api/uom/Cluster/{Cluster_uuid}/quick

Supported property names available at /rest/api/uom/Cluster/{Cluster_uuid}/quick URI.

Table 3. List of Quick properties
Property Name	Description
ClusterName	User defined name for Cluster.
ClusterID	VIOS generated ID for Cluster.

Resource

/rest/api/uom/Cluster/{Cluster_uuid}/quick/{Property Name}

Supported property names available at /rest/api/uom/Cluster/{Cluster_uuid}/quick/{Property Name} URI.

Table 4. List of Quick properties
Property Name	Description
ClusterName	User defined name for Cluster.
ClusterID	VIOS generated ID for Cluster.

Note :

The Cluster does not support PUT and DELETE operation, kindly use below Jobs to create and delete Cluster.

Replacing repository disk of the Cluster is also supported by Job

Cluster_Replace_Repository_Disk Job

Since: Version 1_1_0

Last updated: Fri, June 23, 2017