2.4.5. Die Online Dokumentation

Alle 4 Kommandos bieten eine ausführliche Online Hilfe. Alle Funktionen sind in Kategorien organisiert, wie z.B. SCSI, SEA, Memory usw. Welche Kategorien für eines der 4 Kommandos verfügbar sind, kann durch Verwenden des Arguments (Keyword) „help“ angezeigt werden, z.B.:

$ lpar help
Help is available for the following categories:

lpar help blueprint eth fc io led lic lpm

lpar help mem memory power proc processor prof profile
lpar help scsi serial sriov vnic

Specific help is available for each of the supported keywords:

lpar help <keyword>

For a complete list of all keywords try:

lpar help usage
$

Alle Funktionen (Keywords) die zu einer Kategorie gehören, lassen sich anzeigen, indem man nach dem Keyword „help“ eine der verfügbaren Kategorien angibt, hier z.B. die Kategorie „mem“ beim Kommando lpar:

$ lpar help mem
USAGE: lpar [<option> ...] <keyword> [<option> ...] [<argument> ...]

Recognized keywords for topic 'mem' are:

[-h <hmc>] [-m <ms>] [-p <profile>] addmem [-d] [-f] [-l <detail_level>] [-w <wait_time>] [-v] <lpar> <mem>[k|K|m|M|g|G|t|T]
[-h <hmc>] [-m <ms>] [-p <profile>] chmem [-d] [-f] [-l <detail_level>] [-w <wait_time>] [-v] <lpar> <attributes> ...
[-h <hmc>] [-m <ms>] [-p <profile>|-H] lsmem [{-o <format>|-f|-j|-y}] [-F <fields>] [-s <selections>] [-v] [<lpar> ...]
[-h <hmc>] [-m <ms>] [-p <profile>] lsmemopt [{-o <format>|-f|-j|-y}] [-F <fields>] [-s <selections>] [-v] [<lpar> ...]
[-h <hmc>] [-m <ms>] [-p <profile>] rmmem [-d] [-f] [-l <detail_level>] [-w <wait_time>] [-v] <lpar> <mem>[k|K|m|M|g|G|t|T]
$

Detaillierte Informationen zu einer konkreten Funktion (Keyword) erhält man durch „help“ und die Angabe des Keywords, hier z.B. für das Keyword „chmem“:

$ lpar help chmem
USAGE:
lpar [-h <hmc>] [-m <ms>] [-p <profile>] chmem [-d] [-f] [-l <detail_level>] [-w <wait_time>] [-v] <lpar> <attributes> ...

DESCRIPTION

Change memory attributes for an LPAR. If no option '-d' or '-p' is
specified, the command tries to change the attributes by a DLPAR
operation and by changing the current profile.
Since most of the attributes are either valid only for DLPAR or
the profile, but not both, this makes changing memory related attributes
somewhat complicated. To ease usage, the following filtering is applied:
- If a specified attribute can not be changed by a DLPAR operation, the
attribute is skipped from the DLPAR operation.
- If a specified attribute can not be changed in a profile, the attribute
is skipped from the operation.
When skipping attibutes, a hint is shown to the user!

-d : only DLPAR operation, don't update profile

-f : force operation, even if there is no RMC connection
-l : level of detail (1-4)
-p : update the specified profile only
-w : time (minutes) to wait for operation to finish

valid attributes for DLPAR and profile:

mem_weight
mem_expansion
0 - disable memory expansion (profile only)
1.00 to 10.00 - memory expansion factor

valid attributes for DLPAR only:

hardware_mem_encryption
0 - disable hardware-accelerated encryption
1 - enable hardware-accelerated encryption
hardware_mem_expansion
0 - disable hardware-accelerated memory expansion
1 - enable hardware-accelerated memory expansion

valid attributes for profile only:

mem_mode : memory sharing mode
ded - dedicated memory
shared -shared memory
min_mem : minimum number of megabytes
desired_mem : desired number of megabytes
max_mem : maximum number of megabytes
min_num_huge_pages : minimum number of huge pages (only AIX and Linux)
desired_num_huge_pages : desired number of huge pages (only AIX and Linux)
max_num_huge_pages : maximum number of huge pages (only AIX and Linux)

NOTES

When the attribute 'mem_expansion' is set to '0', to disable active memory
expansion, the value of '0' is replaced by '1.0' in a DLPAR operation, since
active memory expansion can only be disabled in the profile.
Although the attribute 'desired_mem' is valid only in a profile, it is
interpreted as meaning the current amount of memory in a DLPAR operation.
The values for 'min_mem', 'desired_mem' and 'max_mem' can be specified with
a suffix indicating KB, MB, GB or TB. See 'lpar help addmem' for an overview
of the possibles suffixes.

EXAMPLES

Change memory expansion factor of LPAR lpar01 to 1.25:,
lpar chmem lpar01 mem_expansion=1.25

Turn off memory expansion for LPAR lpar01:,

lpar chmem lpar01 mem_expansion=0
(Memory expansion is turned off in the current profile, and is set to 1.0
by the DLPAR operation.)

Turn on hardware-accelerated memory expansion dynamically on for LPAR lpar03:

lpar chmem -d lpar03 hardware_mem_expansion=1 # or
lpar chmem lpar03 hardware_mem_expansion=1
(Since 'hardware_mem_expansion' is only valid for a DLPAR operation, the update
of the current profile is simply skipped in the second case!)

Change in profile 'standard' of lpar01 the memory sharing mode to 'shared',

and the maximum memory size to 16 gigabytes:
lpar -p standard chmem lpar01 mem_mode=shared max_mem=16G

$

Neben einer Übersicht zur Syntax, gibt es für jedes Keyword eine kurze Beschreibung der Funktionalität. Eine Auflistung und Beschreibung der verfügbaren Optionen und Attribute des Kommandos, sowie eine Reihe von Beispielen der Verwendung des Keywords.