Create_Cluster Job

The cluster create job is used to create a cluster with shared storage pool. The cluster and shared storage pool details are available in an XML format.

Resource

/rest/api/uom/Cluster/do/Create

Since: Version 1_1_0

Request

Because the cluster and shared storage pool coexists, a cluster cannot be created without a shared storage pool or vice versa. You must create both cluster and shared storage pool at same time.

Table 1. Request Parameters
Request parameter	Description
clusterXml	Cluster details containing node and repository disk information in an XML format.
sspXml	Shared storage pool details containing pool disk information in an XML format.

Response

This job returns valid Job status values such as Complete_Ok and Failed_Before_Complete.

Sample Job Request(s)

<JobRequest:JobRequest xmlns:JobRequest="http://www.ibm.com/xmlns/systems/power/firmware/web/mc/2012_10/" 
xmlns="http://www.ibm.com/xmlns/systems/power/firmware/web/mc/2012_10/" 
xmlns:ns2="http://www.w3.org/XML/1998/namespace/k2" schemaVersion="V1_0">
    <Metadata>
        <Atom/>
    </Metadata>
    <RequestedOperation kb="CUR" kxe="false" schemaVersion="V1_0">
        <Metadata>
            <Atom/>
        </Metadata>
        <OperationName kb="ROR" kxe="false">Create</OperationName>
        <GroupName kb="ROR" kxe="false">Cluster</GroupName>
    </RequestedOperation>
    <JobParameters kb="CUR" kxe="false" schemaVersion="V1_0">
        <Metadata>
            <Atom/>
        </Metadata>
	<JobParameter schemaVersion="V1_0">
            <Metadata>
                <Atom/>
            </Metadata>
            <ParameterName kb="ROR" kxe="false" >clusterXml</ParameterName>
<ParameterValue kxe="false" kb="CUR" ><![CDATA[<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Cluster:Cluster 
            xmlns:Cluster="http://www.ibm.com/xmlns/systems/power/firmware/uom/mc/2012_10/" 
            xmlns="http://www.ibm.com/xmlns/systems/power/firmware/uom/mc/2012_10/" 
            xmlns:ns2="http://www.w3.org/XML/1998/namespace/k2" schemaVersion="V1_0">
            <Metadata>
              <Atom/>                    
            </Metadata>
            <ClusterName kb="COR" kxe="false">testCluster</ClusterName>
            <RepositoryDisk kb="CUD" kxe="false" schemaVersion="V1_0">
                <Metadata>
                    <Atom/>
                </Metadata>
                <PhysicalVolume schemaVersion="V1_0">
                    <Metadata>
                        <Atom/>
                    </Metadata>
                    <Description kb="CUD" kxe="false">MPIO IBM 2076 FC Disk</Description>
<UniqueDeviceID kb="ROR" kxe="false">332136005076802808792F00000000000003804214503IBMfcp
</UniqueDeviceID>
                    <VolumeCapacity kb="CUR" kxe="false">20480</VolumeCapacity>
                    <VolumeName kb="CUR" kxe="false">hdisk8</VolumeName>
                    <VolumeState kb="ROR" kxe="false">active</VolumeState>
                    <IsFibreChannelBacked kxe="false" kb="ROR">true</IsFibreChannelBacked>
                </PhysicalVolume>
            </RepositoryDisk>
            <Node kb="CUD" kxe="false" schemaVersion="V1_0">
                <Metadata>
                    <Atom/>
                </Metadata>
                <Node schemaVersion="V1_0">
                    <Metadata>
                        <Atom/>
                    </Metadata>
                    <HostName kb="CUD" kxe="false">pfwsdmc77.in.ibm.com</HostName>
                    <PartitionID kb="CUD" kxe="false">1</PartitionID>
                    <MachineTypeModelAndSerialNumber kb="CUD" kxe="false" schemaVersion="V1_0">
                        <Metadata>
                            <Atom/>
                        </Metadata>
                        <MachineType kb="CUR" kxe="false">7895</MachineType>
                        <Model kb="CUR" kxe="false">22X</Model>
                        <SerialNumber kb="CUR" kxe="false">105A6DB</SerialNumber>
                    </MachineTypeModelAndSerialNumber>
                    <VirtualIOServerLevel kb="CUD" kxe="false">2.2.3.0</VirtualIOServerLevel>
                    <VirtualIOServer kb="CUD" kxe="false" 
href="https://9.124.63.53:12443/rest/api/uom/ManagedSystem/b957a114-1b0f-3d45-ac51-49c991a8ac58/
VirtualIOServer/0927928F-BBC2-4686-A391-DB73D6D9DA3B" 
rel="related"/>
                </Node>                
            </Node>
        </Cluster:Cluster>]]></ParameterValue>
        </JobParameter>
        <JobParameter schemaVersion="V1_0">
            <Metadata>
                <Atom/>
            </Metadata>
            <ParameterName kb="ROR" kxe="false" >sspXml</ParameterName>
            <ParameterValue kxe="false" kb="CUR" >
<![CDATA[<?xml version="1.0" encoding="UTF-8" standalone="yes"?><SharedStoragePool
 xmlns="http://www.ibm.com/xmlns/systems/power/firmware/uom/mc/2012_10/" 
xmlns:ns2="http://www.w3.org/XML/1998/namespace/k2" schemaVersion="V1_0"><Metadata><Atom/></Metadata>
<PhysicalVolumes kb="CUR" kxe="false" schemaVersion="V1_0">
                <Metadata>
                    <Atom/>
                </Metadata>
                <PhysicalVolume schemaVersion="V1_0">
                    <Metadata>
                        <Atom/>
                    </Metadata>
                    <Description kb="CUD" kxe="false">MPIO IBM 2076 FC Disk</Description>
<UniqueDeviceID kxe="false" kb="ROR">332136005076802808792F00000000000003704214503IBMfcp</UniqueDeviceID>
                    <VolumeCapacity kb="CUR" kxe="false">20480</VolumeCapacity>
                    <VolumeName kb="CUR" kxe="false">hdisk7</VolumeName>
                    <VolumeState kb="ROR" kxe="false">active</VolumeState>
                    <IsFibreChannelBacked kb="ROR" kxe="false">false</IsFibreChannelBacked>
                </PhysicalVolume>
            </PhysicalVolumes>
            <Capacity kxe="false" kb="CUR">19.88</Capacity>
            <FreeSpace kxe="false" kb="CUR">19.52</FreeSpace>
            <OverCommitSpace kb="CUR" kxe="false">0.000000</OverCommitSpace>
            <AlertThreshold kb="CUD" kxe="false">35%</AlertThreshold>
            <StoragePoolName kb="CUR" kxe="false">testSP</StoragePoolName></SharedStoragePool>]]
></ParameterValue>
        </JobParameter>
    </JobParameters>
</JobRequest:JobRequest>

Last updated: Fri, June 23, 2017