IBM Support

How to update the IBM SDK for Java of Engineering Lifecycle Management products

Question & Answer


Question

How do you update the IBM SDK for Java (JRE) for existing IBM Engineering Lifecycle Management (ELM) applications?

Cause

IBM Engineering Lifecycle Management products based on Jazz technology are shipped with an IBM SDK for Java (JRE) that is based on the Oracle JDK. IBM releases critical patch updates (CPU) based on Oracle CPU updates that contain security vulnerability fixes for the JRE.

Answer

The IBM Engineering Lifecycle Management products based on Jazz technology can be updated with a corrected JRE by following the instructions in this document. Depending on how products are deployed and your usage scenarios, you might need to upgrade the JRE in IBM WebSphere Application Server (WAS), WebSphere Application Server Liberty, Apache Tomcat, and Eclipse. Be sure to upgrade all the components that your deployment uses. If you are referred to this technote from a security bulletin to perform a manual JRE update for a version that is not mentioned in this technote, it is safe to assume that the security bulletin is correct and that you can also apply the procedures in this technote to the JRE versions described in the security bulletin.

There are multiple places where the JRE must be updated. Exact steps depend on what Application Server and what clients you are using. See the flow chart to determine what actions you need to take. Instructions for each action are in the sections that follow. Note: IBM Jazz Team Server can be deployed on either IBM WebSphere Application Server or Apache Tomcat.

To obtain the latest JRE, search in Fix Central for the parent product ("IBM Engineering Lifecycle Management" for recent products and "Rational Collaborative Lifecycle Management" for previous versions), or contact IBM Support to request a fix with the new JRE version for the operating system and platform you are running the IBM Engineering Lifecycle Management Base (ELMB), the IBM Engineering Lifecycle Optimization - Engineering Insights (ENI) application server, CLM Server Monitoring plug-in (CSM), or Jazz Authorization Server (JAS) on. ELM is tested and supported by the IBM JRE that must be obtained from IBM support. Using a JRE downloaded publicly is not supported, unless it was downloaded from Fix Central. Once the JRE is obtained from Fix Central or IBM Support, follow the instructions in this document to replace the existing JRE:

Upgrading the JRE for a WAS installation

If your products are deployed on WAS, Latest fix packs for WebSphere Application Server lists WebSphere upgrades that are available. Check the Product Security Incident Response Blog for any recent security bulletins for WAS that might have fix packs or interim fixes for the JRE, such as IBM Security Bulletin: Multiple vulnerabilities in current IBM SDK for Java for WebSphere Application Server April 2014 CPU.

Upgrading the JRE for a WebSphere Liberty installation

Based on Updating the Liberty Java runtime environment or software development kit

  1. Download the Java either from Fix Central or from IBM SDK Java Technology Edition Version 8.0 for WebSphere Liberty using Archives page.
  2. Stop the server.

    Note: The applications might be running in different application server instances or that use a delegated converter.

  3. Navigate to the original installation directory and rename the JRE folder
    <InstallDir>/server/jre to <InstallDir>/server/jre-Original
    To ensure that the original JRE is kept as a backup if a restore is required.
    Example (Linux): mv <OrigInstallDir>/server/jre <OrigInstallDir>/server/jre-Original
  4. Extract the new JRE file provided by support to the installation directory.
    Example (Linux):
    	tar zxvf ibm-java-jre-7.1-4.50-linux-x86_64.tgz -C <OrigInstallDir>/server/
    	mv <OrigInstallDir>/server/ibm-java-x86_64-71/jre <OrigInstallDir>/server/
  5. Restart the server.

