La commande 'emgr' permet de gérer les correctifs pour un système AIX.

Il est possible de lister les correctifs existant, de les ajouter ou encore de les retirer.

 Exemple : 'emgr -P' liste les correctifs actuellement installés sur le système.

PACKAGE                                                  INSTALLER   LABEL

======================================================== =========== ==========

devices.pciex.b3154a63.rte                               installp    IV82095s1a

gpfs.base                                                installp    g411p4e14

gpfs.ext                                                 installp    g411p4e14

bos.net.tcp.client                                       installp    IV84947m1a

bos.rte.control                                          installp    IV80586s1a

devices.pciex.e4145616e4140518.rte                       installp    IV81459s1b

bos.net.tcp.client                                       installp    IV87420m0a

devices.pci.df1000f7.com                                 installp    IV85098s1a


Pour effacer un Efixe, souvent nécessaire avant une mise à jour AIX, il faut utiliser la commande 'emgr -r -L Label du Efixe'  # 

Exemple : 'emgr -r -L IV87420m0a'

Version officielle de la documentation IBM :

emgr Command

 

Purpose

Starts the interim fix (interim fix) manager, which installs, removes, lists, and checks system interim fixes.

Syntax

To list interim fix; data:

emgr -l [ -L Label | -n interim fixNumber | -u VUID ] [-v{1|2|3} ] [ -X ] [-a path]

To install an interim fix package:

emgr -e interim fixPackage | -f ListFile [-w Directory ] [ -b | -k | -I ] [ -p ] [ -q ] [ -m ] [ -o ] [ -X ] [-a path]

To remove an installed interim fix:

emgr -r -L Label | -n interim fixNumber | -u VUID | -f ListFile [-w Directory ] [-a path] [-b | -k | -I ] [ -p ] [ -q ] [ -X ]

To check an installed interim fix:

emgr -c [ -L Label | -n interim fixNumber | -u VUID | -f ListFile ] [ -w Directory ] [-a path] [-v{1|2|3} ] [ -X ]

To mount or unmount an installed interim fix:

emgr -M | -U [ -L Label | -n interim fixNumber | -u VUID | -f ListFile ] [ -w Directory ] [-a path] [ -X ]

To force removal of an installed interim fix:

emgr -R interim fixLabel [ -w Directory ] [-a path] [ -X ]

To view packages locked by interim fix manager:

emgr -P [ Package ] [-a path] [ -X ]

To display the contents and topology of an interim fix package:

emgr -d -e interim fixPackage | -f ListFile [-w Directory ] [-v{1|2|3} ]

Description

The emgr (interim fix manager) command can be used to install and manage system interim fixes. The interim fix manager installs packages created with the epkgcommand and maintains a database containing interim fix information. The emgr command performs the following operations:

  • interim fix package installation
  • interim fix removal
  • interim fix listing
  • interim fix checking
  • interim fix mounting
  • interim fix unmounting
  • Display package locks
  • Force removal of an installed interim fix

Note:
  • If an attempt is made to update a fileset (using the installpinstall_all_updates, or smit update_all command) that has been locked by the interim fix manager, a notice will be displayed indicating which filesets are locked. In some cases, there is no notice to indicate why a fileset was prevented from being installed. The lslpp command shows that any locked filesets are in the EFIXLOCKED state.
  • Any library or executable program updated by an interim fix or service update which is in use by an active process will not be reflected in that process unless it is restarted. For example, an update that changes the ksh will not have the changes reflected in any ksh processes that are already running. Likewise, an update to the libc.a library will not be reflected in any process that is already running. In addition, any process that is using a library and does a dlopen operation of the same library after the library has been updated could experience inconsistencies if it is not restarted.

Referencing an Efix

The ways to reference an interim fix are as follows:

Reference by Label
Each interim fix that is installed on a given system will have a unique interim fix label. This is the unique key that binds all of the different database objects. To reference an interim fix by label, pass the label as a parameter to the -L flag. For example, to run a check operation on an interim fix with label ABC123, type:
emgr -cL ABC123
Reference by Efix ID
Each interim fix that is installed on a given system has an interim fix ID. The interim fix ID is simply the order number in which the interim fix is listed in the interim fix database. Using this option may be convenient if you are performing operations on interim fixes based on interim fix listings. The emgr command will convert the interim fix ID into an interim fix label before performing the given operation. To reference an interim fix by ID, pass the ID as an parameter to the -n flag.
Note:
Efix IDs can change as interim fixes are removed and added. Always verify the current interim fix ID number by using the -l flag to list the specific interim fix or all interim fixes.
For example, to run a check operation on the first interim fix with ID equal to 1, type:
emgr -cn1
Reference by VUID
Because interim fix packages are not formally tracked by any entity, it is possible that the same interim fix label could be used for more than one interim fix package. However, the emgr command does not accept the installation of more than one interim fix with the same interim fix label at the same time. The VUID (Virtually Unique ID) can be used to differentiate packages with the same interim fix label. The emgr command converts the VUID into an interim fix label before performing the given operation. For example, to list an installed interim fix with VUID equal to 000775364C00020316020703, type:
emgr -l -u 000775364C00020316020703
Note:
The VUID is displayed in the preview phase of interim fix installation and removal. The VUID is also displayed when listing with verbosity level set to 2 or higher with the -v flag.

Efix Logging

The following operations are logged to the emgr command log file, /var/adm/ras/emgr.log:

  • Installation
  • Removal
  • Checking
  • Mounting
  • Unmounting
  • Forced Removal

Enabling Automatic Interim Fix Removal by installp

An interim fix can be packaged by the epkg command to contain an APAR reference file containing APAR reference numbers. An APAR reference number will allow installpto map an interim fix back to the APARs for all the Technology Levels where the fix was shipped. If installp determines that the interim fix is contained in the Technology Level, Service Pack, or PTF being applied, installp will automatically remove the interim fix prior to applying the updates.

If an interim fix is enabled for automatic removal, the emgr command will display the following message during the installation of the interim fix:

ATTENTION: Interim fix is enabled for automatic removal by installp.

Concurrent Updates

The emgr command supports the installation of a new kind of interim fix called a concurrent update. This form of interim fix contains a modification to the AIX kernel, or one of its kernel extensions, that can be applied directly to the system memory and does not require the system to be rebooted. This direct patching to the system memory allows you to safely evaluate and test a kernel modification without modifying the file containing the system's current kernel on the disk. Any concurrent update applied to the system memory will not persist after a system reboot unless you choose to commit the changes introduced by the concurrent update to the disk using the -C flag. You can apply a concurrent update directly over another patch for the same module. You do not need to remove the previous patch. However, there must be only one version of the module loaded. Also, you cannot run any concurrent update operations (in-memory or on disk) for interim fixes in the REBOOT_REQUIRED state until the system is rebooted.

Flags

-a path Specifies an alternate directory path for installation.
-b Causes the emgr command to skip the usual AIX bosboot process for interim fixes that require rebooting.
-c Specifies the check operation. Instructs the emgr command to run a check operation on the specified interim fix or interim fixes.
-d Displays the contents and topology. This option is useful with the -v flag in displaying verbosity output.
-e interim fixPackage Specifies the path of the interim fix package file. The interim fix package file must be created with the epkg command and must end with the 16-bit compression extension, .Z.
-f ListFile Specifies a file that contains one of the following:
  • A list of package locations for the installation operation (one per line)
  • A list of interim fix labels for the remove, mount, unmount, and check operations (one per line)
