IBM Support

Upgrading Liberty in IBM Engineering Lifecycle Management Jazz Authorization Server

How To


Summary

As an administrator, I want to upgrade the version of WebSphere Liberty used by the Jazz Authorization Server.

Objective

As an administrator, I need to alleviate security issues that might arise with the Jazz Authorization Server.
If you need to update the Liberty version that is embedded with the ELM application server, see this technote

Environment

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:\IBM\JazzAuthServer\wlp\bin\productInfo version
Linux/Unix:
/opt/IBM/JazzAuthServer/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.9.
  1. 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.9) 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.9 (or which ever specific version you searched for).  Download this file
  2. Transfer the file to JAS_HOME/ directory on your JAS Server
  3. Stop JAS Server
    • navigate to the JAS_HOME/ directory
    • Shut down the JAS server
      • Linux® Example:
      • ./stop-jazz.sh
      • Windows® Example:
      • ./stop-jazz.bat
  4. Backup/Rename the existing “wlp” directory.  You will need this in a later step.
    • Linux® Example:
    • mv wlp wlp-backup
    • Windows® Example:
    • move wlp wlp-backup
  5. Execute the JAR file with the command
    java -jar wlp-core-all-24.0.0.9.jar
    • * If you receive an error message executing Java™ commands, set JAVA_HOME Environment variable and retry.
  6. Accept the License Agreement
  7. Specify "Target directory for product files" to be your JAS_HOME/ directory
    • On success, a new wlp folder is created under JAS_HOME/ directory
  8. Change directory to newly created JAS_HOME/wlp
  9. Delete the usr folder
    • Linux® Example:
    • rm -rf usr
    • Windows® Example:
    • rmdir /s usr
  10. Copy the usr folder from the old wlp_backup created in Step 4. and paste it in the new wlp folder
    • Linux® Example:
    • cp -R /wlp-backup/usr JAS_HOME/wlp/usr
    • Windows® Example:
    • Xcopy /E wlp-backup\usr JAS_HOME\wlp\usr
  11. Change directory to the JAS_HOME/wlp/usr/servers directory
  12. Delete the cache directories
    • Linux® Example:
    • rm -rf .classCache .pid
    • Windows® Example:
    • rmdir /s .classCache .pid
  13. Change directory to the JAS_HOME/wlp/usr/servers/jazzop directory
  14. Delete the Liberty working directories
    • Linux® Example:
    • rm -rf logs tranlog workarea
    • Windows® Example:
    • rmdir /q /s logs tranlog workarea
  15. Change directory to the JAS_HOME directory
  16. Start the server
    • Linux® Example:
    • ./start-jazz.sh
    • Windows® Example:
    • ./start-jazz.bat
  17. Check the console.log file in JAS_HOME/wlp/usr/servers/jazzop/logs for proper startup.
If issues are encountered after upgrade:
  • Contact IBM Support for assistance in resolving the issue
  • If you encounter issues that are not resolvable, you can remove the new versions of the files installed and restore the backup that was created.

Document Location

Worldwide

[{"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":"a8m0z000000CbOuAAK","label":"Jazz Team Server-\u003EJazz Authorization Server"}],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.0.0;and future releases","Type":"SW"}]

Document Information

Modified date:
01 November 2024

UID

ibm16445491