This topic describes how to use the IBM Update Installer for WebSphere Software to install...

• interim fixes
• fix packs
• refresh packs

The Update Installer for WebSphere Software is also known as...

• update installer program
• UpdateInstaller program
• Update installation wizard

Use the update installer program as a user profile with *ALLOBJ special authority.

The Update Installer wizard is an InstallShield for Multiplatforms wizard that runs in silent mode with or without a response file. When you omit the response file in silent mode, the wizard installs the last maintenance package that you downloaded to the default maintenance directory.

The update installer creates a backup file in...

install_root/properties/version/update/backup

IBM does not support user modifications to backup files.

Service in a maintenance package might update the following files...

• JAR files in the lib directory
• Scripts in the bin directory
• Profile templates

Use...

install_root/bin/versionInfo

...to display the exact fix and version level of the product.

Do not use the versionInfo command while installing or uninstalling a maintenance package.

Install a maintenance package

1. Log on as a user profile with *ALLOBJ special authority.

2. Back up any files and subdirectories in...

   install_root/updateinstaller/maintenance

3. Delete...

   install_root/updateinstaller/maintenance

   ...and all of its subdirectories.

4. Download fix *.zip files to...

   /QIBM/ProdData/WebSphere/AppServer/V6/Base

5. For interim fixes only download the update installer from the Support site into the installation root directory.

   For example, download the Update Installer to...

   /QIBM/ProdData/WebSphere/AppServer/V6/Base

6. Unpack the *.zip file...

   
   STRQSH
   cd /QIBM/ProdData/WebSphere/AppServer/V6/Base
   jar -xf filename.zip

   You may also use WinZip or some other zip utility to unpack the *.zip file to your iSeries server from a mapped driver.

7. Unpacking the *.zip file creates the following directory structure:

   install_root
      /updateinstaller       /framework       /lib       /maintenance       /responsefiles
   

   Version information is stored in the version.txt file in the updateinstaller directory.

   Always download and use the latest version of the Update Installer wizard when installing an interim fix.

8. For interim fixes only, download *.pak files into...

   install_root/updateinstaller/maintenance

   Do not attempt to unzip or unpack the *.pak file.

9. Stop all Java processes that use the WAS product.

   WAS processes include:

   • Application server
   • Nodeagent
   • Dmgr

10. Satisfy the following prerequisites...

    • All of the product hardware and software prerequisites exist.

    • The WebSphere software that you are updating is correctly installed and is not corrupt.

    • The user has *ALLOBJ special authority.

11. Stop the QWAS6 subsystem

    ENDSBS QWAS6 *immed

12. Use the update installer to install the maintenance package.

    Install the maintenance package on the deployment manager node before installing the maintenance package on each application server node that you intend to update.

    Issue one of the following commands to use the silent interface:

    Command example	Type of installation	Description
    update	Silent mode	Installs the maintenance package with the most recent time stamp to update the software that is installed in the parent directory.
    update -W prereqsfailedpanelInstallWizardBean.active="false"	Silent mode that bypasses prerequisites checking	Installs the maintenance package with the most recent time stamp to update the software that is installed in the parent directory. Bypasses prerequisites checking.
    update -W maintenance.package="install_root/updateinstaller/maintenance/PQ20029.pak"	Silent mode	By default, the wizard installs the maintenance package with the most recent date stamp and time stamp. Use the package override to install another maintenance package. You do not need a response file. The default software is the software installed in the parent directory.
    update -options "responsefiles/file_name "	Silent mode with an options file	Overrides all default values with values that you specified in the options response file. If you omit either value from the response file, the default maintenance package is the one with the most recent date stamp and time stamp. The default software is the software installed in the parent directory.
    update -W product.location="install_root"	Silent mode	Updates the WebSphere software specified in the command with the maintenance package that has the most recent date stamp and time stamp. The silent installation does not refer to a response file.
    update -W product.location="install_root" -W maintenance.package="install_root/updateinstaller/maintenance/PQ20029.pak"	Silent mode	Updates the WebSphere software specified in the command with the maintenance package specified in the command. The silent installation does not refer to a response file.

This procedure results in installing maintenance packages to update WebSphere software.

After installing a maintenance package, continue to use your WebSphere software.

Update cluster members

Apply the same maintenance packages to all of the WAS installations in a cluster. When all of the cluster members are not at the same service level, the following exception can occur:

DRSCacheApp   E DRSW0008E: 
   Exception is: com.ibm.disthub.impl.jms.JMSWrappedException: 
   {-1361012295|unknown|java.io.OptionalDataException|} 

This error can cause memory replication to not function properly.

Do not launch multiple copies of the Update Installer wizard at one time. Concurrent launches of the update installer program are not supported. Performing more than one update at the same time can produce unpredictable results, which might include a failed or faulty installation.

See Known problems and workarounds for the update command for information about known problems and workarounds.