IVM lslparmigr command
Purpose
Lists and displays partition migration information. This command is operable only in an Integrated Virtualization Manager environment.
Syntax
lslparmigr -r manager | lpar | msp | procpool | sys | virtualio | mempool | pgdev [-m <managed system] [-t <managed system>] [--ip <target HMC/IVM IP address> [-u <target HMC/IVM user name>]] [--filter "<filter data>"] [-F [<attribute names>]] [--redundantpgvios { 0 | 1 | 2 }] [--header] [--help]
Description
The lslparmigr command displays the state of the partition migration and the adapter mappings that might be used during the partition migration.
Flags
Flag name | Description |
---|---|
-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 msp to list possible source and destination mover service partition (MSP) pairs for an active partition migration of the partition 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 SCSI adapters and virtual fibre channels in the partition specified with the lpar_names or lpar_ids filter to Virtual I/O Server in the destination managed system. Specify mempool to list details for each shared memory pool on the target managed system. Specify pgdev to list paging devices available on the target managed system. |
-m <managed system> | The name of the source managed system. |
-t <managed system> | The name of target managed system. |
--ip | The IP address or hostname of the Integrated Virtualization Manager managing the target system. |
-u | The user name to use on the Integrated Virtualization Manager that manages the target system. If the --ip flag is specified and -u flag is not specified, the user name on the source Integrated Virtualization Manager is used on the target Integrated Virtualization Manager. |
--filter <filter data> | The filter or filters 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 quotation marks. The
format of the filter data is as follows:
Note: Certain
filters accept a comma separated list of values, as follows:
When
a list of values is specified, the filter name/value pair must be
enclosed in quotation marks. Depending on the shell being used, nested
quotation marks may need to be preceded by an escape character, which
is usually a '\' character.
|
-F [<attribute names>] | List of the names of the attributes. If no attribute names are specified, then all attributes will be listed. |
-redundantpgvios | Specify the configured level
of redundancy for the memory pools to be listed.
Exactly one partition must be specified by either the lpar_ids filter or lpar_names filter. If no suitable memory pools are found on the destination managed system, the destination IVM generates an error message that describes the problem. |
--header | Displays a header record, which is a delimiter separated list of attribute names for the attribute values that are displayed. This header record is the first record displayed. This option is only valid when used with the -F option. |
--help | Displays the help text for this command and exit. |
Exit Status
This command has a return code of 0 on success.
Examples
- To return partition mobility capabilities for the HMC or the Integrated Virtualization Manager, type the following
command:
lslparmigr -r manager remote_lpar_mobility_capable=1
- To return partition mobility capabilities for the specified managed
system, type the following command:
lslparmigr -m zd25ae -r sys inactive_lpar_mobility_capable=1,num_inactive_migrations_supported=40, num_inactive_migrations_in_progress=0, active_lpar_mobility_capable=1,num_active_migrations_supported=40, num_active_migrations_in_progress=0
- To return a list of partitions on the specified managed system
and their migration state, type the following command:
$ lslparmigr -r lpar name=10-0EDDA,lpar_id=1,migration_state=Not Migrating name=mptest_migration,lpar_id=2,migration_state=Not Migrating name=lp3,lpar_id=3,migration_state=Not Migrating name=mp_i51,lpar_id=4,migration_state=Not Migrating name=mover2,lpar_id=5,migration_state=Migration Starting, migration_type=active,dest_sys_name=migfspL4, dest_lpar_id=5,source_msp_name=10-0EDDA,source_msp_id=1, dest_msp_name=10-0EDEA,dest_msp_id=1,bytes_transmitted=10247078, bytes_remaining=259547136, remote_manager=miglpar9.yourcity.yourcompany.com, remote_user=padmin name=lpar10,lpar_id=10,migration_state=Not Migrating
- To return a list of possible source and destination MSP pairs,
type the following command:
lslparmigr -r msp -m migfspL2 -t migfspL1 source_msp_name=VIOS,source_msp_id=2,"dest_msp_names=VIOS,VIOS2", "dest_msp_ids=1,3","ipaddr_mappings=192.168.10.10/en1/1/VIOS/192. 168.10.11/en1,192.168.20.10/en2/3/VIOS2/192.168.20.13/en0" source_msp_name=VIOS2,source_msp_id=1,"dest_msp_names=VIOS,VIOS2", "dest_msp_ids=1,3","ipaddr_mappings=192.168.10.12/en0/1/VIOS/192. 168.10.11/en1,192.168.20.12/en1/3/VIOS2/192.168.20.13/en0"
- To return a list of possible and suggested mappings for virtual
SCSI and virtual Ethernet adapters, type the following command:
lslparmigr -r virtualio -m migfspL2 -t migfspL1 --filter "lpar_ids=5" "possible_virtual_scsi_mappings=2/VIOS/1,2/VIOS2/3", "suggested_virtual_scsi_mappings=2/VIOS/1"
- To return a list of existing shared processor pools on the target
managed system, type the following command:
lslparmigr -r procpool -m migfspL2 -t migfspL1 --filter "lpar_ids=5" "shared_proc_pool_ids=0,3,6","shared_proc_pool_names= DefaultPool,ProcPoolA,ProcPoolB"
- To return a list of possible and suggested mappings
for virtual fibre channel adapters, type the following command:
lslparmigr -r virtualio -m migfspL2 -t migfspL1 --filter "lpar_ids=5" "possible_virtual_scsi_mappings=2/VIOS/1", "suggested_virtual_scsi_mappings=2/VIOS/1" "possible_virtual_fc_mappings=4/VIOS/1,4/VIOS2/2", "suggested_virtual_fc_mappings=4/VIOS/1"