[V5.1.1 and later]updateWizard examples for cumulative fixes and fix packs

The updateWizard command starts the Update installer wizard. This topic describes using the wizard to work with cumulative fixes and fix packs.

The update installer program installs interim fixes, cumulative fixes, and fix packs to WebSphere Application Server products. See updateWizard examples for interim fixes for information about using the Update installer wizard to install interim fixes.

The relationship among interim fixes, cumulative fixes, and fix packs is shown in the Cumulative Fix Strategy for WebSphere Application Server V5.0 and V5.1 Web page.

Syntax for starting the wizard

The updateWizard command (install_root/update/updateWizard.sh and install_root\update\updateWizard.bat) launches the wizard interface to the update installer application. 

install_root/update/updateWizard.sh  (Linux and UNIX-based platforms)

install_root\update\updateWizard.bat (Windows platforms)

Syntax for displaying usage information

This command displays command syntax:

updateWizard -usage

Panel descriptions

Panels in the wizard let you select installable interim fixes, cumulative fixes, and fix packs, view installed interim fixes, cumulative fixes, and fix packs, and view prerequisite fixes:

Welcome panel

Use this panel to view a welcome message that contains a brief summary of the update wizard interface, or to link to the Target can be accessed only when this topic is linked to the World Wide Web   WebSphere Application Server Support page . (This link is not available on some UNIX-based platforms.) You can also view relevant legal notices.

Product selection panel

Use this panel to select an installed WebSphere Application Server product. If the wizard cannot detect an installed product, specify the product location in the directory input field. After selecting a product, its directory location appears in the input field for verification purposes. To make corrections or enter another product location, click Specify product location.

Menu panel

Use this panel to install or uninstall cumulative fixes and fix packs.

Cumulative fix and fix pack repository specifier panel

Use this panel to provide the cumulative fix and fix pack repository location in a directory input field. The location should point to the directory where you unpacked downloaded fix pack JAR files. The default location for the repository is the install_root/update/fixpacks directory.

Cumulative fix and fix pack selection panel

Use this panel to select from a list of installable cumulative fixes and fix packs. The panel displays fix packs by ID name, with a radio button next to each for selecting a single cumulative fix or fix pack. Also displayed is the build date and current applied state (uninstalled or partially-installed) for each cumulative fix or fix pack. A cumulative fix or fix pack on this panel can be in a partially installed state. No installed cumulative fixes or fix packs appear in the list. Click Details for more information about a selected cumulative fix or fix pack. The window that appears contains build version information, a long description, installation prerequisites, and a list of included fixes.

About installation status

An interim fix, a cumulative fix, or a fix pack is a collection of updates to one or more product components. Depending on installed product components and on update installer program selections you make, the update installer program applies either a full or partial set of interim fix, cumulative fix, or fix pack updates to product components.

Installed status implies that the interim fix, cumulative fix, or fix pack has no more updates to product components that you can install.

Partially installed status implies that you have updated one or more product components, but the interim fix, cumulative fix, or fix pack has at least one more update that you can apply to an installed product component. (Updates to product components that you never installed do not count in the status determination.)

Uninstalled status implies that you have not updated a single product component.

Examples of partially installed states: Several scenarios can lead to a partial installation of an interim fix, a cumulative fix, or a fix pack:

How to distinguish between a normal partially installed state and an installation failure

A partially installed state implies that some components on the system are at the level of the cumulative fix or fix pack being applied because the cumulative fix or fix pack updated them. However, there might be some scenarios where the update installer program can report a partially installed state even if no components are at the level of the cumulative fix or fix pack. A partially installed state does not imply a failed install. However, a failed install does result in a partially installed state.

To check for a failed install, open the master log file and search for errors. The update installer program outputs the name of the master log file at the start of the installation process. The file name matches this pattern: install_root/logs/update/time-stamp_was50_fpnumber_platform_selective-install.log

Cumulative fix or fix pack features selection panel

Use this panel to view a list of WebSphere Application Server features with optionally installable service in the selected cumulative fix or fix pack. Features that can appear include the IBM HTTP Server feature and the embedded messaging feature, which is based on IBM WebSphere MQ technology. If a feature has required service, the feature appears in the list but is grayed out. If you do not install optional service for an installed feature, the cumulative fix or fix pack installs successfully as a partially installed fix pack, because there is service that you did not install.

Important: Cumulative fixes and fix packs do not include service for the IBM HTTP Server powered by Apache 2.0. If you installed IBM HTTP Server powered by Apache 2.0, skip applying service to the IBM HTTP Server during the installation of a cumulative fix or a fix pack. Do not update the 2.0 level IBM HTTP Server with service for the 1.3 level IBM HTTP Server.

If you installed the IBM HTTP Server powered by Apache 1.3 product as a feature, use the update installer program to update it with service in a cumulative fix or a fix pack. You can install interim fixes from the IBM Support site for IBM HTTP Server. Otherwise, you must download an updated IBM HTTP Server product from http://www-3.ibm.com/software/webservers/httpservers/ and install it into the same directory as your existing version to update the existing installation. You can also uninstall the current version and install the downloaded version, to avoid any issues with migration.

You must update your configuration if you reinstall. The process is described in the Manually configuring supported Web servers (tins_manualWebServer) topic in the base Application Server information center.

Always apply any outstanding corrective service to the stand-alone IBM WebSphere MQ product if you have it, before using the WebSphere Application Server update installer program to update the embedded messaging feature with service in an interim fix, a cumulative fix, or a fix pack. Do not select the installation of service to the embedded messaging feature if install corrective service to the stand-alone IBM WebSphere MQ product.

Pre-installing summary and Pre-uninstalling summary panels

Pre-installing summary panel Use this panel to display a summary of the cumulative fix or fix pack selected for installation, the WebSphere Application Server product that is the target for the cumulative fix or fix pack, and the directory where the cumulative fix or fix pack is located.

Pre-uninstalling summary panel Use this panel to display a summary of the cumulative fix or fix pack that you are uninstalling, the WebSphere Application Server product to which the cumulative fix or fix pack was applied, and the directory where the cumulative fix or fix pack is located.

Installing and Uninstalling panel

Installing action Use this panel to view the progress of installing the selected cumulative fix or fix pack. Click cancel to revert the installation. Once cancelled, a message confirms that the cumulative fix or fix pack is being rolled back. A similar progress panel then appears, to monitor the progress of rolling back the installation of the selected cumulative fix or fix pack.

Uninstalling action Use this panel to view the progress of uninstalling the selected cumulative fix or fix pack. There is no way to cancel the uninstall action.

[V5.1.1 and later]You must uninstall all cumulative fix or fix pack before uninstalling the base WebSphere Application Server product, the Network Deployment product, or the WebSphere Business Integration Server Foundation product.

Post installation summary and Post uninstalling summary panels

Post installation summary panel Use this panel to view the results of the installation. Depending on the result, this panel can display a success message, a failure message, or a canceled message. When the success message appears, the installation process is complete. Click Finish to exit the panel. You can go back and install another cumulative fix or fix pack, which takes you to the Menu panel.

Post uninstalling summary panel Use this panel to view the results of the uninstall action. Depending on the result, this panel can display a success message, a failure message, or a canceled message. When the success message appears, the uninstall process is complete. Click Finish to exit the panel. You can go back and uninstall another cumulative fix or fix pack. Going back takes you to the Menu panel.

Related reference
updateWizard command
updateSilent examples for cumulative fixes and fix packs