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 lpmlpar help mem memory power proc processor prof profile
Specific help is available for each of the supported keywords:
lpar help scsi serial sriov vniclpar 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
-d : only DLPAR operation, don't update profile
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!-f : force operation, even if there is no RMC connection
valid attributes for DLPAR and profile:
-l : level of detail (1-4)
-p : update the specified profile only
-w : time (minutes) to wait for operation to finishmem_weight
valid attributes for DLPAR only:
mem_expansion
0 - disable memory expansion (profile only)
1.00 to 10.00 - memory expansion factorhardware_mem_encryption
valid attributes for profile only:
0 - disable hardware-accelerated encryption
1 - enable hardware-accelerated encryption
hardware_mem_expansion
0 - disable hardware-accelerated memory expansion
1 - enable hardware-accelerated memory expansionmem_mode : memory sharing mode
NOTES
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)
When the attribute 'mem_expansion' is set to '0', to disable active memory
EXAMPLES
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.
Change memory expansion factor of LPAR lpar01 to 1.25:,
Turn off memory expansion for LPAR lpar01:,
lpar chmem lpar01 mem_expansion=1.25lpar chmem lpar01 mem_expansion=0
Turn on hardware-accelerated memory expansion dynamically on for LPAR lpar03:
(Memory expansion is turned off in the current profile, and is set to 1.0
by the DLPAR operation.)lpar chmem -d lpar03 hardware_mem_expansion=1 # or
Change in profile 'standard' of lpar01 the memory sharing mode to 'shared',
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!)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.