ValidateMaintenanceReadiness_VirtualIOServer Job

The ValidateMaintenanceReadiness job validates the readiness of the Virtual I/O Server (VIOS) for maintenance and provides response on the impacted partition that does not have storage or network redundancy that is provided by the VIOS.

Resource

/rest/api/uom/VirtualIOServer/{VirtualIOServer_UUID}/do/ValidateMaintenanceReadiness

Request

None

Response

Table 1. Response Parameters
Response parameter Description
result A JSON object that contains the information about the various resource redundancy validation failures.
{"virtualSCSIErrors":
	{"impactedPartitionData":[{
		"name":Partition Name,
		"id":Partition ID,
		"uuid":Partition UUID,
		"state":Partition State,
		"virtualSCSIStorages":[{
			"storageName":Disk Name,
			"storageType":Type Of Storage, can be Logical Volume, Logical Unit, Physical Volume and Virtual Optical Media,
			"errorCode":Error Code,
			"message":Error/Warning message}]
		}]
	},
"virtualLANErrors":
	{"impactedPartitionData":[{
		"name":Partition Name,
		"id":Partition ID,
		"uuid":Partition UUID,
		"state":Partition State,
		"virtualLANs":[{
			"vLAN":Vlan ID,
			"vSwitch":Associated VSwitch Name,
			"vNetwork":Virtual Network Name,
			"errorCode":Error Code,
			"message":Error Message}]
		}]
	},

"virtualNICErrors":{
	"impactedPartitionData": [{
		"name":Partition Name,
		"id":Partition ID,
		"uuid":Partition UUID,
		"state":Partition State,
		"virtualNICs": [{
			"virtualSlotNumber": Virtual NIC Slot number,
			"dynamicReconfigurationConnectorName": VNIC Drc Name,
			"errorCode": Error Code,
			"message": Error/Warning message}]
		}]
	},

"virtualFCErrors":{
	"impactedPartitionData": [{
		"name":Partition Name,
		"id":Partition ID,
		"uuid":Partition UUID,
		"state":Partition State,
		"virtualFCs": [{
			"vFCHost": VHost Name,
			"errorCode": Error Code,
			"message": Error/Warning message}]
		}]
	},

"viosInfo":[{
	"name":Partition Name,
	"id":Partition ID,
	"uuid":Partition UUID,
	"state":Partition State,
	"rmcState":RMC State of the VIOS,
	"message":Error message if there are any while collecting VIOS inventory.
	}]
}

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_1_0">
    <Metadata>
        <Atom/>
    </Metadata>
    <RequestedOperation kb="CUR" kxe="false" schemaVersion="V1_1_0">
        <Metadata>
            <Atom/>
        </Metadata>
        <OperationName kb="ROR" kxe="false">ValidateMaintenanceReadiness</OperationName>
        <GroupName kb="ROR" kxe="false">VirtualIOServer</GroupName>
    </RequestedOperation>
    <JobParameters kb="CUR" kxe="false" schemaVersion="V1_1_0">
        <Metadata>
            <Atom/>
        </Metadata>
    </JobParameters>
</JobRequest:JobRequest>