MigrateValidate_LogicalPartition Job

Operation to Validate the Migrate operation of a particular Logical Partition from one Managed System to another.

Resource

/rest/api/uom/LogicalPartition/{LogicalPartition_UUID}/do/MigrateValidate

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

Overview of MigrateValidate_LogicalPartition Job

On a Migration Capable ManagedSystem, we can invoke this job on an LPAR to validate if it can be migrated to the Target ManagedSystem in the manner scpecified.

Prior to invoking Migrate Job, user can invoke MigrateValidate Job, to determine whether the Migrate Job is valid for this LogicalPartition from Source Managed System to the specified Target ManagedSystem.

	Possible Job Parameters:		
	TargetManagedSystemName	
	TargetRemoteHMCIPAddress
	TargetRemoteHMCUserID
	DestinationLparID		
	TargetProfileName
	RedundantVIOS
	MultipathIOOverride
	VLANBridgeOverride
	VSIOverride
	ProtectStorage		
	VirtualFCMappings
	VirtualSCSIMappings		
	SourceMSPID
	SourceMSPIPaddr
	DestMSPID
	DestMSPIPaddr
	SharedProcPoolID
	PrimaryRSViosID
	DetailedLevel
	WaitTime
       RedundantVNICBkDev
       VirtualVNICMappings
       MultipleVirtualVNICMappings
       SourceMSPName
       DestMSPName
       SharedProcPoolName
       UuidOverride
       RequireRemoteRestartOverride
       UseCurrData
       OverrideVNICConfiguration
       NPIVValidation
       RequiresRedundantMSPs
       RedundantSourceMSPID
       RedundantSourceMSPIPaddr
       RedundantSourceMSPName
       RedundantDestMSPID
       RedundantDestMSPIPaddr
       RedundantDestMSPName 
       ResourceGroupName
       ResourceGroupID

Table 1. Response parameters
Response Parameter	Description
returnCode	Contains the return code value from the invoked Command-Line Interface (CLI).
result	Contains the error messages for the following conditions: If the Job has failed with an error and the job status is COMPLETED_WITH_ERROR, the error message will be displayed in the result parameter in response. If the Job has succeeded, but the result has some warnings message and the job status is COMPLETED_WITH_WARNINGS, the message will be displayed in result parameter in response.

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

Example 1

{
	"JobRequest": {
		"RequestedOperation": {
			"OperationName": "MigrateValidate",
			"GroupName": "LogicalPartition",
			"ProgressType": "DISCRETE"
		},
		"JobParameters": {
			"JobParameter": [
				{
					"ParameterName": "TargetManagedSystemName",
					"ParameterValue": "vrml12-fsp"
				}
			]
		}
	}
}

Example 2

{
	"JobRequest": {
		"RequestedOperation": {
			"OperationName": "MigrateValidate",
			"GroupName": "LogicalPartition",
			"ProgressType": "DISCRETE"
		},
		"JobParameters": {
			"JobParameter": [
				{
					"ParameterName": "TargetManagedSystemName",
					"ParameterValue": "firebird110"
				},
				{
					"ParameterName": "DestinationLparID",
					"ParameterValue": 20
				}
			]
		}
	}
}

Example 3

{
	"JobRequest": {
		"RequestedOperation": {
			"OperationName": "MigrateValidate",
			"GroupName": "LogicalPartition",
			"ProgressType": "DISCRETE"
		},
		"JobParameters": {
			"JobParameter": [
				{
					"ParameterName": "TargetManagedSystemName",
					"ParameterValue": "vrml12-fsp"
				},
				{
					"ParameterName": "TargetRemoteHMCIPAddress",
					"ParameterValue": "9.124.63.149"
				},
				{
					"ParameterName": "TargetRemoteHMCUserID",
					"ParameterValue": "hscroot"
				},
				{
					"ParameterName": "DestinationLparID",
					"ParameterValue": 20
				},
				{
					"ParameterName": "VirtualSCSIMappings",
					"ParameterValue": "1/vrml12-vios1//3"
				},
				{
					"ParameterName": "SourceMSPIPaddr",
					"ParameterValue": "9.3.46.29"
				},
				{
					"ParameterName": "DestMSPIPaddr",
					"ParameterValue": "9.3.46.39"
				}
			]
		}
	}
}

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

Example 1

