lppmgr Command
Purpose
Manages an existing installp image source.
Syntax
lppmgr -d DirectoryOrDevice [ -r | -m MoveDirectory | -a APAR number ] { [ -x ] [ -X ] [ -l ] [ -u ] [ -b ] [ -k LANG ] } [ -p ] [ -t ] [ -s ] [ -V ] [ -D ]
Description
lppmgr is designed to perform
the following functions on an existing installp image source (also
known as an lpp_source in the NIM environment):
- Remove duplicate updates (-u Flag).
- Remove duplicate base levels (-b Flag).
- Eliminating updates that are the same level as bases of the same file set. Such updates can create conflicts that lead to installation failure (-u Flag).
- Remove message and locale file sets other than the language you specify (-k Flag).
- Remove superseded file sets (-x Flag).
- Remove non-system images from a NIM lpp_source resource (-X Flag).
By default, lppmgr lists all images that are filtered by the preceeding routines. The "-r" flag can be used to remove the filtered images and the "-m" flag can be used to move the images to another location.
Note: lppmgr is not intended
to replace bffcreate, install anything, or work with installed file
sets. It is also not intended to address any issues other than those
mentioned earlier. Before you use the "-X" flag, you must have
a good understanding of NIM, system images (known as SIMAGES in NIM),
and the workings of a NIM lpp_source resource.
Flags
| Item | Description |
|---|---|
| -a APAR number | Displays file sets associated with an APAR number or keyword. If there are more than one APAR numbers, they must be contained in quotation marks and separated by spaces. |
| -b | Causes lppmgr to filter for base level duplicates. |
| -D | Specifies debug mode. This flag is for debugging
the lppmgr script. Note: Debug. This produces a large quantity
of output and greatly reduces lppmgr performance. It is not useful
for normal operations.
|
| -d DeviceOrDirectory | Specifies the device or directory where the installp images reside. Currently it can be any directory, NFS mount point, or cdrom device. If the directory is not writable, you must use the -t flag. If the target of your operation is a NIM lpp_source resource, you must specify the lpp_source location (see the lsnim command). This flag is required for all operations. |
| -k LANG | Keeps only the message and locale images for the language specified by LANG. All other languages are filtered. |
| -l | Lists filtered images only. By default, lppmgr will only list all filtered image files unless the "-r" or "-m" flag is specified. The "-l" flag will override the "-r" or "-m" flag. |
| -m Directory | Moves filtered files to Directory. The location that is specified by Directory can be any writable directory path. This flag cannot be used with the "-r" flag. |
| -p | Specifies prompt mode. Prompt when moving or removing files. |
| -r | Removes files that have been filtered by lppmgr.
Note: If the prompt flag is not specified (-p), lppmgr removes
all filtered files without further user interaction. This flag cannot
be used with the "-m" flag.
|
| -s | Prints space usage information. This flag prints the amount of space a particular file set is using and the total amount of space in question. Some buffer space is added for file metadata. |
| -t | Specifies that lppmgr does not rebuild the .toc file. This flag can be useful for having a quick look without having to rebuild the entire .toc file, which can take some time. Also, this flag is required for read-only devices. |
| -u | Causes lppmgr to filter for duplicate updates and conflicting updates that are the same level as bases of the same file set. |
| -V | Specifies verbose mode. lppmgr gives more output in certain situations. |
| -x | Causes lppmgr to filter for superseded updates. |
| -X | Filters non-system images from a NIM lpp_source resource. |
Exit Status
- 0
- All lppmgr related operations that are completed successfully.
- >0
- An error occurred.
Security
Only the root user can execute lppmgr.
Examples
- To list all duplicate and conflicting updates in image source
directory /myimages, enter the following command:
lppmgr -d /myimages -u - To remove all duplicate and conflicting updates in image source
directory /myimages, enter the following command:
lppmgr -d /myimages -u -r - To remove all duplicate and conflicting updates, duplicate base
levels, and all message/locale file sets other than "en_US" in prompted
mode, enter the following command:
lppmgr -d /myimages -purb -k en_US - To move all superseded update images and non SIMAGES from NIM lpp_source location /lpps/433 to
directory /backups, enter the following command:
lppmgr -d /lpps/433 -x -X -m /backups - To list all the file sets associated with APAR
numbers IX38794 and IX48523 in image source directory
/myimages, enter the following command:
lppmgr -d /myimages -a "IX38794 IX48523"
Files
| Item | Description |
|---|---|
| /usr/lib/instl/lppmgr | Contains the lppmgr command. |