[Version 5.0.2 and later]updateWizard examples for interim fixes

The updateWizard command starts the Update installer wizard. This topic describes using the wizard to work with interim fixes.

The update installer program installs interim fixes, cumulative fixes, and fix packs to WebSphere Application Server products.

Installing interim fixes for features that are products

Three different Web sites contain interim fixes for WebSphere Application Server products and features. Three sites exist because two of the features of the base product have their own service and support sites.

You cannot install or uninstall interim fixes for either of the two features using the update installer program for WebSphere Application Server. See the following tips for more information:

Installation tip

Operating platform Tip in Platform-specific tips for installing and migrating
All platforms



You must use the update installer program to install cumulative fixes and fix packs for the two features. See updateWizard examples for cumulative fixes and fix packs for information about using the update installer program to install cumulative fixes and fix packs.

Parameters

Apply zero, one, or more of these optional parameters in any order, by issuing the updateWizard command from the command line.

-dpInstall
Lets you install an interim fix when there are prerequisite check errors.

The default behavior of the update installer application prevents further action if prerequisites are missing.

-dpUninstall
Lets you uninstall an interim fix when there are prerequisite check errors.
-fixOnly
Installs or uninstalls only interim fixes. To install and uninstall interim fixes, the updateWizard command does not require a local copy of the IBM Developer Kit or the Java Runtime Environment (JRE) in a client environment. This option bypasses making a local copy of the IBM Developer Kit or the JRE.

The default action for the update installer program enables both installing and uninstalling interim fixes, cumulative fixes, and fix packs. The wizard installs a temporary version of one of the IBM products that WebSphere Application Server uses to support the Java 2 SDK on your operating system platform, such as the IBM Developer Kit for AIX, Java Technology Edition.

The updateWizard command copies the IBM Developer Kit from the JAVA_HOME directory to the directory where you are running the updateWizard command (usually install_root/update). If the IBM Developer Kit is already in the directory (for example, if you used the updateWizard command before), the updateWizard command does not make a new copy. The copy of the IBM Developer Kit remains in the directory until you remove it. The IBM Developer Kit requires approximately 43 MB of free space.

If you install on a client platform, where there is a JRE instead of the IBM Developer Kit, the updateWizard command copies the JRE to the install_root/update directory. The JRE requires about 18 MB of free space.

-usage
Displays a list of parameters and how to use them in the correct command syntax.

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.

Windows systems:

  1. Open a command prompt window.
  2. Change directories to the install_root\bin directory.
  3. Issue the setupCmdLine.bat command.
  4. Change directories to theinstall_root\update directory.
  5. Issue the updateWizard.bat command.

Linux and UNIX systems:

  1. Open a command shell window.
  2. Change directories to the /install_root/bin directory.
  3. Issue the . ./setupCmdLine.sh command. Notice the space between the periods. The special format for this command sources the command to make the setting active for all processes started from the command shell.
  4. Change directories to the/install_root/update directory.
  5. Issue the ./updateWizard.sh command.

Syntax for displaying usage information

This command displays command syntax:


updateWizard -usage

Syntax for bypassing the local copy of the IBM Developer Kit

The following command bypasses making a local copy of the IBM Developer Kit. Installing and uninstalling interim fixes does not require the local copy.

updateWizard -fixOnly

Disabling prerequisite checking

Disabling prerequisite checking is recommended only as directed by IBM Support personnel. Disabling prerequisite checking can leave the installation in a non-valid state.

To disable prerequisite checking when installing interim fixes:

updateWizard -fixOnly -dpInstall

To disable prerequisite checking when uninstalling interim fixes:

updateWizard -fixOnly -dpUninstall

Panel descriptions

Panels in the wizard let you select installable interim fixes, view installed interim fixes, and view prerequisite interim 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 interim fixes, or to install or uninstall cumulative fixes and fix packs. If you started the wizard in -fixOnly mode, cumulative fix and fix pack options are disabled.

Fix repository specifier panel

Use this panel to provide the interim fix repository location in a directory input field. Specify the directory location of the downloaded interim fix JAR files. The default location for the repository is the install_root/update/fixes directory.

Installable fix selection panel

Use this panel to select one or more installable fixes for installing. Installed fixes do not appear in the list. Only uninstalled fixes or partially-installed fixes appear. The list includes interim fix ID name, build date, and the current applied state (uninstalled or partially-installed). Click Details for detailed information about selected fixes. The window that appears contains build version information, a long description, and a list of installation prerequisites.

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. However, there might be some scenarios where the update installer program can report a partially installed state even if no components are at the newer level. 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

Uninstallable fix selection panel

Use this panel to select one or more installed interim fixes for uninstalling. Available fixes do not appear in the list. Only installed fixes appear. The list includes interim fix ID name, build date, and the current applied state (installed). Click Details to obtain more detailed information about a selected fix. The window that appears contains build version information, a long description, and a list of installation prerequisites.

You must uninstall all interim fixes before uninstalling the base WebSphere Application Server product, the Network Deployment product, or the product.

Prerequisite check panel

Use this panel to view prerequisite information when a selected interim fix has prerequisite fixes that are not installed. You cannot click Next until you correct the problem. The -dpInstall and the -dpUninstall parameters can override this lock, to let you continue installing or uninstalling even though a prerequisite checking failure occurs.

Pre-installing and Pre-uninstalling summary panels

Pre-installing summary panel Use this panel to display a summary of interim fixes that are selected for installation, the WebSphere Application Server product each interim fix is for, and the directory where each interim fix is located.

Pre-uninstalling Summary panel Use this panel to display a summary of interim fixes that are selected for uninstalling, and the WebSphere Application Server product to which each interim fix is currently applied.

Installing and Uninstalling panel

Installation action Use this panel to view the progress of installing selected interim fixes. Click cancel to revert the installation. Once cancelled, a message confirms that installed fixes are being rolled back. A similar progress panel then appears, to monitor the progress of rolling back the installation of selected fixes.

Uninstalling action Use this panel to view the progress of uninstalling selected interim fixes.

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 additional fixes, which takes you to the Menu panel.

Post uninstalling summary panel Use this panel to view the results of the uninstall procedure. 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 additional fixes, which takes you to the Menu panel.


Related reference
updateWizard command
updateSilent examples for interim fixes



Searchable topic ID:   uwizifix
Last updated: Jun 21, 2007 4:55:42 PM CDT    WebSphere Application Server Network Deployment, Version 5.0.2
http://publib.boulder.ibm.com/infocenter/wasinfo/index.jsp?topic=/com.ibm.websphere.nd.doc/info/ae/ae/rins_uwizifix.html

Library | Support | Terms of Use | Feedback