Status and configuration of LPARs are regularly needed information in the administration of LPARs. With the LPAR tool, information such as status, RMC status, number of cores, size of RAM, OS version and other data can be easily and quickly determined, even with hundreds or thousands of LPARs. Which LPARs don’t have an RMC connection is shown as one of the examples.
All of the following examples were performed on an environment with 10 HMCs, 50 managed systems, and just over 500 LPARs. To determine how long the LPAR tool requires, the run times of the commands were measured and specified using time.
The names of the LPARs were manually changed in the outputs shown and replaced by generic names lparXX and aixYY.
First of all, the status of a single LPAR:
$ time lpar status aix01 NAME LPAR_ID LPAR_ENV STATE PROFILE SYNC RMC PROCS PROC_UNITS MEM OS_VERSION aix01 27 aixlinux Running standard 0 active 1 0.1 8192 AIX 7.1 7100-04-02-1614 real 0m0.210s user 0m0.011s sys 0m0.013s $
Of course you can also specify multiple LPARs. If you want to know the status of all LPARs (in our case just over 500 LPARs), just leave out the argument:
$ time lpar status NAME LPAR_ID LPAR_ENV STATE PROFILE SYNC RMC PROCS PROC_UNITS MEM OS_VERSION aix01 27 aixlinux Running standard 0 active 1 0.1 8192 AIX 7.1 7100-04-02-1614 aix02 1 aixlinux Running standard - - 1 - 8320 Unknown ... lpar01 6 aixlinux Running standard 0 active 1 0.4 20480 AIX 7.1 7100-04-05-1720 real 0m18.933s user 0m3.819s sys 0m3.789s $
In the background, the LPAR tool executes more than 150 commands on the corresponding HMCs (lshwres and lssyscfg)!
The output should now be restricted to LPARs that are currently active (state=Running). There is the option “-s“, which can be used to specify criteria for attributes that must be met. Only LPARs meeting these criteria will be shown:
$ time lpar status -s state=Running NAME LPAR_ID LPAR_ENV STATE PROFILE SYNC RMC PROCS PROC_UNITS MEM OS_VERSION aix01 27 aixlinux Running standard 0 active 1 0.1 8192 AIX 7.1 7100-04-02-1614 aix02 1 aixlinux Running standard - - 1 - 8320 Unknown ... lpar01 6 aixlinux Running standard 0 active 1 0.4 20480 AIX 7.1 7100-04-05-1720 real 0m17.998s user 0m3.692s sys 0m3.647s $
Now we want to know on which of these LPARs RMC is not working/not active. The option “-s” allows to combine any number of criteria. All specified criteria must then be met (logical AND). The RMC state can be found in the attribute rmc_state:
$ time lpar status -s state=Running,rmc_state!=active NAME LPAR_ID LPAR_ENV STATE PROFILE SYNC RMC PROCS PROC_UNITS MEM OS_VERSION aix02 1 aixlinux Running standard - - 1 - 8320 Unknown aix03 2 aixlinux Running standard - - 1 - 8320 Unknown ... lpar07 4 aixlinux Running standard 0 none 1 1.0 4352 Unknown real 0m19.057s user 0m3.550s sys 0m3.512s $
As another example we want to know on which LPARs AIX 7.1 TL5 is installed. The os_version attribute contains the OS version. The ‘~‘ operator can be used to compare against a regular expression (similar to the grep command). We use the regular expression 7100-05:
$ time lpar status -s os_version~7100-05 NAME LPAR_ID LPAR_ENV STATE PROFILE SYNC RMC PROCS PROC_UNITS MEM OS_VERSION aix14 14 aixlinux Running standard 0 active 2 0.2 16384 AIX 7.1 7100-05-02-1810 aix16 24 aixlinux Running standard 0 active 2 0.2 16384 AIX 7.1 7100-05-03-1846 ... lpar10 10 aixlinux Running standard 0 active 3 0.3 32768 AIX 7.1 7100-05-02-1810 real 0m18.212s user 0m3.726s sys 0m3.676s $
So far, we have always used the default output format. Now we’d like to list all systems that still run on AIX 6.1, but this time only the LPAR name and the OS version will be output. For this there is the option “-F“, with which the desired output fields can be specified:
$ time lpar status -s os_version~6100 -F name:os_version aix39:AIX 6.1 6100-07-04-1216 aix46:AIX 6.1 6100-07-04-1216 ... lpar35:AIX 6.1 6100-09-05-1524 real 0m18.041s user 0m3.619s sys 0m3.699s $
If you prefer JSON output, you can easily do that with the option “-j“, here’s the same example with JSON output:
$ time lpar status -s os_version~6100 -F name:os_version -j { "name": "aix39", "os_version": "AIX 6.1 6100-07-04-1216" } { "name": "aix46", "os_version": "AIX 6.1 6100-07-04-1216" } ... { "name": "lpar35", "os_version": "AIX 6.1 6100-09-05-1524" } real 0m21.247s user 0m3.670s sys 0m3.720s $
Of course you can not know all attribute names by heart! But that’s not necessary, because you can easily see all attribute names. Use the option “-f” (stanza format) and specify any LPAR:
$ lpar status -f lpar19 lpar19: curr_lpar_proc_compat_mode = POWER7 curr_mem = 8192 curr_proc_mode = shared curr_proc_units = 0.3 curr_procs = 2 name = lpar19 os_version = AIX 6.1 6100-09-05-1524 ... $
With the options “-h” and “-m” the LPARs can be selected depending on the associated HMC and/or managed system.
Status of all LPARs with associated HMC hmc01:
$ lpar -h hmc01 status
Status of all LPARs whose corresponding HMC has type 7042-CR6:
$ lpar -h 7042-CR6 status
Status of all LPARs whose associated HMC has type 7042-CR6 and whose name begins with lpar:
$ lpar -h 7042-CR6 status lpar*
Status of all LPARs on the managed system ms13:
$ lpar -m ms13 status
Status of all LPARs whose managed system is an S922:
$ lpar -m 9009-22A status
The presented selection and output options apply to all output commands of the LPAR tool (except the vios command).
The LPAR-Tool can be downloaded from our download area: https://powercampus.de/en/download-2
The LPAR-Tool contains a test license which is valid until the end of october.