HMC Manual Reference Pages  - RRSTARTLPAR (1)

NAME

rrstartlpar - perform a partition remote restart operation

CONTENTS

Synopsis
Description
Options
Examples
Environment
Bugs
Author
See Also

SYNOPSIS

To perform a partition remote restart operation:
rrstartlpar -o {restart | validate | cancel | cleanup | recover}
-m managed-system [-t target-managed-system]
[--ip IP-address [-u user-ID]]
{-p partition-name | --id partition-ID}
[--redundantvios {0 | 1 | 2}] [--mpio {1 | 2}]
[--vlanbridge {1 | 2}]
[--redundantvnicbkdev {1 | 2}]
[--retaindev] [--usecurrdata]
[--noconnection]
[{-f input-data-file | -i "input-data"}]
[-w wait-time] [-d detail-level] [--force]
[-v] [--nodetails]
[--help]

To set management console attributes related to partition remote restart operations:
rrstartlpar -o set -r mc
{-f input-data-file | -i "input-data"}
[--help]

DESCRIPTION

rrstartlpar performs partition remote restart operations.

Remote restart operations can be performed for AIX, Linux, or IBM i partitions only.

A partition can be remotely restarted only when the source managed system is in the Power Off In Progress, Power Off, Error, Error - Dump in progress, Initializing, or No Connection state. The destination managed system must be in the Operating state.

OPTIONS

-o The operation to perform. Valid values are restart to validate then remotely restart the partition if validation succeeds, validate to validate the operation to remotely restart the partition, cancel to stop the remote restart of the partition, cleanup to clean up after the successful remote restart of the partition, recover to recover from the failed remote restart of the partition, and set to set attributes related to partition remote restart operations.

After the successful remote restart of a partition, you should perform a clean up operation on the source managed system once the source managed system is in Operating or Standby state.

-m The name of the source managed system for the partition remote restart operation. The name may either be the user-defined name for the managed system, or be in the form tttt-mmm*sssssss, where tttt is the machine type, mmm is the model, and sssssss is the serial number of the managed system. The tttt-mmm*sssssss form must be used if there are multiple managed systems with the same user-defined name.
-t The name of the target, or destination, managed system for the partition remote restart operation. The name may either be the user-defined name for the managed system, or be in the form tttt-mmm*sssssss, where tttt is the machine type, mmm is the model, and sssssss is the serial number of the managed system. The tttt-mmm*sssssss form must be used if there are multiple managed systems with the same user-defined name.

This option is required for all operations except a clean up operation.

--ip If the destination managed system is not managed by the same management console that is managing the source managed system, use this option to specify the IP address or host name of the management console that is managing the destination managed system.

SSH must be enabled on both management consoles. Also, you must run the mkauthkeys command once to set up SSH key authentication.

This option is valid only for partitions that support simplified remote restart operations. This option is required when remotely restarting partitions, validating partition remote restart operations, or recovering from a failed partition remote restart if the destination managed system is not managed by the same management console that is managing the source managed system. This option is not valid when performing any other operation.

-u If the destination managed system is not managed by the same management console that is managing the source managed system, use this option to specify the user ID to use on the management console that is managing the destination managed system. If you do not specify the user ID, then the user ID of the user that issues this command will be used.
-p The name of the partition for which to perform the remote restart operation.

You must either use this option to specify the name of the partition, or use the --id option to specify the partition’s ID. This option must be used when performing a cancel or recover operation.

The -p and the --id options are mutually exclusive.

--id The ID of the partition for which to perform the remote restart operation.

You must either use this option to specify the ID of the partition, or use the -p option to specify the partition’s name. The -p option must be used when performing a cancel or recover operation.

The --id and the -p options are mutually exclusive.

--redundantvios When validating or performing the remote restart of a partition using a reserved storage device or a partition that uses shared memory, use this option to specify whether the partition is to be configured to use redundant VIOS partitions on the destination managed system for accessing the reserved storage device or the paging device assigned to the partition.

Valid values are 0 if the partition is to be configured to not use redundant VIOS partitions, 1 if the partition is to be configured to use redundant VIOS partitions, or 2 if the partition is to be configured to use redundant VIOS partitions if possible. If this option is not specified, then the partition will be configured to use the same VIOS redundancy configuration on the destination managed system that the partition is currently using on the source managed system.

This option is only valid when performing a validate or remote restart operation.

--mpio When validating or remotely restarting a partition, use this option to specify whether the management console is required to maintain an equivalent multipath I/O (MPIO) configuration of each of the partition’s virtual SCSI and virtual fibre channel adapters on the destination managed system. Valid values are 1 if the management console is required to maintain an equivalent MPIO configuration, or 2 if the management console is not required to maintain an equivalent MPIO configuration, but should do so if possible. If this option is not specified, then this option defaults to the value 1.

If this option has a value of 1 and the management console cannot guarantee that an equivalent MPIO configuration of all of the partition’s virtual SCSI and virtual fibre channel adapters can be maintained on the destination managed system, then an error will occur and the operation will fail.

