IVM migrlpar command

Purpose

Moves active or inactive logical partitions from one physical system to another physical system. This command is operable only in an Integrated Virtualization Manager environment.

Syntax

To validate a migration

migrlpar [-o v -m <managed system> -t <managed system> --ip <target HMC/IVM IP address> [-u <target HMC/IVM user name>]] -p <partition name> |--id <partition ID>[-n <profile name>] [-f <input data file> | -i "<input data>"] [-w <wait time>] [-d <detail level>]

To migrate a logical partition

migrlpar [-o m -m <managed system> -t <managed system> --ip <target HMC/IVM IP address> [-u <target HMC/IVM user name>]] -p <partition name> |--id <partition ID>[-n <profile name>] [-f <input data file> | -i "<input data>"] [-w <wait time>] [-d <detail level>] [--async] [-v] | [ -redundantpgvios { 0 | 1 | 2 }]

To stop a migration

migrlpar [-o s -m <managed system> {-p <partition name> |--id <partition ID> } [--help]

To recover from a failed partition migration

migrlpar [-o r -m <managed system> [--ip <target HMC/IVM IP address>] [-u <target HMC/IVM user name>] ] {-p <partition name> |--id <partition ID> }[--force] [--help]

Description

The migrlpar command validates, starts, stops, and recovers a partition migration. The Integrated Virtualization Manager determines which type of migration to perform based on the state of the partition referenced in the command.

Flags

Flag name	Description
-o	The partition migration operation. Possible values: s - stops a partition migration m - validates and migrates a partition if the validation succeeds r - recover from a failed partition migration v - validates a partition migration
-m managed system	The name of the source managed system for the partition migration operation. The name may be the user-defined name for the managed system, or may be in the form tttt-mmmssssssss, where tttt* is the machine type, mmm is the model, and ssssssss is the serial number of the managed system.
-t managed system	The name of the target system for the partition migration operation. The name may be the user-defined name for the managed system, or may be in the form ttttmmm ssssssss, where tttt* is the machine type, mmm is the model, and ssssssss is the serial number of the managed system. The -t flag is required when using the -o m or -o v flags.
--ip target HMC/IVM IP address	The IP address or hostname of the target system managing the Hardware Management Consoleor Integrated Virtualization Manager.
-u target HMC/IVM user name	The user name to use on the Integrated Virtualization Manager that manages the target system or the HMC. If --ip flag is specified and -u flag is not specified, the user name on the source HMC or Integrated Virtualization Manager is used on the target HMC or Integrated Virtualization Manager.
-p partition name	The name of the partition on which to perform the migration. For validating partitions, multiple partition names that are separated by a comma can be provided.
--id partition ID	The ID of the partition on which to perform the migration.
-n profile name	The name of the partition profile to be created for the migrated partition on the destination managed system. If this option is omitted when migrating a partition, then the last activated profile for the partition will be replaced with the current partition configuration on the destination managed system. This option is only valid when migrating a partition or validating a partition migration. Note: This option is only valid if you are migrating to a system managed by the HMC. If you are migrating to a system managed by the Integrated Virtualization Manager, the option is not used.
-f input data file	The name of the file containing the input data for the migrlpar command. The data given in the file specified with the -f flag, or the data specified with -i, must be in comma-separated (CSV) format. These switches can be used with the migrate (-o m) and the validate (-o v) operations. The following attributes are supported: `virtual_scsi_mappings, virtual_fc_mappings,source_msp_name, source_msp_ipaddr, source_msp_id, dest_msp_name, dest_msp_ipaddr, dest_msp_id, shared_proc_pool_id, shared_proc_pool_name, paging_device primary_paging_vios_id primary_paging_vios_name` The data specified with the virtual_scsi_mappings or virtual_fc_mappings attribute consists of one or more source virtual SCSI or virtual fibre channel adapters to destination Virtual I/O Server logical partitions in the following format: `client_virtual_slot_num/dest_vios_lpar_name/ dest_vios_lpar_id` Attribute names dest_msp_id Specifies the partition ID to use on the destination managed system. dest_msp_ipaddr Specifies the IP address of the mover service partition of the destination managed system. Note: This value is verified by comparing it with the output of the lstcpip -interfaces command. dest_msp_name Specifies the mover service partition name of the destination managed system.
	paging_device The paging space device to use if a memory pool is used. A paging device is a block storage device that has been added to the memory pool and is not designated as a paging device for any other logical partition. If the paging_device value is a blank string, there is no paging device currently assigned. primary_paging_vios_id The ID of the primary paging Virtual I/O Server (VIOS) partition that provides access to the paging space devices for the shared memory partitions. A paging VIOS partition is a VIOS logical partition that is assigned to the shared memory pool. primary_paging_vios_name The name of the primary paging VIOS partition that provides access to the paging space devices for the shared memory partitions. A paging VIOS partition is a VIOS logical partition that is assigned to the shared memory pool.
	shared_proc_pool_id The unique decimal identifier for a shared processing pool in which this logical partition should be on the target system. The default ID is zero. If Integrated Virtualization Manager is the destination managed system, the ID must equal 0. shared_proc_pool_name Specifies the name of the shared processor pool in which this partition should be on the target system. This attribute is only valid for logical partitions using shared processors. The default value is `DefaultPool`.
	source_msp_id Specifies the partition ID to use on the source managed system. On IVM, this ID must equal the ID of the Virtual I/O Server. source_msp_ipaddr Specifies the IP address of the mover service partition of the source managed system. Note: This value is verified by comparing it with the output of the lstcpip -interfaces command. source_msp_name Specifies the mover service partition name of the source managed system. On IVM, this name must equal the name of the Virtual I/O Server logical partition.
	virtual_fc_mappings Comma-separated list of virtual fibre channel adapters. Each item in this list has the format slot_num/vios_lpar_name/vios_lpar_id. For example, 4/vios2/3 specifies a virtual fibre channel adapter on a client logical partition with a virtual slot number of 4, a VIOS partition name of vios2, and the ID of the destination VIOS logical partition of 3. virtual_scsi_mappings Comma-separated list of virtual SCSI adapters. Each item in this list has the format slot_num/vios_lpar_name/vios_lpar_id. For example, 2/vios/1 specifies a client virtual SCSI adapter with a virtual slot number of 2, a VIOS partition name of vios, and the ID of the destination VIOS logical partition of 1.
-i input data	The input data for the migrlpar command. The format of the filter data is attr_name1=value,attr_name2=value,... or attr_name1=value1,value2,... ,...
-w wait time	The maximum time, in minutes, to wait for the operating system commands issued by the HMC or Integrated Virtualization Manager to the partition to be migrated to complete.
-d detail level	The level of detail requested from the operating system commands issued by the HMC or Integrated Virtualization Manager to all partitions participating in the migration. Values range from 0 (none) to 5 (highest).
--async	The command returns after the validation is completed. This flag does not wait for the migration to complete. This is only valid with the -o m flag.
-v	Enables verbose mode for the partition migration operation. When verbose mode is enabled, detail messages and warning messages are displayed for a successful partition migration. Detail messages and warning messages are always displayed for a partition migration that fails, regardless of whether this option is specified.
--force	Forces a recover operation to proceed when errors are encountered. This option is only valid when recovering from a failed partition migration and can be initiated from either the source VIOS logical partition or the destination managed system. If the operation is initiated from the destination managed system, only the destination managed system is recovered.
reduntantpgvios {0 \| 1 \| 2}	Specifies whether to configure the partition for redundancy on the target managed system. Possible values follow: 0 Do not configure the partition for redundancy on the target managed system. 1 Configure the partition for redundancy on the target managed system. 2 Configure the partition for redundancy if possible on the target managed system. If redundancy is not possible, configure as non-redundant. If you do not specify the parameter, the current redundancy level of the migrating partition is used.
--help	Displays the help text for this command and exit.

Exit Status

This command has a return code of 0 on success.

Examples

To validate a partition migration, type the following command:

migrlpar -o v -m migfspL1 --ip migivm2 -t migfspL2 --id 5 -i "shared_proc_pool_name=ProcPoolA"

To perform a partition migration, type the following command:

migrlpar -o m -m migfspL1 --ip migivm2 -t migfspL2 --id 5 -i "source_msp_id=1, 
source_msp_ipaddr=9.3.252.192,dest_msp_id=1,dest_msp_ipaddr=9.3.126.77"

To perform a partition migration for logical partitions that use virtual fibre channel adapters, type the following command:
```
migrlpar -o m -m migfspL1 --ip migivm2 -t migfspL2 --id 5 
-i "virtual_fc_mappings=5/VIOS/1,6/VIOS3/3"
```
To stop a partition migration, type the following command:
```
migrlpar -o s -m migfspL1 --id 5     
```
To recover from a failed partition migration, type the following command:
```
migrlpar -o r -m migfspL1 --id 5         
```

Last updated: Wed, November 18, 2020