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.