This option is only valid when performing a validate or remote restart operation.

--vlanbridge When validating or remotely restarting a partition, use this option to specify whether each of the partition’s virtual ethernet adapters are required to be configured so that they are bridged on the same VLAN to an external network on the destination managed system. Valid values are 1 if virtual ethernet adapters are required to be bridged, or 2 if virtual ethernet adapters are not required to be bridged, but should be bridged if possible. If this option is not specified, then this option defaults to the value 1.

If this option has a value of 1 and the management console cannot guarantee that the partition’s virtual ethernet adapters can be bridged, then an error will occur and the operation will fail.

This option is only valid when performing a validate or remote restart operation.

--redundantvnicbkdev When validating or remotely restarting a partition, use this option to specify whether the management console is required to maintain the backing device redundancy of each of the partition’s virtual NICs on the destination managed system. Valid values are 1 if the management console is required to maintain the virtual NIC backing device redundancy, or 2 if the management console is not required to maintain the virtual NIC backing device redundancy, but should do so if possible. If this option is not specified, then this option defaults to the value 1.

If this option has a value of 1, the management console must be able to map every virtual NIC backing device to a virtual NIC backing device on the destination managed system. In addition, the management console must be able to maintain the VIOS redundancy the backing devices for a virtual NIC provide. For example, if two backing devices for a virtual NIC are hosted by two different VIOSs on the source managed system, then the backing devices for that virtual NIC must be hosted by two different VIOSs on the destination managed system. If the management console is not able to do this for all of the partition’s virtual NICs, an error will occur and the operation will fail.

This option is only valid when performing a validate or remote restart operation.

--usecurrdata Specify this option to allow a partition to be remotely restarted when the partition configuration data saved in the remote restart data for the partition does not match the current configuration of the partition. The partition will be remotely restarted with the saved configuration data.

This option is only valid when performing a remote restart operation.

--retaindev When performing a clean up operation after a successful remote restart of a partition using a reserved storage device, specify this option to prevent the reserved storage device assigned to the partition from being removed from the reserved storage device pool on the source managed system.

This option is only valid when performing a clean up operation.

--noconnection Specify this option to allow a partition to be remotely restarted when the source managed system is in the No Connection state.

This option is only valid when performing a validate or simplified remote restart operation.

-f The name of the file containing the input data for this command. The input data consists of attribute name/value pairs, which are in comma separated value (CSV) format.

The format of the input data is as follows:

attribute-name=value,attribute-name=value,...

Note that certain attributes accept a comma separated list of values, as follows:

"attribute-name=value,value,..." ,...

When a list of values is specified, the attribute name/value pair must be enclosed in double quotes. Depending on the shell being used, nested double quote characters may need to be preceded by an escape character, which is usually a ’#146; character.

Attributes that can be specified when validating or remotely restarting a partition:
virtual_fc_mappings
Comma separated list of virtual fibre channel adapter
mappings, with each mapping having the following
format:

virtual-slot-number/vios-lpar-name/vios-lpar-ID/
[vios-virtual-slot-number]/[vios-fc-port-name]

All four ’/’ characters must be present. Optional
values may be omitted. Optional values are
vios-lpar-name or vios-lpar-ID (one of those
values is required, but not both), vios-virtual-slot-
number
, and vios-fc-port-name.

For example:
4//1/14/fcs0 specifies a mapping of the virtual fibre
channel client adapter with slot number 4 to the
virtual fibre channel server adapter with slot number
14 in the VIOS partition with ID 1 on the
destination managed system. In addition, the mapping
specifies to use physical fibre channel port fcs0.
virtual_scsi_mappings
Comma separated list of virtual SCSI adapter mappings,
with each mapping having the following format:

virtual-slot-number/vios-lpar-name/vios-lpar-ID/
[vios-virtual-slot-number]

All 3 ’/’ characters must be present. Optional
values may be omitted. Optional values are
vios-lpar-name or vios-lpar-ID (one of those values
is required, but not both), and
vios-virtual-slot-number.

For example:
12/vios1//16 specifies a mapping of the virtual SCSI
client adapter with slot number 12 to the virtual SCSI
server adapter with slot number 16 in the VIOS
partition vios1 on the destination managed system.
vnic_mappings
Comma separated list of virtual NIC mappings, with
each mapping having the following format:

virtual-slot-number/ded/[vios-lpar-name]/
[vios-lpar-ID]/[sriov-adapter-ID]/
[sriov-physical-port-ID]/[capacity][/
[source-sriov-adapter-ID]/
[source-sriov-physical-port-ID]]

The first 6 ’/’ characters must be present. The
last 2 ’/’ characters are optional, but both
must be present if source-sriov-adapter-ID and
source-sriov-physical-port-ID are specified.

