How to upgrade the embedded WebSphere Liberty profile installed with IBM License Key Server Administration and Reporting Tool (ART) and Administration Agent

Steps

1. Locate and download the wlp-base-all-<version>.jar file from Fix Central
   1. Open Fix Central: https://www.ibm.com/support/fixcentral
   2. In the “Product Selector” field, enter “WebSphere Liberty”
   3. For “Installed Version”, select “ALL”
   4. For “Platform”, select “ALL”
   5. Click “Continue”
   6. Select “Browse for fixes”, click “Continue”
   7. 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.
   8. In the shortened list, you can find an entry for wlp-base-all-23.0.0.12 (or which ever specific version you searched for).  Download this file
2. Transfer the file to your server
3. Create a temporary location (example: Linux®: /tmp/liberty_update; Windows®: c:\temp\liberty_update)
4. Execute the JAR file with the command

   • java -jar wlp-base-all-23.0.0.12.jar

     *If you receive an error message while executing Java™ commands, your JAVA_HOME environmental variable might not be set.
5. Review and accept the license agreements
6. Hit enter to continue to use the targeted temporary folder that you created in Step 3 to “install” Liberty into.
7. Change directory to the <AGENT_INSTALL_DIR>/ directory
8. Shut down the Liberty server
   1. Linux® Example:

      ./stopICLAgent.sh

   2. Windows® Example: 

      ./stopICLAgent.bat

9. Move the existing “wlp” directory to a new name
   1. Linux® Example:

      mv wlp wlp_old

   2. Windows® Example 

      move wlp wlp_old

10. Copy the new Liberty version directory
    1. Linux® Example:

       cp /tmp/liberty_update/wlp wlp

    2. Windows® Example:

       move c:\temp\liberty_update\wlp wlp

11. Delete the “work” directory here
    1. Linux® Example:

       rm -rf work

    2. Windows® Example: 

       rmdir /s work

12. Change directory to the <AGENT_INSTALL_DIR>/ directory
13. Replace the file <AGENT_INSTALL_DIR>/wlp/etc/server.env with <AGENT_INSTALL_DIR>/wlp_old/etc/server.env
14. Start the server
    1. Linux® Example:

       ./startICLAgent.sh

    2. Windows® Example: 

       ./startICLAgent.bat

15. Check the log files in <AGENT_INSTALL_DIR>/work/iclagent/logs for proper startup
16. Repeat all steps for ART server
17. Change directory to the <ART_INSTALL_DIR>/ directory
18. Shut down the Liberty server
    1. Linux® Example:

       ./stopRCLAdmin.sh

    2. Windows® Example: 

       ./stopRCLAdmin.bat

19. Move the existing “wlp” directory to a new name
    1. Linux® Example:

       mv wlp wlp_old

    2. Windows® Example 

       move wlp wlp_old

20. Move the new Liberty version directory
    1. Linux® Example:

       mv /tmp/liberty_update/wlp wlp

    2. Windows® Example:

       move c:\temp\liberty_update\wlp wlp

21. Delete the “work” directory here
    1. Linux® Example:

       rm -rf work

    2. Windows® Example: 

       rmdir /s work

22. Change directory to the <ART_INSTALL_DIR>/ directory
23. Replace the file <ART_INSTALL_DIR>/wlp/etc/server.env with <ART_INSTALL_DIR>/wlp_old/etc/server.env
24. Start the server
    1. Linux® Example:

       ./stopRCLAdmin.sh

    2. Windows® Example: 

       ./stopRCLAdmin.bat

25. Check the log files in <ART_INSTALL_DIR>/work/rcladmin/logs for proper startup