Applying an interim fix to a Liberty archive installation
Liberty offers archive-based installation as an alternative to using IBM® Installation Manager. If you installed Liberty using a self-extracting Java archive (JAR) file or a ZIP archive file 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 Liberty, you must use Installation Manager to apply an interim fix.
An archive-based interim fix is named <Liberty
level>-WS-WASProd_WLPArchive-<fix type><fix
id>.jar
- <Liberty level> refers to a 4-digit fix pack level identifier, which indicates the minimum level to which the fix applies. For example, 16.0.0.2.
- <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 a GitHub issue number or the APAR reference number.
Starting in 17.0.0.3, some of the Liberty code is based on Open Liberty, the open source runtime environment. If the fix
is in Open Liberty code, the <fix id> is in the format
OLGH<issue number>
. For example,OLGH142
refers to an interim fix for issue #142 in the Open Liberty GitHub repository. Otherwise, the <fix id> is the APAR reference number, such as PI87599. 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 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.