Optional values may be omitted. Optional values are
vios-lpar-name or vios-lpar-ID (one of those values
is required, but not both), sriov-adapter-ID and
sriov-physical-port-ID (if one of those values is
specified they both must be specified), and capacity.
In addition, if the virtual NIC has only one backing
device, source-sriov-adapter-ID and
source-sriov-physical-port-ID are also optional.

For example:
5/ded/vios1//1/2/4.5/1/0 specifies a mapping of the
backing device on physical port 0 of SR-IOV adapter
1 for the virtual NIC in slot number 5 to a
virtual NIC on the destination managed system with a
backing device hosted by VIOS partition vios1. In
addition, the mapping specifies to use physical port
2 of SR-IOV adapter 1 and a logical port capacity
of 4.5% for the backing device.
shared_proc_pool_name | shared_proc_pool_id

Attributes that can be specified for a set operation:
auto_cleanup_enabled
Automatic clean up of remotely restarted partitions
can be performed on the source managed system once the
source managed system is in Operating state and all of
the VIOS partitions that were hosting client virtual
SCSI and virtual fibre channel adapters for the
remotely restarted partitions are running with RMC
connections to the HMC.
Valid values are:
0 - this HMC is not to perform automatic clean up
1 - this HMC is to perform automatic clean up
(default)

Input data for this command can be specified with this option or the -i option. The -f and the -i options are mutually exclusive.

Input data can be specified when remotely restarting partitions, validating partition remote restart operations, or performing a set operation. This option is not valid when performing any other operation.

-i This option allows you to enter input data on the command line, instead of using a file. Data entered on the command line must follow the same format as data in a file, and must be enclosed in double quotes.

Input data for this command can be specified with this option or the -f option. The -i and the -f options are mutually exclusive.

Input data can be specified when remotely restarting partitions, validating partition remote restart operations, or performing a set operation. This option is not valid when performing any other operation.

-r The type of resource for which to set attributes related to partition remote restart operations. Valid values are mc for management console.
-w The maximum time, in minutes, to wait for operating system commands issued by the management console to the partition being remotely restarted to complete. If an operating system command does not complete within the time specified, the partition remote restart operation will be stopped.

wait-time must be a whole number. If wait-time is 0, the partition remote restart operation will not be timed out.

If this option is not specified, a default value of 3 minutes is used.

This option is only valid when performing a validate or remote restart operation.

-d The level of detail requested from operating system commands issued by the management console to all partitions participating in the remote restart operation. Valid values are 1 (lowest) through 5 (highest).

If this option is not specified, a default value of 1 is used.

This option is only valid when performing a validate or remote restart operation.

--force When performing a clean up or recover operation, specify this option to force the operation to proceed when errors are encountered.

When performing a simplified remote restart operation for a suspended partition, you must specify this option. A suspended partition will be restarted (resumed) on the destination managed system therefore it will not remain suspended.

-v Specify this option to enable verbose mode for the partition remote restart operation. When verbose mode is enabled, detail messages and warning messages are displayed for a successful partition remote restart operation. Detail messages and warning messages are displayed for partition remote restart operation that fails, regardless of whether this option is specified.

When the --nodetails option is also specified, no detail messages are displayed.

--nodetails Specify this option to suppress the display of all detail messages.
--help Display the help text for this command and exit.

EXAMPLES

Validate the operation to remotely restart partition mylpar from managed system system1 on managed system system2:

rrstartlpar -o validate -m system1 -t system2 -p mylpar

Remotely restart the partition with ID 5 from managed system system1 on managed system system2:

rrstartlpar -o restart -m system1 -t system2 --id 5

Remotely restart the partition lp1 from managed system system1 on managed system system2:

rrstartlpar -o restart -m system1 -t system2 -p lp1
-i ""virtual_fc_mappings=4/vios1//14/fcs0,5/vios2//14/fcs1""

Remotely restart the partition lp1 from managed system system1 on managed system system2 when system1 is in No Connection state:

rrstartlpar -o restart -m system1 -t system2 -p lp1 --noconnection

Clean up on the source managed system after the successful remote restart of the partition with ID 5:

rrstartlpar -o cleanup -m system1 --id 5

Stop the remote restart of partition mylpar:

rrstartlpar -o cancel -m system1 -t system2 -p mylpar

Recover the failed remote restart of partition mylpar:

rrstartlpar -o recover -m system1 -t system2 -p mylpar

Remotely restart the partition aix1 from managed system system1 to managed system system2, when system2 is managed by the HMC with the host name hmc2:

mkauthkeys --ip hmc2 -u hmc2user

rrstartlpar -o restart -m system1 -t system2 -p aix1 --ip hmc2
-u hmc2user

Disable automatic clean up for this HMC:

rrstartlpar -o set -r mc -i "auto_cleanup_enabled=0"

ENVIRONMENT

None

BUGS

None

AUTHOR

IBM Austin

SEE ALSO

lsrrstartlpar, lssyscfg, mkauthkeys


Linux RRSTARTLPAR (1) "November 2016"
Generated by manServer 1.07 from rrstartlpar.1 using man macros.