HMC Manual Reference Pages - LSLPARMIGR (1)

NAME

lslparmigr - list partition migration information

Synopsis
Description
Options
Examples
Environment
Bugs
Author
See Also

SYNOPSIS

lslparmigr -r {lpar | mc | mem | mempool | msp | procpool | sys |
virtualio}
[-m managed-system]
[-t target-managed-system [--ip IP-address [-u user-ID]]]
[--redundantvios {0 | 1 | 2}] [--redundantvnicbkdev {1 | 2}]
[--vniccfg {1 | 2}]
[--filter "filter-data"]
[-F [attribute-names] [--header]] [--help]

DESCRIPTION

lslparmigr lists partition migration information.

OPTIONS

-r The type of resources for which to list partition migration information.
Specify lpar to list partition migration information for all of the partitions in managed-system.
Specify mc to list partition mobility capabilities for the Hardware Management Console (HMC).
Specify mem to list the memory requirements for the partition specified with the lpar_names or lpar_ids filter, and also list the available memory on the destination managed system.
Specify mempool to list shared memory pool information for the destination managed system. Shared memory pool information is only listed if the shared memory pool has enough available memory for the partition specified with the lpar_names or lpar_ids filter, if there is an available paging space device for the partition, and if the paging VIOS redundancy requirement of the partition can be satisfied. The redundant attribute that is listed indicates whether or not the partition would be configured to use redundant paging VIOS partitions on the destination managed system (a value of 0 indicates the partition would be configured to not use redundant paging VIOS partitions, and a value of 1 indicates the partition would be configured to use redundant paging VIOS partitions).
Specify msp to list possible source and destination mover service partition (MSP) pairs for active partition migration of the partitions specified with the lpar_names or lpar_ids filter.
Specify procpool to list possible shared processor pools in the destination managed system that have enough available processing resources for the partition specified with the lpar_names or lpar_ids filter.
Specify sys to list the partition mobility capabilities for managed-system.
Specify virtualio to list possible and suggested mappings of the virtual fibre channel adapters, virtual SCSI adapters, and virtual NICs in the partition specified with the lpar_names or lpar_ids filter.

-m The name of the managed system for which to list partition migration information. 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.
When listing memory, shared memory pool, mover service partition, shared processor pool, or virtual I/O information, specify the source managed system for the partition migration with this option.
This option is not valid when listing partition mobility capabilities for the HMC. This option is required when listing all other types of partition migration information.

-t The name of the target, or destination, managed system for the partition migration. 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 when listing memory, shared memory pool, mover service partition, shared processor pool, or virtual I/O information. This option is not valid when listing any other type of partition migration information.

--ip If the destination managed system is not managed by the same management console that is managing the source managed system, then use this option to specify the IP address or host name of the management console that is managing the destination managed system.
To use this option, SSH must be enabled on both management consoles. Also, you must run the mkauthkeys command once to set up SSH key authentication.

-u If the destination managed system is not managed by the same management console that is managing the source managed system, then 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.

--redundantvios,--redundantpgvios When listing shared memory pool information, use this option to specify the paging VIOS redundancy requirement for the partition on the destination managed system. Valid values are 0 if the partition is not to use redundant paging VIOS partitions, 1 if the partition is required to use redundant paging VIOS partitions, or 2 if the partition is to use redundant paging VIOS partitions if possible.
This option is only valid when listing shared memory pool information. If this option is not specified when listing shared memory pool information, then the partition is required to use the same paging VIOS redundancy configuration on the destination managed system that the partition is currently using on the source managed system.
The --redundantvios and --redundantpgvios options are equivalent. The --redundantpgvios option is deprecated.

--redundantvnicbkdev When listing virtual I/O information, use this option to specify the backing device redundancy requirement of the partition’s virtual NICs on the destination managed system. Valid values are 1 if the virtual NIC backing device redundancy is required to be maintained, or 2 if the virtual NIC backing device redundancy is to be maintained if possible. If this option is not specified, this option defaults to the value 1.
If this option has a value of 1, the HMC must map every virtual NIC backing device to a virtual NIC backing device on the destination managed system. In addition, the HMC must 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.
This option is only valid when listing virtual I/O information.

--vniccfg When listing virtual I/O information, use this option to specify the configuration requirements for the partition’s virtual NICs on the destination managed system. Valid values are 1 if the virtual NIC configuration is required to be maintained, or 2 if the virtual NIC configuration is to be maintained if possible. If this option is not specified, this option defaults to the value 1.
Specifying a value of 2 for this option will allow the HMC to map the partition’s virtual NICs to virtual NICs with different allowed VLAN IDs or maximum capacity configurations on the destination managed system.
This option is only valid when listing virtual I/O information.

