LogicalPartition_RemoteRestart Job
Logical Partition remote restart Job is used to perform the remote restart operations on the logical partition. You can perform validate, recover, restart, cleanup, and cancel operations using this job.
Resource
/rest/api/uom/ManagedSystem/{ManagedSystem_UUID}/LogicalPartition/{LogicalPartition_UUID}/do/RemoteRestart
/rest/api/uom/LogicalPartition/{LogicalPartition_UUID}/do/RemoteRestart
Overview of LogicalPartition_RemoteRestart Job
On a PowerVM-partition-restart-capable Managed System, we can invoke this job on a PowerVM-partition-restart-capable LPAR to restart the partition on a destination Managed System.
Prior to invoking the restart operation, user can invoke the validate operation, to determine whether the restart operation is valid for the Logical Partition from source Managed System to the specified target Managed System.
Possible Job Parameters: Operation targetManagedSystemUUID targetManagedSystem Redundancy Verbose vlanbridge force usecurrdata retaindev targetRemoteHMCIPAddress targetRemoteHMCUserId sharedProcessorPoolName sharedProcessorPoolID virtualFCMappings noconnection
Request
The source managed system and target managed system UUID must be given. Other optional parameters can be specified based on the operation type.
Request param | Description |
---|---|
Operation | This is a mandatory parameter. Allowed values are validate, recover, restart, cleanup, and cancel. |
targetManagedSystemUUID | This attribute is optional if the targetManagementSystem parameter is mentioned or if the operation value parameter is set to cleanup. When both MTMS and UUID are specified together, they must represent the same target system. |
targetManagedSystem | This attribute is optional if the targetManagedSystemUUID parameter is mentioned or if the operation value parameter is set to cleanup. When both MTMS and UUID are specified together, they must represent the same target system. |
Redundancy | Allowed values are ALL or NONE. The Redundancy parameter is applied for RedundantVios and IO (mpio). ALL sets a value of 1 to both redundantvios and mpio and NONE sets a value of 0 to redundantvios and 2 to mpio. RedundantVios specifies whether the partition is to be configured to use redundant VIOS. The default value is 2, if the option is not specified. You can specify 0 to indicate No, 1 to indicate Yes, 2 to indicate If Possible. IO (mpio) - specifies whether the management console is required to maintain an equivalent multipath I/O configuration of the partition virtual SCSI and virtual fiber channel adapters. The default value is 1. The values are 1 indicating Yes, 2 indicating If Possible. |
Verbose | Allowed values are TRUE and
FALSE. The value True sets the verbose output true and
also the Detail level is set to 5. The value False sets the verbose output
false and the Detail level is set 0. Note: Detail level is the level of detail requested from
operating system commands issued by the HMC to all partitions participating in the remote restart
values range from 0 (none) to 5 (highest). Default value is 1, if the option is not
specified.
|
vlanbridge | Allowed values are 1 and 2. This parameter specifies whether each of the partition virtual Ethernet adapters is required to be configured so that it is bridged on the same VLAN to an external network . The default value is 1. The values are 1 indicating Yes, 2 indicating If Possible. |
force | This option allows you to force a clean up or recover to proceed when errors are encountered. or remote restart of suspended simplified remote restart partition operation. |
usecurrdata | This attribute is optional on the restart operation. Instructs the restart to proceed when the reserved storage device has stale data. |
retaindev | This attribute is optional on the cleanup operation. Instructs the cleanup operation to not remove the reserved storage device from the source servers reserved storage device pool. |
targetRemoteHMCIPAddress | This is a mandatory parameter, only for Cross-HMC-capable and Simplified-Remote-Restart capable partitions. Valid for the Validate, Restart, and Recover operations. |
targetRemoteHMCUserId | This parameter is applicable nly for Cross-HMC-capable and Simplified-Remote-Restart capable partitions. Valid for the Validate, Restart, and Recover operations. |
sharedProcessorPoolName | Allows the user to specify a shared processor pool on the target system by
unis the shared processor pool name. Valid for the Validate and
Restart operations. Note: You must specify the name of the shared processor pool
only if you are not specifying the ID of the shared processor pool.
|
sharedProcessorPoolID | Allows the user to specify a specific shared processor pool on the target
system by using shared processor pool ID. Valid for the Validate and
Restart operations. Note: You must specify the ID of the shared processor pool
only if you are not specifying the name of the shared processor pool.
|
virtualFCMappings | Allows the users to specify mappings for Virtual FC adapters on target system, such as target VIOS and target FC port. The mappings can be specified in the same format as in CLI. Valid for the Validate and Restart operations. |
noconnection | Allows the user to proceed with the remote restart operations when the source Managed system is in no connection state. Valid for the Validate and Restart operations. |
Response
This job would return the Job status like Complete_Ok, Failed_Before_Complete and so on.
Response param | Description |
---|---|
returnCode | This attribute contains the value of the return code from underlying CLI invoked |
result | The STDOUT out of underlying CLI invoked |
ErrorData | The STDERR of underlying CLI invoked |
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">RemoteRestart</OperationName>
<GroupName kb="ROR" kxe="false">LogicalPartition</GroupName>
</RequestedOperation>
<JobParameters kb="CUR" kxe="false" schemaVersion="V1_1_0">
<Metadata>
<Atom/>
</Metadata>
<JobParameter schemaVersion="V1_0">
<Metadata>
<Atom/>
</Metadata>
<ParameterName kb="ROR" kxe="false">targetManagedSystem</ParameterName>
<ParameterValue kxe="false" kb="CUR">HV4-221</ParameterValue>
</JobParameter>
<JobParameter schemaVersion="V1_0">
<Metadata>
<Atom/>
</Metadata>
<ParameterName kb="ROR" kxe="false">targetManagedSystemUUID</ParameterName>
<ParameterValue kxe="false" kb="CUR">b73f1565-0ae4-3070-8eac-58f35a81e898</ParameterValue>
</JobParameter>
<JobParameter schemaVersion="V1_0">
<Metadata>
<Atom/>
</Metadata>
<ParameterName kb="ROR" kxe="false">operation</ParameterName>
<ParameterValue kxe="false" kb="CUR">validate</ParameterValue>
</JobParameter>
</JobParameters>
</JobRequest:JobRequest>