subscribe iconSubscribe to this information
POWER7 information

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:
"filter-name=value,filter-name=value,..."
Note: 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 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.
Valid filter names: 
lpar_names | lpar_ids 
Only one of these filters may be specified
-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.
0
Do not require redundancy on the target managed system.
1
Only return memory pool information for those that are capable of redundancy.
2
Return all memory pool information regardless of redundancy capabilities.
If you do not specify the parameter, memory pools capable of the currently configured level of redundancy are returned.

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

  1. 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
  2. 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
  3. 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
  4. 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"
  5. 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"
  6. 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"
  7. 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"


Send feedback Rate this page

Last updated: Wed, June 03, 2015