--filter The filter(s) to apply to the resources to be listed. Filters are used to select which resources are to be listed. If no filters are used, then all of the resources will be listed. For example, partition information can be listed by using a filter to specify the names or IDs of the partitions to list. Otherwise, if no filter is used, then information for all of the partitions in the managed system will be listed.
The filter data consists of filter name/value pairs, which are in comma separated value (CSV) format. The filter data must be enclosed in double quotes.
The format of the filter data is as follows:
filter-name=value,filter-name=value,...
Note that certain filters accept a comma separated list of values, as follows:
filter-name=value,value,... ,...
When a list of values is specified, the filter 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.
Valid filter names:
lpar_names | lpar_ids
One of these filters is required when listing memory,
shared memory pool, mover service partition, shared
processor pool, or virtual I/O information. When
listing memory, shared memory pool, shared processor
pool, or virtual I/O information, only one partition
can be specified. These filters are optional when
listing partition information, and if specified,
multiple partitions can be specified.
dest_sys_names
The user-defined name or the machine type, model,
and serial number (tttt-mmm*sssssss) for one
or more destination managed systems. This filter
is only valid when listing partition information.
The lpar_names, lpar_ids, and dest_sys_names filters are mutually exclusive.
This option is not valid when listing HMC or managed system information.

-F A delimiter separated list of attribute names for the desired attribute values to be displayed. If no attribute names are specified, then values for all of the attributes will be displayed.
When this option is specified, only attribute values will be displayed. No attribute names will be displayed. The attribute values displayed will be separated by the delimiter which was specified with this option.
This option is useful when only attribute values are desired to be displayed, or when the values of only selected attributes are desired to be displayed.

--header Display a header record, which is a delimiter separated list of attribute names for the attribute values that will be displayed. This header record will be the first record displayed. This option is only valid when used with the -F option.

--help Display the help text for this command and exit.

EXAMPLES

List partition migration information for all partitions in the managed system system1:
lslparmigr -r lpar -m system1
List partition migration information for all partitions in the managed system system1 that are currently migrating or waiting to migrate to managed system system2:
lslparmigr -r lpar -m system1 --filter "dest_sys_names=system2"
List the required memory for partition lpar1 and list the available memory on destination managed system system2:
lslparmigr -r mem -m system1 -t system2 --filter "lpar_names=lpar1"
List the shared memory pool information for managed system system2 for partition lpar1 if lpar1 is to use redundant paging VIOS partitions on system2 if possible:
lslparmigr -r mempool -m system1 -t system2 --filter "lpar_names=lpar1"
--redundantvios 2
List possible source and destination MSP pairs for migrating partition lpar1 from managed system system1 to managed system system2:
lslparmigr -r msp -m system1 -t system2 --filter "lpar_names=lpar1"
List possible shared processor pools in managed system system2 that partition lpar1 can use when it is migrated from managed system system1 to system2:
lslparmigr -r procpool -m system1 -t system2 --filter
"lpar_names=lpar1"
List the partition mobility capabilities for managed system system1:
lslparmigr -r sys -m system1
List possible and suggested mappings of the virtual fibre channel adapters, virtual SCSI adapters, and virtual NICs in the partition with ID 1 to virtual I/O servers in managed system system2:
lslparmigr -r virtualio -m system1 -t system2 --filter "lpar_ids=1"
List possible and suggested mappings of the virtual fibre channel adapters, virtual SCSI adapters, and virtual NICs in partition aix1 to virtual I/O servers in managed system system2, when system2 is managed by the HMC with host name hmc2. In addition, list all possible mappings of the partition’s virtual NICs, even those that do not maintain the current backing device redundancy of the virtual NICs:
mkauthkeys --ip hmc2 -u hmc2user
lslparmigr -r virtualio -m system1 -t system2 --ip hmc2 -u hmc2user
--filter "lpar_names=aix1" --redundantvnicbkdev 2

ENVIRONMENT

None

BUGS

None

AUTHOR

IBM Austin

HMC Manual Reference Pages - LSLPARMIGR (1)

NAME

CONTENTS

SYNOPSIS

DESCRIPTION

OPTIONS

EXAMPLES

ENVIRONMENT

BUGS

AUTHOR

SEE ALSO

