Upgrading Liberty in IBM Engineering Lifecycle Management Jazz Authorization Server

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.

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: 23.0.0.12) 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-23.0.0.12 (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-23.0.0.12.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.

• 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.