installFixPack - Update installed DB2 database products command

This command can be found at the top directory in the image.

Fix pack installation will proceed when the database manager (DBM) of every instance (and in a partitioned database environment, every node) related to the installation path is stopped, and all DB2 libraries are unloaded. If all the preconditions are satisfied, installFixPack will update those instances and DAS related to the installation path. An additional manual update is not required. For all UNIX and Linux operating systems, the djxlink bind command will be launched automatically when the database is reconnected or when applications are restarted.

In some cases, you may specify different force options to continue the fix pack installation, for example, when not all DBMs are stopped, or DB2 libraries remain loaded. installFixPack will continue, but you may need to manually update the instances and DAS, as well as restart the applications.

For a partitioned database environment instance, install the fix pack on all the nodes, while the instance update is only needed on the instance owning node. To keep the instance fully functional after the update, it is recommended to install all the products and features on all the nodes, at least on the instance owning node.

Authorization

Root installations require root user authority. For non-root installations, you must log on with the user ID that owns the non-root installation.

Required Connection

None

Command syntax

>>-installFixPack--+--------------------------------------------------+-->
                   |                        (1)                       |   
                   +- -b--base-install-path---------------------------+   
                   +- -c--image-location------------------------------+   
                   +- -b--base-install-path-- -c--image-location------+   
                   '- -n-- -b--base-install-path-- -c--image-location-'   

>--+--------------------------------+--+---------------+-------->
   '- -f--+-level-----------------+-'  '- -l--log-file-'   
          +-db2lib----------------+                        
          +-NOTSAMP---------------+                        
          +-+-install-----------+-+                        
          | +-update------------+ |                        
          | '-ha_standby_ignore-' |                        
          +-noWPAR----------------+                        
          '-nobackup--------------'                        

>--+-----------------+--+-----+--------------------------------><
   '- -t--trace-file-'  +- -h-+   
                        '- -?-'   

1. If you omit this option, you will be prompted for the required information without an error message halt.

Command parameters

-n

Specifies non-interactive mode. When specified, you must also specify -b, and/or -c. This mode can be used for applications to provide all the required information at the command line in an unattended mode.

-b base-install-path

Specifies the path where the DB2 database product will be installed. Mandatory when -n is specified. The length of the path is limited to 128 characters and is a full path name.

The -b option is not required for a non-root installation of DB2, but it is still mandatory for a root installation. If -b is used in a non-root install, the value of base-install-path must be the user's HOME/sqllib directory, or else the path is considered invalid. If -b is not provided in a non-root install, the DB2 installer will use the user's HOME/sqllib as the install path and continue. But, if -b is used and the provided install path has a DB2 copy installed by a root user, the path is considered invalid since the DB2 copy can only be updated by the user who installed it.

-c NLPACK_location

Specifies the location of the related DB2 National Language Pack (NLPACK). This parameter is mandatory when -n is specified. The DB2 NLPACK location needs to be provided explicitly if all of the following conditions are met:

• The -n option is specified.
• The installation requires National Language (non-English) support.
• The DB2 NLPACK is neither on the DB2 DVD nor in the same subdirectory as the DB2 database product being installed.

-f

Force option. -f with no argument is not supported. The force arguments below can be combined. For example, -f level -f db2lib.

-f level

Force a down level or same level fix pack install. If the fix pack image is at a higher level than the installed DB2 database product, this option is ignored.

-f db2lib

Force installFixPack to bypass the checking on DB2 library loading. To ensure that the instances or applications work properly after the installation, the DBM must be stopped for all the related instances (including all nodes for the related partitioned database environment instances), and all DB2 libraries related to the installation path must be unloaded.

-f NOTSAMP

Specifies that the SA MP should not be updated (applicable only to root installation).

-f install

Force the installFixPack command to bypass all checking on DB2 library loading and checking that the instance and DAS are stopped. To ensure that the instances or applications work properly after the installation, the DBM must be stopped for all the related instances (including all nodes for the related partitioned database environment instances), and all DB2 libraries related to the installation path must be unloaded. If this option is specified, neither the instance nor DAS are updated. After the installation, you need to manually update the instance and DAS. Also, note that the options update, install, and ha_standby_ignore are mutually exclusive and cannot be specified in the same installation.

-f update

Force the installFixPack command to bypass all the checking on DB2 library loading, and checking that the instance and DAS are stopped. To ensure that the instances or applications work properly after the installation, the DBM must be stopped for all the related instances (including all nodes for the related partitioned database environment instances), and all DB2 libraries related to the installation path must be unloaded. If this option is specified, both the instance and DAS are updated. Also, note that the options update, install, and ha_standby_ignore are mutually exclusive and cannot be specified in the same installation.

-f ha_standby_ignore

This parameter ignores the check for the sqllib directory by forcing the installFixPack command to bypass this check. For example, the check for sqllib directory is ignored in a clustered environment where the standby node does not have the sqllib library mounted. To ensure that the instances or applications work properly after the installation, the DBM must be stopped for all the related instances (including all nodes for the related partitioned database environment instances), and all DB2 libraries related to the installation path must be unloaded. If this option is specified, neither the instance nor DAS are updated. After the installation, you need to manually update the instance and DAS. Also, note that the options update, install, and ha_standby_ignore are mutually exclusive and cannot be specified in the same installation.

-f noWPAR

Applicable to AIX® 6.1 or later in a global environment. Force installFixPack not to do any checking or any actions on the AIX system workload partitions (WPARs) which share the DB2 copy being updated on the global environment. If -f noWPAR is specified, you must manually update the instances and DAS on each system WPAR that shares this DB2 copy.

-f nobackup

Force installFixPack to not backup installation files when the components are updated. If you choose not to backup the files, the space requirement of the installation directory is reduced. However, choosing not to backup the files also means that if any errors occur, the DB2 installer will not be able to perform a rollback operation. In this case, you will need to manually clean up the files and reinstall the fix pack.

-l log-file

Specifies the log file. For root installations, the default log file is /tmp/installFixPack.log$$, where $$ represents the process ID. For non-root installations, the default log file is /tmp/installFixPack_userID.log, where userID represents the user ID that owns the non-root installation. If the IBM® Tivoli® System Automation for Multiplatforms (SA MP) is being installed or updated with the installFixPack command, the corresponding log file will be located in the same directory as DB2 log files.

-t trace-file

Turns on the debug mode. The debug information is written to the file name specified.

-h | -?

Displays help information.

Usage notes