Readme File for IBM®
Platform Symphony, IBM Spectrum Symphony Interim Fix 520994
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 520994
Fix ID: sym-build520994
Publication Date: May 30, 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-11212,
CVE-2019-2426, CVE-2019-2449, CVE-2019-2422, CVE-2018-12547, CVE-2018-12549,
CVE-2019-2698, CVE-2019-2697, CVE-2019-2602, CVE-2019-2684, CVE-2019-10245.
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: P103016
2. Download location
Download interim
fix 520994 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.35.x86_64.rpm symSetup_jre8sr5fp35_linux-x64_build520994.tar.gz symSetup_jre8sr5fp35_win-x64_build520994.zip |
Packages for JRE 8 SR5 FP 35 |
IBM Spectrum Symphony 7.2.0.2 |
egojre-8.0.5.35.x86_64.rpm symSetup_jre8sr5fp35_linux-x64_build520994.tar.gz symSetup_jre8sr5fp35_win-x64_build520994.zip |
Packages for JRE 8 SR5 FP 35 |
IBM Spectrum Symphony 7.1.2 |
egojre-1.8.0.535.x86_64.rpm symSetup_jre8sr5fp35_linux-x64_build520994.tar.gz symSetup_jre8sr5fp35_win-x64_build520994.zip |
Packages for JRE 8 SR5 FP 35 |
Platform Symphony 7.1.1 Platform Symphony 7.1 Fix Pack 1 |
symSetup_jre8sr5fp35_linux-x64_build520994.tar.gz symSetup_jre8sr5fp35_win-x64_build520994.zip |
Packages for JRE 8 SR5 FP 35 |
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_jre8sr5fp35_linux-x64_build520994.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.535.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_jre8sr5fp35_linux-x64_build520994.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, disable all applications and stop the agent:
> source profile.platform
> soamcontrol app disable all
> 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_jre8sr5fp35_linux-x64_build520994.tar.gz -C $SOAM_HOME/jre/linux-x86_64
d.
Start the agent and enable applications:
> soamstartup
&
> soamcontrol
app enable <appName>
Installing on
Windows Developer Edition hosts
a.
Log on to each Windows Developer Edition (DE) host, disable
all applications and stop the agent:
> soamcontrol app disable all
> 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_jre8sr5fp35_win-x64_build520994.zip package under it.
d.
Start the agent and enable applications:
> soamstartup
> soamcontrol
app enable <appName>
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_211"
Java(TM)
SE Runtime Environment (build 8.0.5.35 - pxa6480sr5fp35-20190418_01(SR5 FP35))
IBM J9 VM (build 2.9, JRE
1.8.0 Linux amd64-64-Bit Compressed References 20190417_414854 (JIT enabled,
AOT enabled)
OpenJ9 - 777635f
OMR - 16b77d7
IBM - 72459d3)
JCL - 20190409_01 based on
Oracle jdk8u211-b25
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_211"
Java(TM)
SE Runtime Environment (build 8.0.5.35 - pxa6480sr5fp35-20190418_01(SR5 FP35))
IBM J9 VM (build 2.9, JRE
1.8.0 Linux amd64-64-Bit Compressed References 20190417_414854 (JIT enabled,
AOT enabled)
OpenJ9 - 777635f
OMR -
16b77d7
IBM - 72459d3)
JCL - 20190409_01 based on
Oracle jdk8u211-b25
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.535-520994.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.35-520994.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.35-520994.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_211"
Java(TM)
SE Runtime Environment (build 8.0.5.35 - pxa6480sr5fp35-20190418_01(SR5 FP35))
IBM J9 VM (build 2.9, JRE 1.8.0 Linux amd64-64-Bit
Compressed References 20190417_414854 (JIT enabled, AOT enabled)
OpenJ9 - 777635f
OMR - 16b77d7
IBM - 72459d3)
JCL - 20190409_01 based on Oracle jdk8u211-b25
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_211"
Java(TM)
SE Runtime Environment (build 8.0.5.35 - pwa6480sr5fp35-20190418_01(SR5 FP35))
IBM J9 VM (build 2.9, JRE 1.8.0 Windows 10 amd64-64-Bit
Compressed References 20190417_414854 (JIT enabled, AOT enabled)
OpenJ9 - 777635f
OMR - 16b77d7
IBM - 72459d3)
JCL - 20190409_01 based on Oracle jdk8u211-b25
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.535-520994.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.35
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
> soamcontrol app disable all
> 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 and enable applications:
> soamstartup
&
> soamcontrol
app enable <appName>
Uninstalling on
Windows Developer Edition hosts
a.
Log on to each Windows Developer Edition (DE) host as the
administrator, disable all applications and stop the agent:
> soamcontrol
app disable all
> 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 and enable applications:
> soamstartup
> soamcontrol
app enable <appName>
5. List of files
egojre-8.0.5.35.x86_64.rpm
egojre-8.0.5.35.x86_64.rpm
egojre-1.8.0.535.x86_64.rpm
symSetup_jre8sr5fp35_linux-64_build520994.tar.gz
symSetup_jre8sr5fp35_win-x64_build520994.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.