<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">MigrateValidate</OperationName>
        <GroupName kxe="false" kb="ROR">LogicalPartition</GroupName>
        <ProgressType kxe="false" kb="ROR">DISCRETE</ProgressType>
    </RequestedOperation>
    <JobParameters kxe="false" kb="CUR" schemaVersion="V1_0">
        <Metadata>
            <Atom/>
        </Metadata>
        <JobParameter schemaVersion="V1_0">
            <Metadata>
                <Atom/>
            </Metadata>
            <ParameterName kxe="false" kb="ROR">TargetManagedSystemName</ParameterName>
            <ParameterValue kxe="false" kb="CUR">vrml12-fsp</ParameterValue>
        </JobParameter>
     </JobParameters>
     </JobRequest>

Example 2

<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">MigrateValidte</OperationName>
        <GroupName kxe="false" kb="ROR">LogicalPartition</GroupName>
        <ProgressType kxe="false" kb="ROR">DISCRETE</ProgressType>
    </RequestedOperation>
    <JobParameters kxe="false" kb="CUR" schemaVersion="V1_0">
        <Metadata>
            <Atom/>
        </Metadata>
        <JobParameter schemaVersion="V1_0">
            <Metadata>
                <Atom/>
            </Metadata>
            <ParameterName kxe="false" kb="ROR">TargetManagedSystemName</ParameterName>
            <ParameterValue kxe="false" kb="CUR">firebird110</ParameterValue>
        </JobParameter>
        <JobParameter schemaVersion="V1_0">
            <Metadata>
                <Atom/>
                </Metadata>
            <ParameterName kxe="false" kb="ROR">DestinationLparID</ParameterName>
            <ParameterValue kxe="false" kb="CUR">20</ParameterValue>
        </JobParameter>
      </JobParameters>
 </JobRequest>

Example 3

<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">MigrateValidate</OperationName>
        <GroupName kxe="false" kb="ROR">LogicalPartition</GroupName>
        <ProgressType kxe="false" kb="ROR">DISCRETE</ProgressType>
    </RequestedOperation>
    <JobParameters kxe="false" kb="CUR" schemaVersion="V1_0">
        <Metadata>
            <Atom/>
        </Metadata>
        <JobParameter schemaVersion="V1_0">
            <Metadata>
                <Atom/>
            </Metadata>
            <ParameterName kxe="false" kb="ROR">TargetManagedSystemName</ParameterName>
            <ParameterValue kxe="false" kb="CUR">vrml12-fsp</ParameterValue>
        </JobParameter>
        <JobParameter schemaVersion="V1_0">
            <Metadata>
                <Atom/>
            </Metadata>
            <ParameterName kxe="false" kb="ROR">TargetRemoteHMCIPAddress</ParameterName>
            <ParameterValue kxe="false" kb="CUR">9.124.63.149</ParameterValue>
        </JobParameter>
        <JobParameter schemaVersion="V1_0">
            <Metadata>
                <Atom/>
            </Metadata>
            <ParameterName kxe="false" kb="ROR">TargetRemoteHMCUserID</ParameterName>
            <ParameterValue kxe="false" kb="CUR">hscroot</ParameterValue>
        </JobParameter>
        <JobParameter schemaVersion="V1_0">
            <Metadata>
                <Atom/>
            </Metadata>
            <ParameterName kxe="false" kb="ROR">DestinationLparID</ParameterName>
            <ParameterValue kxe="false" kb="CUR">20</ParameterValue>
        </JobParameter>
        <JobParameter schemaVersion="V1_0">
            <Metadata>
                <Atom/>
            </Metadata>
            <ParameterName kxe="false" kb="ROR">VirtualSCSIMappings</ParameterName>
            <ParameterValue kxe="false" kb="CUR">1/vrml12-vios1//3</ParameterValue>
        </JobParameter>
        <JobParameter schemaVersion="V1_0">
            <Metadata>
                <Atom/>
            </Metadata>
            <ParameterName kxe="false" kb="ROR">SourceMSPIPaddr</ParameterName>
            <ParameterValue kxe="false" kb="CUR">9.3.46.29</ParameterValue>
        </JobParameter>
        <JobParameter schemaVersion="V1_0">
            <Metadata>
                <Atom/>
            </Metadata>
            <ParameterName kxe="false" kb="ROR">DestMSPIPaddr</ParameterName>
            <ParameterValue kxe="false" kb="CUR">9.3.46.39</ParameterValue>
        </JobParameter>
      </JobParameters>
    </JobRequest>