Before using this information, be sure to read the general information under Appendix A. Notices.
Your feedback is important in helping to provide the most accurate and highest quality information.
Be sure to include the document name and number, the WebSphere Application Server version you are using, and, if applicable, the specific page, table, or figure number on which you are commenting.
When you send information to IBM, you grant IBM a nonexclusive right to use or distribute the information in any way it believes appropriate without incurring any obligation to you.
This topic describes how to use the IBM Update Installer for WebSphere Software to install interim fixes, fix packs, and refresh packs. The Update Installer for WebSphere Software is also known as the update installer program, the UpdateInstaller program, and the Update installation wizard.
Use the proper authorizations to successfully install product updates. 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 following descriptions contain reference information about installing interim fixes, fix packs, and refresh packs on WebSphere Application Server products:
Maintenance packages do not update existing profiles.
Apply the same maintenance packages to all of the WebSphere Application Server 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.
The following procedure describes how to install a maintenance package. See Uninstalling service for a description of how to remove a maintenance package.
You have very likely already installed the software that you are now updating. But if not, install the software now.
The zip file for a refresh pack or fix pack contains the update installer and the the maintenance package.
For example, download the refresh pack or fix pack to one of the following directories in a Version 6 environment:
For example, download the Update Installer to one of the following directories in a Version 6 environment:
Use the jar command from Qshell to extract the contents of the ZIP file as follows:
You may also use WinZip or some other zip utility to unpack the ZIP file to your iSeries server from a mapped driver.
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.
Before installing or uninstalling interim fixes, fix packs, and refresh packs on a machine, stop all Java processes on the machine that use the WebSphere Application Server product.
WebSphere Application Server processes include:
See the following documentation for more information, Stop the WebSphere Application Server environment.
The official statement of supported hardware and software is on the IBM WebSphere Application Server supported hardware and software Web site, at http://www.ibm.com/software/webservers /appserv/doc/latest/prereq.html.
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.
This topic describes the response file for installing service using the Update Installer for WebSphere Software.
Install an update silently using the options response file.
The install.txt file has one directive that identifies the backup file for installing a service update. Comments in the file describe how to set the string value.
The following command uses a copy of the options file named myresponsefile.txt for a silent installation:
./update -options "responsefiles/myresponsefile.txt"
The sample options response file is named install.txt. The file is in the install_root/updateinstaller/responsefiles directory after you unzip the Update Installer for WebSphere Software into the installation root directory of the WebSphere software product.
The options file supplies the values to the Update installer wizard when installing silently. The following command uses a copy of the options file named myresponsefile.txt for a silent installation:
update -options "myresponsefile.txt"
In a silent installation, response file validation is coded into the installation. If the validation does not pass, the failure is recorded in the log files in the install_root/logs/update/tmp directory.
/QIBM/ProdData/WebSphere/AppServer/V6/Base/updateinstaller/maintenance/PQ20029.pak
Although applying maintenance to another product is possible, always use the Update installer wizard within the directory structure of the product that you are updating. Do not use this directive unless absolutely necessary.
/QIBM/ProdData/WebSphere/AppServer/V6/ND
Edit the version of the file that is included in the Update Installer for WebSphere Software ZIP file. The following example is not guaranteed to be an accurate representation of the actual file.
################################################################################ # # This is the silent install response file for installing maintenance packages # using the update installer. # # A common use of an options file is to run the wizard in silent mode. This lets # the options file author specify wizard settings without having to run the # wizard in graphical or console mode. To use this options file for silent mode # execution, *uncomment* and modify the parameters defined within. # # Use the following command line when running the wizard from the update # installer directory: # # update -options responsefiles/install.txt -silent # ################################################################################ ################################################################################ # # Used to input the maintenance package full filename specification to be installed. # Edit as appropriate. # # ie. -W maintenance.package="C:\Program Files\WebSphere\AppServer\ # updateinstaller\maintenance\PQ20029.pak" # # Note: If no package is specified, a default of the last downloaded maintenance # package will be used (based on timestamp). # #-W maintenance.package= ################################################################################ # # Used to modify the product install location that will be updated. # This value should be left commented out if the Update Installer is # being run from the recommended location # # ie. -W product.location="C:\Program Files\WebSphere\AppServer" # # Note: If no location is specified, the parent directory to update installer # will be used as default # #-W product.location="" ################################################################################ # # Do not edit these values. # # -W update.type="install"
This topic describes how to use the Update Installer for WebSphere Software to uninstall interim fixes, fix packs, and refresh packs. The Update Installer for WebSphere Software is also known as the update installer program, the updateInstaller program, and the Update installation wizard.
Use the proper authorizations to successfully uninstall product updates. 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.
The following descriptions contain reference information about uninstalling interim fixes, fix packs, and refresh packs on WebSphere Application Server products:
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.
The following procedure describes how to uninstall a maintenance package.
For example, change directories to one of the following directories in a Version 6 environment:
Before installing or uninstalling interim fixes, fix packs, and refresh packs on a machine, stop all Java processes on the machine that use the WebSphere Application Server product.
WebSphere Application Server processes include:
See the following documentation for more information, Stop the WebSphere Application Server environment.
Uninstall the interim fix on each application server node in a cell before uninstalling the maintenance package from the deployment manager node.
Issue one of the following commands to use the silent interface:
Command example | Type of installation | Description |
---|---|---|
update -W update.type="uninstall" | Silent mode | Uninstalls the maintenance package with the most recent date stamp and time stamp to update the software that is installed in the parent directory. |
update -W product.location="/QIBM/ProdData/WebSphere/AppServer/V6/Base" -W update.type="uninstall" | Silent mode | Overrides the default location of the WebSphere software to update. The default maintenance package to uninstall is the most recently installed maintenance package for that software. |
update -W backup.package="PQ20029.pak" -W update.type="uninstall" | Silent mode | Overrides the interim fix field with the name of the maintenance package to uninstall. |
update -W product.location="/QIBM/ProdData/WebSphere/AppServer/V6/ND" -W backup.package="PQ20029.pak" -W update.type="uninstall" | Silent mode | Overrides the location of the WebSphere software to update and the name of the maintenance package to uninstall. |
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 installed package with the most recent date stamp and time stamp. The default software is the software installed in the parent directory. |
This procedure results in uninstalling maintenance packages to update WebSphere software.
After uninstalling maintenance packages, you can continue to use the WebSphere software.
This topic describes the response file for uninstalling service using the Update Installer for WebSphere Software.
Uninstall an update silently using the options response file.
The uninstall.txt file has one directive that identifies the backup file for uninstalling a service update. Comments in the file describe how to set the string value.
The following command uses a copy of the options file named myresponsefile.txt for a silent uninstall:
./update -options "responsefiles/myresponsefile.txt"
The sample options response file is named uninstall.txt. The file is in the install_root/updateinstaller/responsefiles directory after you unzip the Update Installer for WebSphere Software into the installation root directory of the WebSphere software product.
The options file supplies the values to the Update installer wizard when uninstalling silently. The following command uses a copy of the options file named myresponsefile.txt for a silent uninstall:
update -options "myresponsefile.txt"
In a silent uninstall, response file validation has been coded into the installation. If the validation does not pass, the failure is recorded in the log files in the install_root/logs/update/tmp directory.
install_root/properties/version/update/backup/maintenance_package_to_uninstall
Although uninstalling maintenance from another product is possible, always use the Update installer wizard from the directory structure of the product that you are updating. Do not use this directive unless absolutely necessary.
/QIBM/ProdData/WebSphere/AppServer/V6/ND
Edit the version of the file that is included in the Update Installer for WebSphere Software ZIP file. The following example is not guaranteed to be an accurate representation of the actual file.
################################################################################ # # This is the silent install response file for uninstalling maintenance packages # using the update installer. # # A common use of an options file is to run the wizard in silent mode. This lets # the options file author specify wizard settings without having to run the # wizard in graphical or console mode. To use this options file for silent mode # execution, *uncomment* and modify the parameters defined within. # # Use the following command line when running the wizard from the update # installer directory: # # update -options responsefiles/uninstall.txt -silent # ################################################################################ ################################################################################ # # Used to input the maintenance backup package filename to be uninstalled. # This is the same filename as the package that was originally installed. # A maintenance package can only be uninstalled if a backup package exists. # # ie. -W backup.package="PQ20029.pak" # # Note: If no package is specified, a default of the last installed maintenance # package will be used. # #-W backup.package="" ################################################################################ # # Used to modify the product install location that will be updated. # This value should be left commented out if the Update Installer is # being run from the recommended location # # ie. -W product.location="C:\Program Files\WebSphere\AppServer" # # Note: If no location is specified, the parent directory to update installer # will be used as default # #-W product.location="" ################################################################################ # # Do not edit these values. # -W update.type="uninstall"
The following sections describe logging that occurs when installing and uninstalling service.
If no installation log file exists, refer to the temporary log file in the install_root/logs/update/tmp directory. If all validations pass, the installation occurs.
Then the update installer program creates the install_root/logs/update/maintenance_package.install directory.
Within the directory are the updatelog.txt file, the compressed updatetrace.log.gz file, and the compressed updateconfig.log.gz file. The updateconfig.log.gz file exists only when the installation of service uses the internal configuration manager utility to run ANT scripts.
If no log file exists after uninstalling an interim fix, refer to the temporary log file in the install_root/logs/update/tmp directory. If all validations pass, the uninstall procedure occurs.
Then the update installer program creates the install_root/logs/update/maintenance_package.uninstall directory.
Within the directory are the updatelog.txt file, the compressed updatetrace.log.gz file, and the compressed updateconfig.log.gz file. The updateconfig.log.gz file exists only when the removal of service uses the internal configuration manager utility to run ANT scripts.
The log file includes an indicator of success:
This topic describes known problems and issues associated with the Update Installer for WebSphere Software program.
The update installer program version information is stored in the version.txt file in the updateinstaller directory.
A new version might ship to correspond to any new fix. Information in the version.txt file is recorded in the updatelog.txt file.
Always download and use the latest version of the Update installer wizard when installing an interim fix.
The following table describes known problems and when the problems were resolved. See the Workarounds section that follows the table for more information.
Description of problem | Workaround | Version with resolution |
---|---|---|
Product uninstall does not remove the updated product correctly. | Product uninstall | Current problem |
The following section describes workarounds for current problems.
Problem: The product uninstaller for Version 6.0.x.x cannot delete all files and directories that exist after installing a refresh pack or a fix pack.
Description: If you apply a refresh pack or a fix pack using the update installer program and then uninstall the whole product using the Version 6.0.0.0 product uninstaller program, many files are left on the system.
Cause: The product uninstaller program will be fixed in a later release.
Customer action: Two workarounds exist. Use either of the following workarounds to circumvent the problem:
References in this publication to IBM products, programs, or services do not imply that IBM intends to make these available in all countries in which IBM operates. Any reference to an IBM product, program, or service is not intended to state or imply that only IBM's product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any of IBM's intellectual property rights may be used instead of the IBM product, program, or service. Evaluation and verification of operation in conjunction with other products, except those expressly designated by IBM, is the user's responsibility.
IBM may have patents or pending patent applications covering subject matter in this document. The furnishing of this document does not give you any license to these patents. You can send license inquiries, in writing, to:
For trademark attribution, visit the IBM Terms of Use Web site (http://www.ibm.com/legal/us/).