Upgrading the JRE for a Tomcat installation

  1. Stop the server.

    Note: The applications might be running in different application server instances or that use a delegated converter.

  2. Navigate to the original installation directory and rename the JRE folder
    <InstallDir>/server/jre to <InstallDir>/server/jre-Original
    To ensure that the original JRE is kept as a backup if a restore is required.
    Example (Linux): mv <OrigInstallDir>/server/jre <OrigInstallDir>/server/jre-Original
  3. Extract the new JRE file provided by support to the installation directory.
    Example (Linux):
    	tar zxvf ibm-java-jre-7.1-4.50-linux-x86_64.tgz -C <OrigInstallDir>/server/
    	mv <OrigInstallDir>/server/ibm-java-x86_64-71/ <OrigInstallDir>/server/jre/
    	mv <OrigInstallDir>/server/jre/jre/* <OrigInstallDir>/server/jre/
    	rmdir <OrigInstallDir>/server/jre/jre
  4. Remove the temporary Apache Tomcat files located in the following directories:
    <OrigInstallDir>/server/tomcat/temp
    <OrigInstallDir>/server/tomcat/work/Catalina/localhost
  5. Restart the server.

Upgrading the JRE for Eclipse client

There are two options. The first one is applicable to the JRE found in Fix Central:

  • Add new JRE (See eclipse.ini at Eclipse.org)
    1. Close the Eclipse client.
    2. Create new jre directory inside the Eclipse installation.

      <Eclipse Install directory>/client/eclipse/jre

    3. Extract the contents of the ibm-java-jre-* compressed file into the directory in Step 2.
    4. Edit the eclipse.ini file, changing the value for argument -vm to match the location of jre/bin/javaw executable file.
    5. Restart the Eclipse client.
  • The second is replacing the JDK
    1. Close the Eclipse client.
    2. Back up the JDK folder for your Eclipse installation. <Eclipse Install directory>/client/eclipse/jdk
    3. Extract the contents of the ibm-java-sdk-* compressed file into the directory in Step 2
    4. Rename the extracted file in Step 3 from sdk to jdk in order to match the original directory name.
    5. Restart the Eclipse client.

Decision tree flow chart

What application server do you use to host ELM? Tomcat WebSphere Liberty WebSphere Application Server Follow steps in "Eclipse Client" section Do you use Eclipse Client? Do you use RM browser add-on? You are done Follow steps in "RM browser add-on" section Yes No Yes No Follow steps in "Eclipse Client" section Follow steps in "WebSphere Application Server" section Follow steps in "WebSphere Liberty" section Follow steps in "Apache Tomcat" section

[{"Type":"MASTER","Line of Business":{"code":"LOB02","label":"AI Applications"},"Business Unit":{"code":"BU055","label":"Cognitive Applications"},"Product":{"code":"SSUB2H","label":"IBM Engineering Lifecycle Optimization - Engineering Insights"},"ARM Category":[{"code":"a8m50000000Cj7AAAS","label":"RELM->Installation"}],"ARM Case Number":"TS006141094","Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"All Versions"},{"Type":"MASTER","Line of Business":{"code":"LOB02","label":"AI Applications"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSUVV6","label":"IBM Engineering Test Management"},"ARM Category":[{"code":"a8m0z000000CbPJAA0","label":"Jazz Team Server->Upgrade"}],"Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"All Versions"},{"Type":"MASTER","Line of Business":{"code":"LOB02","label":"AI Applications"},"Business Unit":{"code":"BU055","label":"Cognitive Applications"},"Product":{"code":"SSUC3U","label":"IBM Engineering Workflow Management"},"ARM Category":[{"code":"a8m0z000000bnw3AAA","label":"Workflow Management->installation"}],"Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"All Versions"},{"Type":"MASTER","Line of Business":{"code":"LOB02","label":"AI Applications"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSUVLZ","label":"IBM Engineering Requirements Management DOORS Next"},"ARM Category":[{"code":"a8m0z000000CbQHAA0","label":"Jazz Team Server->JVM"}],"Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"All Versions"},{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSRNEV","label":"Rational Rhapsody Design Manager"},"Component":"General Information","Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"6.0;6.0.1;6.0.2;6.0.3;6.0.4;6.0.5;6.0.6","Edition":"","Line of Business":{"code":"","label":""}},{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSRMY8","label":"Rational Software Architect Design Manager"},"Component":"General Information","Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"6.0;6.0.1;6.0.2","Edition":"","Line of Business":{"code":"LOB36","label":"IBM Automation"}},{"Type":"MASTER","Line of Business":{"code":"LOB02","label":"AI Applications"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSPRJQ","label":"IBM Engineering Lifecycle Management Base"},"ARM Category":[{"code":"a8m0z000000CbQHAA0","label":"Jazz Team Server->JVM"}],"Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"All Versions"},{"Type":"MASTER","Line of Business":{"code":"LOB02","label":"AI Applications"},"Business Unit":{"code":"BU055","label":"Cognitive Applications"},"Product":{"code":"SSUC3U","label":"IBM Engineering Workflow Management"},"ARM Category":[{"code":"a8m0z000000CbQHAA0","label":"Jazz Team Server->JVM"}],"Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"All Versions"},{"Type":"MASTER","Line of Business":{"code":"LOB02","label":"AI Applications"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSUVV6","label":"IBM Engineering Test Management"},"ARM Category":[{"code":"a8m50000000L3DPAA0","label":"Continuous Engineering"}],"Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"All Versions"},{"Type":"MASTER","Line of Business":{"code":"LOB02","label":"AI Applications"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSUVLZ","label":"IBM Engineering Requirements Management DOORS Next"},"ARM Category":[{"code":"a8m50000000L3DPAA0","label":"Continuous Engineering"}],"Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"All Versions"},{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSUVYQ","label":"IBM Engineering Systems Design Rhapsody"},"Component":"Web App Server","Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"6.0.6.1","Edition":"","Line of Business":{"code":"LOB02","label":"AI Applications"}},{"Business Unit":{"code":"BU055","label":"Cognitive Applications"},"Product":{"code":"SSUB2H","label":"IBM Engineering Lifecycle Optimization - Engineering Insights"},"Component":"Web App Server","Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"6.0.6.1","Edition":"","Line of Business":{"code":"LOB02","label":"AI Applications"}},{"Business Unit":{"code":"BU055","label":"Cognitive Applications"},"Product":{"code":"SSV36Y","label":"IBM Engineering Systems Design Rhapsody - Model Manager"},"Component":"Web App Server","Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"6.0.6.1","Edition":"","Line of Business":{"code":"LOB02","label":"AI Applications"}}]

Document Information

Modified date:
14 July 2021

UID

swg21674139