Readme File for IBM^® Platform Symphony, IBM Spectrum Symphony Interim Fix 510378

Readme File for: IBM Platform Symphony, IBM Spectrum Symphony

Product Release: 7.1 Fix Pack 1, 7.1.1, 7.1.2, 7.2.0.2 and 7.2.1

Update Name: Interim Fix 510378

Fix ID: sym-build510378

Publication Date: January 22, 2019

This interim fix enables you to upgrade the IBM Java Runtime Environment (JRE) in multiple IBM Platform Symphony / IBM Spectrum Symphony versions to fix the following security vulnerabilities in IBM Java SDK: CVE-2018-3183, CVE-2018-3169, CVE-2018-3149, CVE-2018-3180, CVE-2018-3214, CVE-2018-13785, CVE-2018-3136, and CVE-2018-3139.

Contents

1. List of fixes 

2. Download location 

3. Installation and configuration

4. Uninstallation

5. List of files

6. Product notifications

7. Copyright and trademark information

1.  List of fixes

APAR: P102850

2.  Download location

Download interim fix 510378 from the following location: https://www.ibm.com/eserver/support/fixes/

3.  Installation and verification

Follow the instructions in this section to download and install this interim fix in your cluster.

System requirements

o   Linux x86_64

o   Windows x86_64

Packages

Download the JRE package that applies to the version of your product installation:

Product version	Package to download	Description
IBM Spectrum Symphony 7.2.1	egojre-8.0.5.27.x86_64.rpm symSetup_jre8sr5fp27_linux-x64_build510378.tar.gz symSetup_jre8sr5fp27_win-x64_build510378.zip	Packages for JRE 8 SR5 FP 27
IBM Spectrum Symphony 7.2.0.2	egojre-8.0.5.27.x86_64.rpm symSetup_jre8sr5fp27_linux-x64_build510378.tar.gz symSetup_jre8sr5fp27_win-x64_build510378.zip	Packages for JRE 8 SR5 FP 27
IBM Spectrum Symphony 7.1.2	egojre-1.8.0.527.x86_64.rpm symSetup_jre8sr5fp27_linux-x64_build510378.tar.gz symSetup_jre8sr5fp27_win-x64_build510378.zip	Packages for JRE 8 SR5 FP 27
Platform Symphony 7.1.1 Platform Symphony 7.1 Fix Pack 1	symSetup_jre8sr5fp27_linux-x64_build510378.tar.gz symSetup_jre8sr5fp27_win-x64_build510378.zip	Packages for JRE 8 SR5 FP 27

Prerequisite

To install or uninstall the .rpm packages for IBM Spectrum Symphony 7.1.2, 7.2.0.2, and 7.2.1, you must have root permission and RPM version 4.2.1 or later must be installed on the host.

Installing on Linux management hosts in grid clusters

a.      Log on to the master host as the cluster administrator.

> egosh user logon -u Admin -x Admin

b.      Disable your applications, stop services, and shut down the cluster:

> soamcontrol app disable all

> egosh service stop all

> egosh ego shutdown all

c.      Back up or uninstall the existing JRE on all management hosts:

o   For Platform Symphony 7.1 Fix Pack 1 and 7.1.1, back up the JRE folder (under $EGO_TOP/jre/<EGO_version>/linux-x86_64/). For example, in Platform Symphony 7.1.1 cluster, back up the JRE folder at $EGO_TOP/jre/3.3/linux-x86_64/.

o   For IBM Spectrum Symphony 7.1.2, 7.2.0.2 and 7.2.1, uninstall the existing JRE:

a)     Query the existing JRE package and uninstall it from the dbpath location, for example:

> rpm -qa --dbpath /tmp/rpm |grep egojre

egojre-1.8.0.3-408454.x86_64

> rpm -e egojre-1.8.0.3-408454.x86_64 --dbpath /tmp/rpm --nodeps

b)     For IBM Spectrum Symphony 7.2.0.2, remove the links remaining in the jre folder, for example:

> rm -rf $EGO_TOP/jre/8.0.5.0

d.      Log on to each management host as the cluster administrator and source the environment.

> source profile.platform

e.      On each management host, replace your current JRE folder with the files in this interim fix.

