Applying an interim fix to a Liberty profile archive installation

The Liberty profile offers a self-extracting archive-based installation as an alternative to using IBM® Installation Manager. If you installed the Liberty profile using the self-extracting archive, and want to install an interim fix, you can apply an executable JAR file.

About this task

If you used IBM Installation Manager to install the Liberty profile, you must use Installation Manager to apply an interim fix.

An archive-based interim fix is named <Liberty profile level>-WS-WASProd_WLPArchive-<fix type><fix id>.jar
  • <Liberty profile level> refers to a 4-digit fix pack level identifier, which indicates the minimum level to which the fix applies. For example, 8.5.5.0.
  • <fix type> refers to the type of fix. For example, IF is used for an interim fix, and TF for a diagnostic fix
  • <fix id> refers to the APAR reference number. If a diagnostic fix is provided before an APAR is opened, the <fix id> is based on the PMR reference number.

Each interim fix is installed by executing the relevant JAR file, which extracts the content into the Liberty profile base folder (/wlp).

Note: When the interim fix is applied, no backup data is created. If you want to back out an interim fix, you must manually remove or restore files from the /wlp folder.
Each interim fix is provided with a readme.txt file, which contains backup and restore instructions specific to the fix content, in a section titled Directions to apply fix. If the readme.txt file does not specify any requirement to back up files, you can extract the fix and then restart the server at any time with the --clean parameter as a launch option.

Procedure

  1. Optional: If the fix contains files that will overwrite existing files, stop all servers that are running on the system.
  2. Optional: If the readme.txt file indicates that a backup is required, create a backup of the lib/features/component.mf files. File locations are relative to your Liberty profile installation root.
  3. Open a console and direct it to the location of your interim fix JAR file.
  4. To view available options, run java -jar interim_fix_jar_file -help, where interim_fix_jar_file is the name of the executable JAR file that contains the interim fix. The following launch options are available for the JAR file:
    --installLocation [LibertyRootDir]
    The absolute or relative location of the Liberty profile installation directory.
    By default the JAR file looks for a wlp directory in its current location. If your Liberty profile installation location is not the wlp folder, or is not in the same directory as the JAR file, then you can use this option to change where the JAR file will patch. [LibertyRootDir] can either be relative to the location of the JAR file, or an absolute file path.
    --suppressInfo
    The only messages output from the JAR file will be error messages or confirmation that patching is complete.
  5. Run the JAR file, using the --installLocation option to specify the installation location. For example, java -jar interim_fix_jar_file --installLocation. Optionally include --suppressInfo.
  6. Start all Liberty profile servers with the --clean parameter as a launch option. For example, server start --clean. You use the --clean option only once; all subsequent server starts do not require it.

Icon that indicates the type of topic Task topic

Terms and conditions for information centers | Feedback


Timestamp icon Last updated: Monday, 21 April 2014
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-express-iseries&topic=twlp_inst_interimfix
File name: twlp_inst_interimfix.html