Notes on automatic POSIX package installation using IMON

Prerequisites and general concept

A prerequisite for automatic package installation is that

• IMON-BAS is installed in POSIX,

• "POSIX processing" is activated for the selectable unit when the IMON installation procedure is generated with INSTALL-UNITS or in menu mode and

• the selectable unit of the product contains POSIX items with type *PS.

When a new product version is supplied, the following actions are always performed:

1. Uninstallation of the previous version installed in POSIX

2. Installation of the new product version in POSIX

By default products are also installed in POSIX which were previously not yet installed in POSIX. In this case uninstallation is not required.

Automatic POSIX package installation can be disabled by reading in the SOLIS package (INSTALL-UNITS).

IMON installation procedure in BS2000

The IMON installation procedure executes the following steps when installing the products in BS2000:

1. The $SYSROOT.POSIX.CONFIGURATION file is generated or updated. This contains a list of all packages which are installed in POSIX.

2. Files are created which are used as input files for automatic POSIX package installation with the POSIX installation program (in batch mode):

   $SYSROOT.IMON.ACTIONS.REM (delete packages)
   $SYSROOT.IMON.ACTIONS.ADD (install packages)

   The content of the CONFIGURATION files is relevant for the structure of the REM file. All the named files are created on the home pubset in the SYSROOT ID.

Executing automatic package installation in POSIX

Package installation itself (uninstallation of the old packages and installation of the new packages) is performed automatically by IMON either the next time POSIX is started or as part of dynamic activation using ACTIVATE-UNITS. If problems occur in package installation, these are logged in the /var/sadm/pkg/insterr file (see "START-POSIX-INSTALLATION").

• Package installation in a POSIX startup:

  Uninstallation/Installation takes place using the /etc/rc2.d/S05imon script. The input files for the POSIX installation program are the IMON.ACTIONS files set up with the installation procedure. All the products contained there must be activated. They are activated following a restart of BS2000.

  After installation has been completed, the IMON.ACTIONS files are always assigned the suffix ".SAVE".

• Package installation with ACTIVATE-UNITS:

  ACTIVATE-UNITS for the selectable unit BS2GA.POSIX causes POSIX to restart automatically (if the POSIX subsystem is included in the delivery). Package installation then takes place subsequently when POSIX is restarted (see above).

  For all other selectable units package installation is executed as follows: When the activation procedure is performed, IMON moves the entries for products which are to be activated to temporary IMON.ACTIONS files (with the file name suffix #) and performs uninstallation/installation of the packages using these files.

  When the operation is successful, the entries for the installed products are removed from the IMON.ACTIONS files set up by the IMON installation procedure. The original status of these files is then contained in a backup copy with the suffix ".SAV". If an error occurs, the IMON.ACTIONS files remain unchanged.

  ATTENTION!:

  Dynamic activation of the POSIX selectable unit should always only be performed if it has been performed for the other products, otherwise all products following the POSIX selectable unit will not yet have been activated when the automatic POSIX startup takes place and package installation for them will therefore fail.

Procedure for dynamic activation during ongoing operation

A fundamental distinction must be made according to whether or not the delivery contains the installation unit POSIX-BC (selectable unit BS2GA.POSIX) or CRTE-BASYS (selectable unit BS2GA.CRTE-BAS). Depending on this, the following variants are possible:

1. When deliveries do not include POSIX-BC or CRTE-BASYS, POSIX does not need to be restarted. Package installation takes place automatically as part of ACTIVATE-UNITS during ongoing POSIX operation.

2. In the case of deliveries with POSIX-BC or CRTE-BASYS, POSIX must be restarted. Two procedures are possible here:

   1. Joint installation of all products

      • Terminate POSIX

      • Install all selectable units in BS2000 and activate them with ACTIVATE-UNITS

      • Restart POSIX (automatic package installation takes place as part of the POSIX restart)

   2. Separate installation of POSIX-BC/CRTE-BASYS and other products

      • While POSIX is running, install all selectable units in BS2000 except for BS2GA.POSIX and BS2GA.CRTE-BAS

      • Activate these selectable units with ACTIVATE-UNITS (automatic package installation takes place as part of ACTIVATE-UNITS)

      • Terminate POSIX

      • Install BS2GA.POSIX and/or BS2GA.CRTE-BAS in BS2000 and activate them with ACTIVATE-UNITS

      • Restart POSIX (automatic package installation when POSIX restarts).