o   For Platform Symphony 7.1 Fix Pack 1 and 7.1.1, remove the files in the existing JRE folder and extract the interim package to the JRE folder. For example, in Platform Symphony 7.1.1, enter the following commands:

> rm -rf $EGO_TOP/jre/3.3/linux-x86_64/*

> tar zxfo symSetup_jre8sr5fp27_linux-x64_build510378.tar.gz -C $EGO_TOP/jre/3.3/linux-x86_64

o   For IBM Spectrum Symphony 7.1.2, 7.2.0.2, and 7.2.1, use the same prefix and dbpath as the installation, for example:

> rpm –ivh egojre-1.8.0.527.x86_64.rpm --prefix /opt/platform --dbpath /tmp/rpm

f.       Delete all subdirectories and files in the GUI work directory:

> rm -rf $EGO_TOP/gui/work/*

> rm -rf $EGO_TOP/gui/workarea/*

NOTE: If you configured the WLP_OUTPUT_DIR parameter and APPEND_HOSTNAME_TO_WLP_OUTPUT_DIR is set to true in the $EGO_CONFDIR/conf/wlp.conf file, you must clean up the $WLP_OUTPUT_DIR/webgui_hostname/gui/workarea/ directory.

g.      Launch your browser and clear the browser cache.

h.      From the master host, start the cluster and enable your applications:

> source profile.platform

> egosh ego start all

> soamcontrol app enable <appName>

Installing on Linux Multicluster hosts

a.      Log on to the master host as the cluster administrator and source the environment:

> source profile.platform

b.      Stop services and shut down the cluster:

> egosh service stop all

> egosh ego shutdown all

c.      Back up the JRE folder (under $EGO_TOP/jre/<EGO_version>/linux-x86_64/). For example, in Platform Symphony 7.1.1 Multicluster, back up the JRE folder at $EGO_TOP/jre/3.3/linux-x86_64/.

d.      Log on to each management host as the cluster administrator and replace your current JRE folder with the files in this interim fix. For example, in Platform Symphony 7.1.1 Multicluster, enter the following commands:

> source profile.platform

> rm -rf $EGO_TOP/jre/3.3/linux-x86_64/*

> tar zxfo symSetup_jre8sr5fp27_linux-x64_build510378.tar.gz -C $EGO_TOP/jre/3.3/linux-x86_64

e.      Delete all subdirectories and files in the GUI work directory:

> rm -rf $EGO_TOP/gui/work/*

> rm -rf $EGO_TOP/gui/workarea/*

NOTE: If you configured the WLP_OUTPUT_DIR parameter and APPEND_HOSTNAME_TO_WLP_OUTPUT_DIR is set to true in the $EGO_CONFDIR/conf/wlp.conf file, you must clean up the $WLP_OUTPUT_DIR/webgui_hostname/gui/workarea/ directory.

f.       Launch your browser and clear the browser cache.

g.      From the master host, source the environment and start the cluster:

> source profile.platform

> egosh ego start all

Installing on Linux Developer Edition hosts

a.      Log on to each Linux Developer Edition (DE) host, source the environment and stop the agent:

> source profile.platform

> soamshutdown

b.      Back up the JRE folder (under $SOAM_HOME/jre/linux-x86_64/). For example, in Platform Symphony DE 7.1.1, back up the JRE folder at $SOAM_HOME/jre/linux-x86_64/.

c.      Log on to each DE host as the administrator and replace your current JRE folder with the files in this interim fix.

For example, in Platform Symphony DE 7.1.1, enter the following commands:

> rm -rf $SOAM_HOME/jre/linux-x86_64/*

> tar zxfo symSetup_jre8sr5fp27_linux-x64_build510378.tar.gz -C $SOAM_HOME/jre/linux-x86_64

d.      Start the agent:

> soamstartup &

Installing on Windows Developer Edition hosts

a.      Log on to each Windows Developer Edition (DE) host and stop the agent:

> soamshutdown

b.      Back up the JRE folder (under %SOAM_HOME%\jre). For example, in Platform Symphony DE 7.1.1, back up the JRE folder at %SOAM_HOME%\jre.

c.      Log on to each DE host as the administrator and replace your current JRE folder with the files in this interim fix. For example, in Platform Symphony DE 7.1.1, delete all files under %SOAM_HOME%\jre, and decompress the symSetup_jre8sr5fp27_win-x64_build510378.zip package under it.

d.      Start the agent:

> soamstartup

Verifying the installation

o   For Platform Symphony 7.1 Fix Pack 1 hosts, the following example shows output for the java -version command:

> $EGO_TOP/jre/3.1/linux-x86_64/bin/java -version

java version "1.8.0_191"

Java(TM) SE Runtime Environment (build 8.0.5.27 - pxa6480sr5fp27-20190104_01(SR5 FP27))

IBM J9 VM (build 2.9, JRE 1.8.0 Linux amd64-64-Bit Compressed References 20181219_405297 (JIT enabled, AOT enabled)

OpenJ9   - 3f2d574

OMR      - 109ba5b

IBM      - e2996d1)

JCL - 20190104_01 based on Oracle jdk8u191-b26

o   For Platform Symphony 7.1.1 hosts, the following example shows output for the java -version command:

> $EGO_TOP/jre/3.3/linux-x86_64/bin/java -version

java version "1.8.0_191"

Java(TM) SE Runtime Environment (build 8.0.5.27 - pxa6480sr5fp27-20190104_01(SR5 FP27))

IBM J9 VM (build 2.9, JRE 1.8.0 Linux amd64-64-Bit Compressed References 20181219_405297 (JIT enabled, AOT enabled)

OpenJ9   - 3f2d574

OMR      - 109ba5b

IBM      - e2996d1)

JCL - 20190104_01 based on Oracle jdk8u191-b26

o   For IBM Spectrum Symphony 7.1.2 hosts, the following example shows output for the rpm -qa command:

> rpm -qa --dbpath /tmp/rpm |grep egojre

egojre-1.8.0.527-510378.x86_64

o   For IBM Spectrum Symphony 7.2.0.2 hosts, the following example shows output for the rpm -qa command:

> rpm -qa --dbpath /tmp/rpm |grep egojre

egojre-8.0.5.27-510378.x86_64

o   For IBM Spectrum Symphony 7.2.1 hosts, the following example shows output for the rpm -qa command:

> rpm -qa --dbpath /tmp/rpm |grep egojre

egojre-8.0.5.27-510378.x86_64

o   For Linux DE hosts, the following example shows output for the java -version command:

> $SOAM_HOME/jre/linux-x86_64/bin/java -version

java version "1.8.0_191"

Java(TM) SE Runtime Environment (build 8.0.5.27 - pxa6480sr5fp27-20190104_01(SR5 FP27))

IBM J9 VM (build 2.9, JRE 1.8.0 Linux amd64-64-Bit Compressed References 20181219_405297 (JIT enabled, AOT enabled)

OpenJ9   - 3f2d574

OMR      - 109ba5b

IBM      - e2996d1)

JCL - 20190104_01 based on Oracle jdk8u191-b26

o   For Windows DE hosts, the following example shows output for the java -version command:

> %SOAM_HOME%\jre\bin\java -version

java version "1.8.0_191"

Java(TM) SE Runtime Environment (build 8.0.5.27 - pwa6480sr5fp27-20190104_01(SR5 FP27))

IBM J9 VM (build 2.9, JRE 1.8.0 Windows Server 2012 R2 amd64-64-Bit Compressed References 20181219_405297 (JIT enabled, AOT enabled)

OpenJ9   - 3f2d574

OMR      - 109ba5b

IBM      - e2996d1)

JCL - 20190104_01 based on Oracle jdk8u191-b26

4.  Uninstallation

If required, follow these instructions to uninstall this interim fix in your cluster:

Uninstalling on Linux management hosts in grid clusters

a.      Log on to each management host as the cluster administrator, disable your applications, stop services, and shut down the cluster:

> source profile.platform

> soamcontrol app disable all

> egosh service stop all

> egosh ego shutdown all

b.      Log on to each management host as the cluster administrator and restore the JRE folder from your backup.

o   For Platform Symphony 7.1 Fix Pack 1 and 7.1.1, restore your backup to the $EGO_TOP/jre/<EGO_version>/linux-x86_64/ folder. For example, in Platform Symphony 7.1.1, restore your backup to the $EGO_TOP/jre/3.3/linux-x86_64/ folder.

o   For IBM Spectrum Symphony 7.1.2, 7.2.0.2 and 7.2.1, uninstall the existing JRE, then install the old one:

a)     Uninstall the JRE fix, for example:

> rpm -e egojre-1.8.0.521-510378.x86_64 --dbpath /tmp/rpm/ --nodeps

b)     For IBM Spectrum Symphony 7.2.0.2, remove the link remaining under the jre folder, for example:

> rm -rf $EGO_TOP/jre/8.0.5.27

c)      Extract the egojre .rpm package from the .bin installation package. For example, for IBM Spectrum Symphony 7.1.2, enter:

> sym-7.1.2.0_x86_64.bin --extract /opt/extract

d)     Reinstall the old JRE package. Use the same prefix and dbpath as the installation, for example:

> rpm -ivh /opt/extract/egojre-1.8.0.3.x86_64.rpm --prefix /opt/platform --dbpath /tmp/rpm

c.      Delete all subdirectories and files in the GUI work directory:

> rm -rf $EGO_TOP/gui/work/*

> rm -rf $EGO_TOP/gui/workarea/*

NOTE: If you configured the WLP_OUTPUT_DIR parameter and APPEND_HOSTNAME_TO_WLP_OUTPUT_DIR is set to true in the $EGO_CONFDIR/conf/wlp.conf file, you must clean up the $WLP_OUTPUT_DIR/webgui_hostname/gui/workarea/ directory.

d.      Launch your browser and clear the browser cache.

e.      From the master host, start the cluster and enable your applications:

> source profile.platform

> egosh ego start all

> soamcontrol app enable <appName>

Uninstalling on Linux Multicluster hosts

a.      Log on to each management host as the cluster administrator, stop services, and shut down the cluster:

> source profile.platform

> egosh service stop all

> egosh ego shutdown all

b.      Restore your backup to the $EGO_TOP/jre/<EGO_version>/linux-x86_64/ folder. For example, in Platform Symphony 7.1.1 Multicluster, restore your backup to the $EGO_TOP/jre/3.3/linux-x86_64/ folder.

c.      Delete all subdirectories and files in the GUI work directory:

> rm -rf $EGO_TOP/gui/work/*

> rm -rf $EGO_TOP/gui/workarea/*

NOTE: If you configured the WLP_OUTPUT_DIR parameter and APPEND_HOSTNAME_TO_WLP_OUTPUT_DIR is set to true in the $EGO_CONFDIR/conf/wlp.conf file, you must clean up the $WLP_OUTPUT_DIR/webgui_hostname/gui/workarea/ directory.

d.      Launch your browser and clear the browser cache.

e.      From the master host, source the environment and start the cluster:

> source profile.platform

> egosh ego start all

Uninstalling on Linux Developer Edition hosts

a.      Log on to each Linux Developer Edition (DE) host as the administrator and stop the agent:

> source profile.platform

> soamshutdown

b.      Restore your backup to the $SOAM_HOME/jre/linux-x86_64/ folder. For example, in Platform Symphony DE 7.1.1, restore the JRE folder at $SOAM_HOME/jre/linux-x86_64/.

c.      Start the agent:

> soamstartup &

Uninstalling on Windows Developer Edition hosts

a.      Log on to each Windows Developer Edition (DE) host as the administrator and stop the agent:

> soamshutdown

b.      Restore your backup to the %SOAM_HOME%\jre folder. For example, in Platform Symphony DE 7.1.1, restore the JRE folder at %SOAM_HOME%\jre.

c.      Start the agent:

> soamstartup

5.  List of files

egojre-8.0.5.27.x86_64.rpm

egojre-8.0.5.27.x86_64.rpm

egojre-1.8.0.527.x86_64.rpm

symSetup_jre8sr5fp27_linux-64_build510378.tar.gz

symSetup_jre8sr5fp27_win-x64_build510378.zip

6.  Product notifications

To receive information about product solution and patch updates automatically, subscribe to product notifications on the My Notifications page http://www.ibm.com/support/mynotifications/ on the IBM Support website (http://support.ibm.com). You can edit your subscription settings to choose the types of information you want to get notification about, for example, security bulletins, fixes, troubleshooting, and product enhancements or documentation changes.

7.  Copyright and trademark information

© Copyright IBM Corporation 2019

U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

IBM®, the IBM logo, and ibm.com® are trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.