The emgr command ignores any blank lines or lines where the first non-white-space character is the # character.
-I Runs the low-level debugger for AIX bosboot by using the bosboot command's -I flag.
-k Loads the low-level debugger during AIX bosboot using the bosboot command's -D flag.
-l Instructs the emgr command to run the list operation on the specified interim fix or interim fixes.
-L Label Selects the interim fix for this operation by interim fix label.
-m Instructs the emgr command to perform a mount installation. When and interim fix is mount-installed, the interim fix files are mounted over the target files.
-M Instructs the emgr command to mount an interim fix or interim fixes that have been mount-installed by using the -m flag. The -M flag can be used to mount an interim fix that was installed using the -m flag and has been unmounted by the -U flag or by some other means, such as rebooting the system.
-n interim fixID Selects the interim fix for this operation by specifying the interim fix ID.
-o Specifies that the interim fix installation can overwrite an existing package.
-p Instructs the emgr command to perform a preview for either installation or removal. The preview runs all of the check operations, but does not make any changes.
-P [ Package ] Specifies the package-view operation, which displays all packages that are locked by the interim fix manager, their installer, and the locking label or labels.
-q Suppresses all output other than errors and strong warnings.
-r Instructs the emgr command to run a remove operation on the specified interim fix or interim fixes.
-R Label Instructs the emgr command to run a force-remove operation. This option removes interim fix data and package locks associated with the interim fix label without actually removing interim fix files, running any remove scripts, or boot processing. This option can be used for only one interim fix at a time. The interim fix label is required to identify the target interim fix.
Attention: This method of interim fix removal should be considered an emergency procedure. Because this method can create inconsistencies on the target system, the force remove method should be used only if all other methods of removing the interim fix are unsuccessful.
-u VUID Selects the interim fix for this operation by specifying the VUID.
-U Instructs the emgr command to unmount an interim fix or interim fixes that have been mount-installed by using the -m flag.
-v{1|2|3} Specifies the verbosity level for the listing operation or the verification level for the check operation. Valid levels are 1, 2, and 3.
-w Directory Instructs the emgr command to use the specified working directory instead of the default /tmp directory.
-X Attempts to expand any file systems where there is insufficient space to perform the requested emgr operation. This option expands file systems based on available space and size estimates that are provided by the interim fix package and the emgr command.
Notes:
  1. It is possible to exhaust available disk space during an installation even if the -X flag is used. This is more likely if other files are being created or expanded in the same file systems during an installation.
  2. Remote file systems cannot be expanded by the emgr command.

Exit Status

0
All of the emgr command operations completed successfully.
>0
An error occurred.

Security

Only the root user can run the emgr command. Efix data, saved files, and temporary files are accessible only by the root user.

The emgr command looks for a supported MD5 generating command on the system. If one is located, the emgr command displays the MD5 checksum to the user. The user can then cross check this MD5 sum with a secured source. If an MD5 generating command is not located, the emgr command takes no further action.

The user can force set the path to an MD5 command by exporting the EMGR_MD5_CMD shell variable. This variable should contain the absolute path to the MD5 generating command.

Note:
This feature is not supported in the original release of interim fix management. It is recommended that the user updates to the latest level of interim fix management by updating bos.rte.install to the latest level.

Examples

  1. To preview the installation of an interim fix package called games.020303.epkg.Z, type:
    emgr -p -e games.020303.epkg.Z
  2. To install the interim fix package called games.020303.epkg.Z and automatically expand file systems if additional space is needed, type:
    emgr -X -e games.020303.epkg.Z
  3. To list all interim fixes on the system, type:
    emgr -l
  4. To do a level 3 listing of interim fix label games, type:
    emgr -lv3 -L games
  5. To remove the interim fix with label games, type:
    emgr -r -L games
  6. To preview the removal of the interim fix labels in file /tmp/myfixes, type:
    emgr -rp -f /tmp/myfixes
  7. To check all interim fixes with verification level 2, type:
    emgr -cv2
  8. To check interim fix ID number 3 with verification level 1 (the default verification level), type:
    emgr -c -n3
  9. To check interim fix with VUID of 000775364C00020316020703 and verification level 3, type:
    emgr -u 000775364C00020316020703 -c -v3
  10. To list all locked packages and their interim fix labels, type:
    emgr -P
  11. To list all interim fix labels that have locked the installp package bos.rte.lvm, type:
    emgr -P bos.rte.lvm
  12. To mount-install the interim fix package called games.020303.epkg.Z and suppress AIX bosboot, type:
    emgr -e games.020303.epkg.Z -mb
  13. To mount all interim fix files that have been mount-installed on the system by using the -m option, type:
    emgr -M
  14. To unmount all interim fix files associated with interim fix label games, type:
    emgr -U -L games
  15. To display level 3 verbosity output on interim fix package test.102403.epkg.Z, type:
    emgr -v3 -d test.102403.epkg.Z

Exemples :

- 'emgr -l ' : Liste l'ensemble des correctifs installés.

icon phone
Téléphone/Whatsapp : +33 (0)6 83 84 85 74
icon phone