ManagePhysicalVolume_Cluster Job

The ManagePhysicalVolume_Cluster job allows you to add, remove, or replace the physical volumes that are associated to the failure group of the specified tier.

Resource

/rest/api/uom/Cluster/{Cluster_UUID}/do/ManagePhysicalVolume

Since: Version 1_3_0

Request

The job request must contain either of TIER_UDID parameter or the TIER_UUID parameter, and the FAILURE_GROUP_UDID parameter is mandatory. If the PhysicalVolumeCollection parameter is located in the PVS_TO_BE_ADDED parameter, then those physical volumes are added to the specified failure group. If the PhysicalVolumeCollection parameter is specified under PVS_TO_BE_REMOVED parameter, then those physical volumes are removed from the specified failure group. If both PVS_TO_BE_ADDED parameter and the PVS_TO_BE_REMOVED parameter are specified, then the physical volumes are replaced in the specified failure group.

Table 1. Request parameters
Request parameter	Description
TIER_UDID	The value of tier UDID.
FAILURE_GROUP_UDID	The value of failure group UDID.
PVS_TO_BE_ADDED	List of physical volumes that must be added.
PVS_TO_BE_REMOVED	List of physical volumes that must be removed.

Response

This job returns the valid job status 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_3_0">

    <Metadata>

        <Atom/>

    </Metadata>

    <RequestedOperation kb="CUR" kxe="false" schemaVersion="V1_3_0">

        <Metadata>

            <Atom/>

        </Metadata>

        <OperationName kb="ROR" kxe="false">GetFreePhysicalVolumes</OperationName>

        <GroupName kb="ROR" kxe="false">VirtualIOServer</GroupName>

    </RequestedOperation>

    <JobParameters kxe="false" kb="CUR" schemaVersion="V1_3_0">

        <Metadata>

            <Atom/>

        </Metadata> 

        <JobParameter schemaVersion="V1_3_0">

		    <Metadata>

		        <Atom/>

		    </Metadata>

		    <ParameterName kb="ROR" kxe="false">TIER_UDID</ParameterName>

<ParameterValue kxe="false" kb="CUR">256f140d7631f411e59866e41f139ec

750b3720f5ee4867db8</ParameterValue>

		</JobParameter>

		<JobParameter schemaVersion="V1_3_0">

		    <Metadata>

		        <Atom/>

		    </Metadata>

		    <ParameterName kb="ROR" kxe="false">TIER_UUID</ParameterName>

<ParameterValue kxe="false" kb="CUR">94a23340-ec8d-3f7b-8e7e-9d9feb046d23</ParameterValue>

		</JobParameter>

		<JobParameter schemaVersion="V1_3_0">

		    <Metadata>

		        <Atom/>

		    </Metadata>

		   <ParameterName kb="ROR" kxe="false">FAILURE_GROUP_UDID</ParameterName>

<ParameterValue kxe="false" kb="CUR">266f140d7631f411e59866e41f139ec75032686d962ce51c29

</ParameterValue>

		</JobParameter>

		<JobParameter schemaVersion="V1_3_0">

		    <Metadata>

		        <Atom/>

		    </Metadata>

		    <ParameterName kb="ROR" kxe="false">PVS_TO_BE_ADDED</ParameterName>

