The updateSilent command is the silent, command-line interface for the update installer program. 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 silent interface to work with 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 examples
The updateSilent interface actually provides two functions. Depending upon the parameters you choose, the command performs the following functions:
The following examples describe various usage syntaxes. In each syntax example, optional parameters are enclosed by brackets ([]). Values that you must supply appear in italicized font. Choices are denoted by the pipe symbol (|).
Before issuing any of the following commands, set the JAVA_HOME environment variable using the following procedure. Then use the same command window to issue the appropriate updateSilent command.
Windows systems:
Linux and UNIX systems:
Help
updateSilent -help | -? | -usage updateSilent /help | /? | -usage (Windows platforms)
Syntax for using a properties file to supply values
updateSilent myProps.properties
Syntax for processing cumulative fixes and fix packs
updateSilent -installDir "fully qualified product install_root" -fixpack -fixpackDir "fully qualified FixPack repository root, usually install_root/update/fixpacks" -install | -uninstall -fixPackID fix pack ID [-skipIHS | [-ihsOnly] -ihsInstallDir fully qualified IBM HTTP Server root] [-skipMQ | -mqInstallDir embedded messaging feature root] [-includeOptional space-delimited list of components] [-fixpackDetails]
All other valid arguments are ignored, such as the prereqOverride argument, which is for interim fix processing only.
You do not need to supply the -mqInstallDir argument for AIX, Linux, and UNIX-based platforms. The install location is fixed on those operating platforms. Use the argument on Windows platforms. The default location on Windows platforms is the C:\Program Files\IBM\WebSphere MQ directory.
Syntax for viewing installed cumulative fixes and fix packs
updateSilent -fixpack -installDir "fully qualified product install_root"
Syntax for viewing available cumulative fixes and fix packs
updateSilent -fixpack -installDir "fully qualified product install_root" -fixpackDir "fully qualified fix pack repository root, usually install_root/update/fixpacks"
Parameters
Use the following parameters for the updateSilent command:
The current Application Server strategy for fix pack JAR files uses one JAR file per fix pack. The fix pack ID is the name of the JAR file before the .jar extension.
For
example:
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.
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.
You can supply parameters in an external .properties file, rather than directly on the command line. There are some differences in the formats of parameters:
A sample.properties file for installing a fix pack might look like the following example:
# WAS502CF5.properties # Param file to install WebSphere AppServer 5.0.2 cumulative fix 5 install=true installDir=C:\\WebSphere\\AppServer fixpack=true fixpackDir=C:\\WebSphere\\AppServer\\update\\fixpacks fixpackID=was502_cf5_win fixpackDetails=true skipIHS=true skipMQ=true
If you installed the IBM HTTP Server product as a feature, use the update installer program to update it with service in an interim fix or fix pack. Otherwise, you must download an updated IBM HTTP Server product from http://www.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 information center for the base Application Server product.
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.
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 or fix pack. You can skip the installation of service to the embedded messaging feature if you must install corrective service to the stand-alone IBM WebSphere MQ product.
Examples overview
The following examples assume that:
Getting help for the command
To get help for the updateSilent command:
C:\WebSphere\AppServer\update> updateSilent -help
Using a parameter properties file
To use the myProps.properties file to supply parameter values for the updateSilent command:
C:\WebSphere\AppServer\update> updateSilent myProps.properties
Installing cumulative fixes and fix packs
To install a fix pack:
C:\WebSphere\AppServer\update> updateSilent -fixpack -installDir "C:\WebSphere\AppServer" -ihsInstallDir "C:\Program Files\IBMHttpServer" -fixpackDir "C:\WebSphere\AppServer\update\fixpacks" -install -fixpackID was510_cf2_win
To install a fix pack, and display fix pack details:
C:\WebSphere\AppServer\update> updateSilent -fixpack -installDir "C:\WebSphere\AppServer" -ihsInstallDir "C:\IBMHttpServer" -fixpackDir "C:\WebSphere\AppServer\update\fixpacks" -install -fixpackID was510_cf2_win -fixpackDetails
To perform a partial installation of a fix pack, by choosing to skip the installation of optional service to the WebSphere Application Server embedded messaging feature, which is based on WebSphere MQ:
C:\WebSphere\AppServer\update> updateSilent -fixpack -installDir "C:\WebSphere\AppServer" -fixpackDir "C:\WebSphere\AppServer\update\fixpacks" -ihsInstallDir "C:\Program Files\IBMHttpServer" -install -fixpackID was510_cf2_win -skipMQThe fix pack status shows partial installation.
About installation status
An interim 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 or fix pack updates to product components.
Installed status implies that the interim 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 or fix pack has at least one more update you can apply to an installed product component. (There might be other updates to product components you never installed. These updates 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 or 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 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
To perform a partial installation of a fix pack by choosing to skip the installation of optional service to the IBM HTTP Server feature:
C:\WebSphere\AppServer\update> updateSilent -fixpack -installDir "C:\WebSphere\AppServer" -fixpackDir "C:\WebSphere\AppServer\update\fixpacks" -mqInstallDir "C:\WebSphere MQ" -install -fixpackID was510_cf2_win -skipIHSThe fix pack status shows partial installation.
To perform a partial installation of a fix pack, by choosing to skip the installation of optional service to both the embedded messaging feature and the IBM HTTP Server feature:
C:\WebSphere\AppServer\update> updateSilent -fixpack -installDir "C:\WebSphere\AppServer" -fixpackDir "C:\WebSphere\AppServer\update\fixpacks" -install -fixpackID was510_cf2_win -skipIHS -skipMQThe fix pack status shows partial installation.
Uninstalling cumulative fixes and fix packs
To uninstall a fix pack:
C:\WebSphere\AppServer\update> updateSilent -fixpack -installDir "C:\WebSphere\AppServer" -uninstall -fixpackID was510_cf2_win
To uninstall a fix pack, and display fix pack details:
C:\WebSphere\AppServer\update> updateSilent -fixpack -installDir "C:\WebSphere\AppServer" -uninstall -fixpackID was510_cf2_win -fixpackDetails
Viewing information about cumulative fixes and fix packs
To view a list of installed fix packs:
C:\WebSphere\AppServer\update> updateSilent -fixpack -installDir "C:\WebSphere\AppServer"
To view a list of fix packs available in the repository for the base WebSphere Application Server product:
C:\WebSphere\AppServer\update> updateSilent -fixpack -installDir "C:\WebSphere\AppServer" -fixpackDir "C:\WebSphere\AppServer\update\fixpacks"