How To
Summary
These instructions assist administrators in upgrading the version of WebSphere Liberty that is embedded within the Engineering Lifecycle Management applications.
Environment
These instructions apply to ELM versions 7.0.2 and higher.
Note: Since Jazz Authorization Server (JAS) uses a different installation method, the following upgrade process does not work for JAS.
Users must use this technote instead.
How to check the Liberty version:
You can use the command "productInfo version" to show the product name, version, and edition. It can be entered from the install root bin directory, for example:
Windows:
C:\ELM\server\liberty\wlp\bin\productInfo version
Linux/Unix:
/opt/IBM/JazzTeamServer/server/liberty/wlp/bin/productInfo version
Steps
- If you are upgrading to a version of Liberty that is newer than the version listed in the IBM Software Compatibility Reports, IBM recommends performing these steps in a test environment before upgrading production systems.
The latest tested version is 24.0.0.6.
- Locate and download the wlp-core-all-<version>.jar file from Fix Central
- Open Fix Central: https://www.ibm.com/support/fixcentral
- In the “Product Selector” field, enter “WebSphere Liberty”
- For “Installed Version”, select “ALL”
- For “Platform”, select “ALL”
- Click “Continue”
- Select “Browse for fixes”, click “Continue”
- After the page loads fully, there will be a “Search” box that appears in the upper right near the “Release Date” column. In this field, enter the version number you are looking for (example: 24.0.0.6) followed by a space and then the word “jar” to narrow down the selections.
- In the shortened list, you can find an entry for wlp-core-all-24.0.0.6 (or which ever specific version you searched for). Download this file
- Transfer the file to your server
- Create a temporary location (example: Linux®: /tmp/liberty_update; Windows®: c:\temp\liberty_update)
- Execute the JAR file with the command
-
java -jar wlp-core-all-24.0.0.6.jar
*If you receive an error message executing Java™ commands, your JAVA_HOME environmental variable might not be set.
-
- Accept the license agreements
- Hit enter to continue to use the targeted temporary folder that you created in Step 3 to “install” Liberty into.
- Change directory to the JAZZ_HOME/server directory
- Shut down the Liberty server
- Linux® Example:
./server.shutdown.sh
- Windows® Example:
./server.shutdown.bat
- Linux® Example:
- Change directory to the “liberty” directory.
- Move the existing “wlp” directory to a new name
- Linux® Example:
mv wlp wlp-20.0.0.6
- Windows® Example
move wlp wlp-20.0.0.6
- Linux® Example:
- Move the new Liberty version directory
- Linux® Example:
mv /tmp/liberty_update/wlp wlp-24.0.0.6
- Windows® Example:
move c:\temp\liberty_update\wlp wlp
- Linux® Example:
- [Linux® Only] Create a link from the new Liberty version to wlp
- Example:
ln -s wlp-24.0.0.6 wlp
- Example:
- Change directory to the JAZZ_HOME/server/liberty/servers directory
- Delete the “.classCache” directory located here.
- Linux® Example:
rm -rf .classCache
- Windows® Example:
-
rmdir /s .classCache
- Linux® Example:
- Change directory to the clm profile directory
- Delete the “workarea” directory here
- Linux® Example:
rm -rf workarea
- Windows® Example:
rmdir /s workarea
- Linux® Example:
- Change directory to the JAZZ_HOME/server directory
- Start the server
- Linux® Example:
./server.startup.sh
- Windows® Example:
./server.startup.bat
- Linux® Example:
- Check the log files in JAZZ_HOME/server/logs for proper startup
- Repeat all steps for each application server
Document Location
Worldwide
[{"Type":"MASTER","Line of Business":{"code":"LOB59","label":"Sustainability Software"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSPRJQ","label":"IBM Engineering Lifecycle Management Base"},"ARM Category":[{"code":"a8m0z000000Gn1nAAC","label":"ELM-\u003ESystem Requirements"}],"ARM Case Number":"TS013582820","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.0.2;7.0.3;and future releases"}]
Was this topic helpful?
Document Information
Modified date:
22 August 2024
UID
ibm16340315