Readme File for IBM® Platform Symphony, IBM Spectrum Symphony Interim Fix 502764

Readme File for: IBM Platform Symphony, IBM Spectrum Symphony

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

Update Name: Interim Fix 502764

Fix ID: sym-build502764

Publication Date: September 30, 2018

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-2973, CVE-2018-2940, CVE-2018-2952, CVE-2018-1656, CVE-2018-12539, CVE-2018-1517, CVE-2016-0705.

Contents

1. List of fixes

2. Download location

3. Installation and verification

4. Uninstallation

5. List of files

6. Copyright and trademark information

1.    List of fixes

APAR: P102730

2.    Download location

Download interim fix 502764 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

Linux 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.0.2

egojre-8.0.5.21.x86_64.rpm

Package for JRE 8 SR5 FP 21

IBM Spectrum Symphony 7.1.2

egojre-1.8.0.521.x86_64.rpm

Package for JRE 8 SR5 FP 21

Platform Symphony 7.1.1

Platform Symphony 7.1 Fix Pack 1

symSetup_jre8sr5fp21_linux-64_build502764.tar.gz

Package for JRE 8 SR5 FP 21

Prerequisite

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

Before installation

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

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

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

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 a Platform Symphony 7.1.1 cluster, back up the JRE folder at $EGO_TOP/jre/3.3/linux-x86_64/.

For IBM Spectrum Symphony 7.1.2 and 7.2.0.2, 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 leftover link under the jre folder, for example:

> rm -rf $EGO_TOP/jre/8.0.5.0

Install this interim fix

a.       Log on each management host as the cluster administrator and replace your current JRE folder with the files in this interim fix.

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 a Platform Symphony 7.1.1 cluster, enter the following commands:

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

> tar zxfo symSetup_jre8sr5fp21_linux-64_build502764.tar.gz -C $EGO_TOP/jre/3.3/linux-x86_64

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

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

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

c.        Launch your browser and clear the browser cache.

d.       Log on to the master host as the cluster administrator, start the cluster and enable your applications:

> source profile.platform

> egosh ego start all

> soamcontrol app enable <appName>

Verify the installation

·        For Platform Symphony 7.1 Fix Pack 1, 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_181"

Java(TM) SE Runtime Environment (build 8.0.5.21 - pxa6480sr5fp21-20180830_01(SR5 FP21))

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

OpenJ9   - e82188c

OMR      - eeaa30e

IBM      - 98805ca)

JCL - 20180821_01 based on Oracle jdk8u181-b12

·        For Platform Symphony 7.1.1, 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_181"

Java(TM) SE Runtime Environment (build 8.0.5.21 - pxa6480sr5fp21-20180830_01(SR5 FP21))

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

OpenJ9   - e82188c

OMR      - eeaa30e

IBM      - 98805ca)

JCL - 20180821_01 based on Oracle jdk8u181-b12

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

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

egojre-1.8.0.521-502764.x86_64

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

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

egojre-8.0.5.21-502764.x86_64

4.    Uninstallation

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

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

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

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

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 a Platform Symphony 7.1.1 cluster, restore your backup to the $EGO_TOP/jre/3.3/linux-x86_64/ folder.

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

a)     Uninstall the JRE fix, for example:

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

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

> rm -rf $EGO_TOP/jre/8.0.5.21

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

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

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

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

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

e.      Launch your browser and clear the browser cache.

f.       Log on to the master host as the cluster administrator, start the cluster and enable your applications:

> source profile.platform

> egosh ego start all

> soamcontrol app enable <appName>

5.    List of files

egojre-8.0.5.21.x86_64.rpm

egojre-1.8.0.521.x86_64.rpm

symSetup_jre8sr5fp21_linux-64_build502764.tar.gz

6.    Copyright and trademark information

© Copyright IBM Corporation 2018

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.