Readme File for IBM®
Platform Symphony, IBM Spectrum Symphony Interim Fix 531850
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 531850
Fix ID: sym-build531850
Publication Date: October 25, 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-2019-11775,
CVE-2019-11772, CVE-2019-2766, CVE-2019-2786, CVE-2019-2816, CVE-2019-2762,
CVE-2019-2769, CVE-2019-7317.
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: P103272
2. Download location
Download interim
fix 531850 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.41.x86_64.rpm symSetup_jre8sr5fp41_linux-x64_build531850.tar.gz symSetup_jre8sr5fp41_win-x64_build531850.zip |
Packages for JRE 8 SR5 FP 41 |
|
IBM Spectrum Symphony 7.2.0.2 |
egojre-8.0.5.41.x86_64.rpm symSetup_jre8sr5fp41_linux-x64_build531850.tar.gz symSetup_jre8sr5fp41_win-x64_build531850.zip |
Packages for JRE 8 SR5 FP 41 |
|
IBM Spectrum Symphony 7.1.2 |
egojre-1.8.0.541.x86_64.rpm symSetup_jre8sr5fp41_linux-x64_build531850.tar.gz symSetup_jre8sr5fp41_win-x64_build531850.zip |
Packages for JRE 8 SR5 FP 41 |
|
Platform Symphony 7.1.1 Platform Symphony 7.1 Fix Pack 1 |
symSetup_jre8sr5fp41_linux-x64_build531850.tar.gz symSetup_jre8sr5fp41_win-x64_build531850.zip |
Packages for JRE 8 SR5 FP 41 |
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_jre8sr5fp41_linux-x64_build531850.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.541.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_jre8sr5fp41_linux-x64_build531850.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_jre8sr5fp41_linux-x64_build531850.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_jre8sr5fp41_win-x64_build531850.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_221"
Java(TM)
SE Runtime Environment (build 8.0.5.41 - pxa6480sr5fp41-20190919_01(SR5 FP41))
IBM J9 VM (build 2.9, JRE
1.8.0 Linux amd64-64-Bit Compressed References 20190911_427071 (JIT enabled,
AOT enabled)
OpenJ9 - d581d49
OMR - ca4db84
IBM - 5cfdf9c)
JCL - 20190918_01 based on
Oracle jdk8u221-b11
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_221"
Java(TM)
SE Runtime Environment (build 8.0.5.41 - pxa6480sr5fp41-20190919_01(SR5 FP41))
IBM J9 VM (build 2.9, JRE
1.8.0 Linux amd64-64-Bit Compressed References 20190911_427071 (JIT enabled,
AOT enabled)
OpenJ9 - d581d49
OMR - ca4db84
IBM - 5cfdf9c)
JCL - 20190918_01 based on
Oracle jdk8u221-b11
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.541-531850.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.41-531850.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.41-531850.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_221"
Java(TM)
SE Runtime Environment (build 8.0.5.41 - pxa6480sr5fp41-20190919_01(SR5 FP41))
IBM J9 VM (build 2.9, JRE 1.8.0 Linux amd64-64-Bit
Compressed References 20190911_427071 (JIT enabled, AOT enabled)
OpenJ9 - d581d49
OMR - ca4db84
IBM - 5cfdf9c)
JCL - 20190918_01 based on Oracle jdk8u221-b11
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_221"
Java(TM)
SE Runtime Environment (build 8.0.5.41 - pwa6480sr5fp41-20190919_01(SR5 FP41))
IBM J9 VM (build 2.9, JRE 1.8.0 Windows Server 2016
amd64-64-Bit Compressed References 20190911_427071 (JIT enabled, AOT enabled)
OpenJ9 - d581d49
OMR - ca4db84
IBM - 5cfdf9c)
JCL - 20190918_01 based on Oracle jdk8u221-b11
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.541-531850.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.41
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.41.x86_64.rpm
egojre-8.0.5.41.x86_64.rpm
egojre-1.8.0.541.x86_64.rpm
symSetup_jre8sr5fp41_linux-64_build531850.tar.gz
symSetup_jre8sr5fp41_win-x64_build531850.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.