Installing a patch

To install a patch, run the patch installer from a command line.

About this task

On Windows systems, the command for running the patch installer has the general format:

product_name-patch_name-win32.exe [parameter=value ...]

On UNIX systems, the command for running the patch installer has the general format:

product_name-patch_name-platform.run [parameter=value ...]

The patch installer supports a number of command-line parameters, as listed in Table 1.

Table 1. Patch installer command-line parameters 

Parameter

Value

Description

installdir

string

Specifies the installation directory of the product that you wish to patch. If the directory or filename contains space characters, enclose the entire string in double-quote characters (").

If you do not specify this parameter, the patch installer attempts to detect the installation automatically.

force

y | n

Selects whether to force the patch onto the installation:

y - Forces patch installation. No version verification is performed.

n - Does not force patch installation. Version verification is performed before installing the patch.

Default - n

Note: Using this parameter is not recommended unless you have been advised by IBM support to do so.

silent

y | n

Selects silent patch mode:

y - Installs the patch in silent mode. The installer does not display any output during patch installation; however, it still provides a return code (0 indicates success).

n - Installs the patch in interactive mode, prompting you for any required installation parameters not supplied in the command-line, and displaying output to the console.

Default - n

backup

y | n

Selects whether a backup of the existing components is performed before installing the patch:

y - Backs up existing components prior to installing the patch. This enables the patch to be removed at a later date.

n - No backup is made. Using this option prevents you from removing the patch later but it saves disk space.

Default - y

listcomponents

n/a

Instructs the installer to list details about each component in the patch. Running the installer with this parameter does not install the patch.

-l

string

Specifies the location and name of the log file in which the patch installer logs details about the installation. If the directory or filename contains space characters, enclose the entire string in double-quote characters ("). If you do not specify this parameter, the patch installer logs the details to the file patch.log, located in the log directory of the installation.

For example, the following command installs a patch to the Netcool/SSM installation located in the directory c:\Program Files\netcool on a Windows system. It uses silent mode, backs up the installed components, and logs details about the installation process in the file c:\temp\patch_ssm.log:

ssm400-cpupatch-win32.exe installdir="c:\Program Files\netcool" silent=y backup=y 
-l"c:\temp\patch_ssm.log"
Note: If the target installation is running when you install a patch, the patch installer stops the installation then restarts it again when patch installation is complete.