MigrateRecover_LogicalPartition Job

With the MigrateRecover_LogicalPartition job, you can recover a logical partition that has been stuck in an intermediate state after failure of the preceding migrate operation.

Resource

/rest/api/uom/LogicalPartition/{LogicalPartition_UUID}/do/MigrateRecover
/rest/api/uom/ManagedSystem/{ManagedSystem_uuid}/LogicalPartition/{LogicalPartition_UUID}/do/MigrateRecover

Overview of MigrateRecover_LogicalPartition Job

On a migration-capable managed system, you can invoke this job on an LPAR that is stuck in one of the intermediate states of migration.

Request

Table 1. Request parameters
Request parameter Description
force Specified to force recover a logical partition that is stuck in one of the intermediate state of migration.
TargetRemoteHMCIPAddress Specifies the IP address of the target HMC where the logical partition is getting migrated.
TargetRemoteHMCUserID Specifies the userID of the target HMC where the logical partition is getting migrated.

Response

Table 2. Response parameters
Response parameter Description
returnCode Contains the return code value from the invoked command-line interface (CLI).
result When the job fails with errors, and when the job status is COMPLETED_WITH_ERROR, the error message is displayed in the result parameter in the response.

Sample request payload

Table 3. Supported methods for JSON
Method Content-type Type Accept
PUT application/ vnd.ibm.powervm.web +json JobRequest application/json

Sample job requests

JSON:
	{
  "JobRequest": {
    "RequestedOperation": {
      "OperationName": "MigrateRecover",
      "GroupName": "LogicalPartition"
    },
    "JobParameters": {
      "JobParameter": [
        {
          "ParameterName": "force",
          "ParameterValue": true
        }
      ]
    }
  }
}

Sample request payload

Table 4. Supported methods for XML
Method Content-type Type
PUT application/ vnd.ibm.powervm.web+xml JobRequest

Sample job requests

XML:
	<JobRequest
 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 kxe="false" kb="CUR" schemaVersion="V1_0">
  <Metadata>
   <Atom/>
  </Metadata>
  <OperationName kxe="false" kb="ROR">MigrateRecover</OperationName>
  <GroupName kxe="false" kb="ROR">LogicalPartition</GroupName>
 </RequestedOperation>
<JobParameters kb="CUR" kxe="false" schemaVersion="V1_0">
        <Metadata>
            <Atom/>
        </Metadata>
	  <JobParameter schemaVersion="V1_0">
           <Metadata>
               <Atom/>
           </Metadata>
           <ParameterName kxe="false" kb="ROR">force</ParameterName>
           <ParameterValue kxe="false" kb="CUR">true</ParameterValue>
      </JobParameter>
   </JobParameters>
</JobRequest>