<ParameterValue kxe="false" kb="CUR"><![CDATA[<PhysicalVolume_Collection schemaVersion="V1_3_0">

			   <PhysicalVolume schemaVersion="V1_3_0">

                                <Metadata>

                                    <Atom/>

                                </Metadata>

                          <Description kb="CUD" kxe="false">MPIO DS5100/5300 Disk</Description>

<UniqueDeviceID kb="ROR" kxe="false">01M0lCTTE4MTggICAgICBGQVN0VDYwMEEwQjgwMDA

2RTE5OTIwMDAwMzIxNzUxMkI3NTY3</UniqueDeviceID>

                                <VolumeCapacity kb="CUR" kxe="false">51200</VolumeCapacity>

                                <VolumeName kb="CUR" kxe="false">hdisk10</VolumeName>

                                <VolumeState kb="ROR" kxe="false">active</VolumeState>

                         <IsFibreChannelBacked kxe="false" kb="ROR">true</IsFibreChannelBacked>

<StorageLabel ksv="V1_3_0" kb="ROR" kxe="false">cGFnaW5nX2Rpc2tfNTBfMTI=</StorageLabel>

                           </PhysicalVolume>

			   <PhysicalVolume schemaVersion="V1_3_0">

                                <Metadata>

                                    <Atom/>

                                </Metadata>

                     <Description kb="CUD" kxe="false">MPIO DS5100/5300 Disk</Description>

<UniqueDeviceID kb="ROR" kxe="false">01M0lCTTE4MTggICAgICBGQVN0VDYwMEEwQjgwMDA

2RTE5OTIwMDAwMzIxNzUxMkI3NTY4</UniqueDeviceID>

                                <VolumeCapacity kb="CUR" kxe="false">51200</VolumeCapacity>

                                <VolumeName kb="CUR" kxe="false">hdisk11</VolumeName>

                                <VolumeState kb="ROR" kxe="false">active</VolumeState>

                           <IsFibreChannelBacked kxe="false" kb="ROR">true</IsFibreChannelBacked>

           <StorageLabel ksv="V1_3_0" kb="ROR" kxe="false">cGFnaW5nX2Rpc2tfNTBfMTI=</StorageLabel>

                            </PhysicalVolume>

			   </PhysicalVolume_Collection>]]

></ParameterValue>

		</JobParameter>

		<JobParameter schemaVersion="V1_3_0">

		    <Metadata>

		        <Atom/>

		    </Metadata>

		    <ParameterName kb="ROR" kxe="false">PVS_TO_BE_REMOVED</ParameterName>

<ParameterValue kxe="false" kb="CUR"><![CDATA[<PhysicalVolume_Collection schemaVersion="V1_3_0">

			   <PhysicalVolume schemaVersion="V1_3_0">

                                <Metadata>

                                    <Atom/>

                                </Metadata>

                          <Description kb="CUD" kxe="false">MPIO DS5100/5300 Disk</Description>

<UniqueDeviceID kb="ROR" kxe="false">01M0lCTTE4MTggICAgICBGQVN0VDYwMEEwQjgwMDA

2RTE5OTIwMDAwMzIxNzUxMkI3NTY5</UniqueDeviceID>

                                <VolumeCapacity kb="CUR" kxe="false">51200</VolumeCapacity>

                                <VolumeName kb="CUR" kxe="false">hdisk12</VolumeName>

                                <VolumeState kb="ROR" kxe="false">active</VolumeState>

                                <IsFibreChannelBacked kxe="false" kb="ROR">true</IsFibreChannelBacked>

               <StorageLabel ksv="V1_3_0" kb="ROR" kxe="false">cGFnaW5nX2Rpc2tfNTBfMTI=</StorageLabel>

                           </PhysicalVolume>

			   <PhysicalVolume schemaVersion="V1_3_0">

                                <Metadata>

                                    <Atom/>

                                </Metadata>

                                <Description kb="CUD" kxe="false">MPIO DS5100/5300 Disk</Description>

<UniqueDeviceID kb="ROR" kxe="false">01M0lCTTE4MTggICAgICBGQVN0VDYwMEEwQjgwMDA

2RTE5OTIwMDAwMzIxNzUxMkI3NTY6</UniqueDeviceID>

                                <VolumeCapacity kb="CUR" kxe="false">51200</VolumeCapacity>

                                <VolumeName kb="CUR" kxe="false">hdisk13</VolumeName>

                                <VolumeState kb="ROR" kxe="false">active</VolumeState>

                                <IsFibreChannelBacked kxe="false" kb="ROR">true</IsFibreChannelBacked>

                <StorageLabel ksv="V1_3_0" kb="ROR" kxe="false">cGFnaW5nX2Rpc2tfNTBfMTI=</StorageLabel>

                            </PhysicalVolume>

			   </PhysicalVolume_Collection>]]></ParameterValue>

		</JobParameter>

    </JobParameters>

</JobRequest:JobRequest>

Last updated: Fri, June 23, 2017