-r	The type of resources for which to list partition migration information. Specify lpar to list partition migration information for all of the partitions in managed-system. Specify mc to list partition mobility capabilities for the Hardware Management Console (HMC). Specify mem to list the memory requirements for the partition specified with the lpar_names or lpar_ids filter, and also list the available memory on the destination managed system. Specify mempool to list shared memory pool information for the destination managed system. Shared memory pool information is only listed if the shared memory pool has enough available memory for the partition specified with the lpar_names or lpar_ids filter, if there is an available paging space device for the partition, and if the paging VIOS redundancy requirement of the partition can be satisfied. The redundant attribute that is listed indicates whether or not the partition would be configured to use redundant paging VIOS partitions on the destination managed system (a value of 0 indicates the partition would be configured to not use redundant paging VIOS partitions, and a value of 1 indicates the partition would be configured to use redundant paging VIOS partitions). Specify msp to list possible source and destination mover service partition (MSP) pairs for active partition migration of the partitions specified with the lpar_names or lpar_ids filter. Specify procpool to list possible shared processor pools in the destination managed system that have enough available processing resources for the partition specified with the lpar_names or lpar_ids filter. Specify sys to list the partition mobility capabilities for managed-system. Specify virtualio to list possible and suggested mappings of the virtual fibre channel adapters, virtual SCSI adapters, and virtual NICs in the partition specified with the lpar_names or lpar_ids filter.
-m	The name of the managed system for which to list partition migration information. 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. When listing memory, shared memory pool, mover service partition, shared processor pool, or virtual I/O information, specify the source managed system for the partition migration with this option. This option is not valid when listing partition mobility capabilities for the HMC. This option is required when listing all other types of partition migration information.
-t	The name of the target, or destination, managed system for the partition migration. 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 when listing memory, shared memory pool, mover service partition, shared processor pool, or virtual I/O information. This option is not valid when listing any other type of partition migration information.
--ip	If the destination managed system is not managed by the same management console that is managing the source managed system, then use this option to specify the IP address or host name of the management console that is managing the destination managed system. To use this option, SSH must be enabled on both management consoles. Also, you must run the mkauthkeys command once to set up SSH key authentication.
-u	If the destination managed system is not managed by the same management console that is managing the source managed system, then 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.
--redundantvios,--redundantpgvios	When listing shared memory pool information, use this option to specify the paging VIOS redundancy requirement for the partition on the destination managed system. Valid values are 0 if the partition is not to use redundant paging VIOS partitions, 1 if the partition is required to use redundant paging VIOS partitions, or 2 if the partition is to use redundant paging VIOS partitions if possible. This option is only valid when listing shared memory pool information. If this option is not specified when listing shared memory pool information, then the partition is required to use the same paging VIOS redundancy configuration on the destination managed system that the partition is currently using on the source managed system. The --redundantvios and --redundantpgvios options are equivalent. The --redundantpgvios option is deprecated.
--redundantvnicbkdev	When listing virtual I/O information, use this option to specify the backing device redundancy requirement of the partition’s virtual NICs on the destination managed system. Valid values are 1 if the virtual NIC backing device redundancy is required to be maintained, or 2 if the virtual NIC backing device redundancy is to be maintained if possible. If this option is not specified, this option defaults to the value 1. If this option has a value of 1, the HMC must map every virtual NIC backing device to a virtual NIC backing device on the destination managed system. In addition, the HMC must 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. This option is only valid when listing virtual I/O information.
--vniccfg	When listing virtual I/O information, use this option to specify the configuration requirements for the partition’s virtual NICs on the destination managed system. Valid values are 1 if the virtual NIC configuration is required to be maintained, or 2 if the virtual NIC configuration is to be maintained if possible. If this option is not specified, this option defaults to the value 1. Specifying a value of 2 for this option will allow the HMC to map the partition’s virtual NICs to virtual NICs with different allowed VLAN IDs or maximum capacity configurations on the destination managed system. This option is only valid when listing virtual I/O information.
--filter	The filter(s) to apply to the resources to be listed. Filters are used to select which resources are to be listed. If no filters are used, then all of the resources will be listed. For example, partition information can be listed by using a filter to specify the names or IDs of the partitions to list. Otherwise, if no filter is used, then information for all of the partitions in the managed system will be listed. The filter data consists of filter name/value pairs, which are in comma separated value (CSV) format. The filter data must be enclosed in double quotes. The format of the filter data is as follows: filter-name=value,filter-name=value,... Note that certain filters accept a comma separated list of values, as follows: filter-name=value,value,... ,... When a list of values is specified, the filter 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. Valid filter names: lpar_names \| lpar_ids One of these filters is required when listing memory, shared memory pool, mover service partition, shared processor pool, or virtual I/O information. When listing memory, shared memory pool, shared processor pool, or virtual I/O information, only one partition can be specified. These filters are optional when listing partition information, and if specified, multiple partitions can be specified. dest_sys_names The user-defined name or the machine type, model, and serial number (tttt-mmm*sssssss) for one or more destination managed systems. This filter is only valid when listing partition information. The lpar_names, lpar_ids, and dest_sys_names filters are mutually exclusive. This option is not valid when listing HMC or managed system information.
-F	A delimiter separated list of attribute names for the desired attribute values to be displayed. If no attribute names are specified, then values for all of the attributes will be displayed. When this option is specified, only attribute values will be displayed. No attribute names will be displayed. The attribute values displayed will be separated by the delimiter which was specified with this option. This option is useful when only attribute values are desired to be displayed, or when the values of only selected attributes are desired to be displayed.
--header	Display a header record, which is a delimiter separated list of attribute names for the attribute values that will be displayed. This header record will be the first record displayed. This option is only valid when used with the -F option.
--help	Display the help text for this command and exit.