Readme File for IBM® Spectrum Symphony 7.2.0.2 Interim Fix 600148

Readme file for: IBM Spectrum Symphony

Product release: 7.2.0.2

Fix ID: sym-7.2.0.2-build600148

Publication date: March 19, 2021

 

This enhancement upgrades the Struts framework on IBM Spectrum Symphony 7.2.0.2 to the more secure Struts 2.5.26 distribution.

1.     Scope

Before you install this enhancement to your cluster, note the following requirements:

Product version

Operating system

IBM Spectrum Symphony management hosts

Linux x64

Windows x64

IBM Spectrum Symphony compute hosts

Linux x64
Windows x64

IBM Spectrum Symphony Developer Edition

Linux x64
Windows x64

 

2.     Installation

Follow these instructions to download and install this enhancement to hosts in your cluster.

Installing on IBM Spectrum Symphony Linux management hosts

a.       Log on to the primary host as the cluster administrator and stop the following services:

> egosh user logon -u Admin -x Admin

> egosh service stop WEBGUI REST plc purger

b.       On each management host, download the script called script_for_build600148.sh to the $EGO_TOP directory.

c.        For recovery purposes, log on to each management host in your cluster as the cluster administrator, and run the script to generate a backup file called backup_grid_build600148.tar:

> ./script_for_build600148.sh grid backup

d.       Download the sym-7.2.0.2_x86_64_build600148.tar.gz package and install the enhancement:

> tar zxfo sym-7.2.0.2_x86_64_build600148.tar.gz -C $EGO_TOP/

e.       Copy the log4j2.xml file from local directory into a shared directory:

> cp $EGO_TOP/gui/conf/log4j2.xml $EGO_CONFDIR/../../gui/conf/

f.         Delete all subdirectories and files from the following directories:

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

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

(Optional) > rm -rf $WLP_OUTPUT_DIR/webgui_hostname/gui/workarea/*

> rm -rf $EGO_TOP/kernel/rest/workarea/*

g.       Clear your browser cache. 

h.       Start the following services:

> egosh service start WEBGUI REST plc purger

Installing on IBM Spectrum Symphony Windows management hosts

a.       Log on to the primary host as the cluster administrator and stop the following services:

> egosh user logon -u Admin -x Admin

> egosh service stop WEBGUI REST plc purger

b.       Download the sym-7.2.0.2_build600148.zip package, and complete the following steps:

1)       Back up the following folders on all management hosts:

Installation_top\wlp\usr\servers\gui\apps\

Installation_top\wlp\usr\servers\rest\apps\

Installation_top\wlp\usr\shared\resources\rest\

Installation_top\gui\3.6\lib\

Installation_top\perf\3.6\lib\

2)       Remove the following files on all management hosts:

Installation_top\wlp\usr\servers\gui\apps\ego\3.6\platform\framework\main.jsp

Installation_top\wlp\usr\servers\gui\apps\ego\3.6\platform\framework\messages.jsp

Installation_top\wlp\usr\servers\gui\apps\ego\3.6\platform\framework\security\editRolePermission.jsp

Installation_top\wlp\usr\servers\gui\apps\ego\3.6\platform\framework\error.jsp

Installation_top\wlp\usr\servers\gui\apps\ego\3.6\platform\framework\security\userRolePermission.jsp

Installation_top\wlp\usr\servers\gui\apps\ego\3.6\platform\widget\message.jsp

Installation_top\wlp\usr\servers\gui\apps\ego\3.6\platform\WEB-INF\web.xml

Installation_top\wlp\usr\servers\gui\apps\ego\3.6\platform\ego\common\commonHeader.jsp

Installation_top\wlp\usr\servers\gui\apps\ego\3.6\platform\ego\dashboard\resourceDashboard.jsp

Installation_top\wlp\usr\servers\gui\apps\ego\3.6\platform\framework\login\login.jsp

Installation_top\wlp\usr\servers\gui\apps\soam\7.2\symgui\framework\main.jsp

Installation_top\wlp\usr\servers\gui\apps\soam\7.2\symgui\framework\messages.jsp

Installation_top\wlp\usr\servers\gui\apps\soam\7.2\symgui\framework\security\editRolePermission.jsp

Installation_top\wlp\usr\servers\gui\apps\soam\7.2\symgui\framework\error.jsp

Installation_top\wlp\usr\servers\gui\apps\soam\7.2\symgui\framework\security\userRolePermission.jsp

Installation_top\wlp\usr\servers\gui\apps\soam\7.2\symgui\widget\message.jsp

Installation_top\wlp\usr\servers\gui\apps\soam\7.2\symgui\framework\login\login.jsp

Installation_top\wlp\usr\servers\gui\apps\soam\7.2\symgui\WEB-INF\web.xml

Installation_top\wlp\usr\servers\gui\apps\soam\7.2\symgui\sym\common\commonHeader.jsp

Installation_top\wlp\usr\servers\gui\apps\soam\7.2\symgui\pmr\applications\applicationsummary.jsp

Installation_top\wlp\usr\servers\gui\apps\soam\7.2\symgui\pmr\jobs\jobcounters.jsp

Installation_top\wlp\usr\servers\gui\apps\soam\7.2\symgui\pmr\jobs\jobconfiguration.jsp

Installation_top\wlp\usr\servers\gui\apps\soam\7.2\symgui\pmr\jobs\jobs.jsp

Installation_top\wlp\usr\servers\gui\apps\soam\7.2\symgui\pmr\jobs\jobsummary.jsp

Installation_top\wlp\usr\servers\gui\apps\soam\7.2\symgui\pmr\task\taskcounters.jsp

Installation_top\wlp\usr\servers\gui\apps\soam\7.2\symgui\pmr\task\taskretrievelog.jsp

Installation_top\wlp\usr\servers\gui\apps\soam\7.2\symgui\pmr\task\taskattempts.jsp

Installation_top\wlp\usr\servers\gui\apps\soam\7.2\symgui\pmr\task\tasklist.jsp

Installation_top\wlp\usr\servers\gui\apps\soam\7.2\symgui\pmr\task\tasksummary.jsp

Installation_top\wlp\usr\servers\gui\apps\kc\1.5.1\kc\WEB-INF\lib\log4j-api-2.*.jar

Installation_top\wlp\usr\servers\gui\apps\kc\1.5.1\kc\WEB-INF\lib\log4j-core-2.*.jar

Installation_top\wlp\usr\servers\gui\apps\ego\3.6\platformv5\WEB-INF\lib\jackson-annotations-2.*.jar

Installation_top\wlp\usr\servers\gui\apps\ego\3.6\platformv5\WEB-INF\lib\jackson-core-2.*.jar

Installation_top\wlp\usr\servers\gui\apps\ego\3.6\platformv5\WEB-INF\lib\jackson-databind-2.*.jar

Installation_top\wlp\usr\servers\gui\apps\kc\1.5.1\kc\WEB-INF\lib\commons-io-2.*.jar

Installation_top\wlp\usr\servers\gui\apps\kc\1.5.1\kc\WEB-INF\lib\commons-lang-2.*.jar

Installation_top\wlp\usr\servers\gui\apps\kc\1.5.1\kc\WEB-INF\lib\commons-lang3-3.*.jar

Installation_top\wlp\usr\servers\gui\apps\kc\1.5.1\kc\WEB-INF\lib\commons-logging-1.*.jar

Installation_top\wlp\usr\servers\gui\apps\kc\1.5.1\kc\WEB-INF\lib\slf4j-api-1.*.jar

Installation_top\wlp\usr\servers\gui\apps\perf\3.6\perfgui\WEB-INF\lib\freemarker-2.*.jar

Installation_top\wlp\usr\servers\gui\apps\perf\3.6\perfgui\WEB-INF\lib\ognl-3.*.jar

Installation_top\wlp\usr\servers\gui\apps\perf\3.6\perfgui\WEB-INF\lib\struts2-core-2.*.jar

Installation_top\wlp\usr\servers\gui\apps\perf\3.6\perfguiv5\WEB-INF\lib\freemarker-2.*.jar

Installation_top\wlp\usr\servers\gui\apps\perf\3.6\perfguiv5\WEB-INF\lib\ognl-3.*.jar

Installation_top\wlp\usr\servers\gui\apps\ego\3.6\platform\WEB-INF\lib\xstream-1.*.jar

Installation_top\wlp\usr\servers\rest\apps\3.6\deploymentrest\WEB-INF\lib\commons-fileupload-1.*.jar

Installation_top\wlp\usr\servers\rest\apps\3.6\deploymentrest\WEB-INF\lib\commons-io-2.*.jar

Installation_top\wlp\usr\shared\resources\rest\3.6\commons-beanutils-1.*.jar

Installation_top\wlp\usr\shared\resources\rest\3.6\commons-lang-2.*.jar

Installation_top\wlp\usr\shared\resources\rest\3.6\commons-lang3-3.*.jar

Installation_top\wlp\usr\shared\resources\rest\3.6\commons-logging-1.*.jar

Installation_top\gui\3.6\lib\commons-beanutils-1.*.jar

Installation_top\gui\3.6\lib\commons-digester-2.*.jar

Installation_top\gui\3.6\lib\commons-fileupload-1.*.jar

Installation_top\gui\3.6\lib\commons-io-2.*.jar

Installation_top\gui\3.6\lib\commons-lang-2.*.jar

Installation_top\gui\3.6\lib\commons-lang3-3.*.jar

Installation_top\gui\3.6\lib\commons-logging-1.*.jar

Installation_top\gui\3.6\lib\freemarker-2.*.jar

Installation_top\gui\3.6\lib\javassist-3.*.jar

Installation_top\gui\3.6\lib\ognl-3.*.jar

Installation_top\gui\3.6\lib\snakeyaml-1.*.jar

Installation_top\gui\3.6\lib\struts2-core-2.*.jar

Installation_top\gui\3.6\lib\struts2-json-plugin-2.*.jar

Installation_top\gui\3.6\lib\struts2-spring-plugin-2.*.jar

Installation_top\gui\3.6\lib\slf4j-api-1.*.jar

Installation_top\perf\3.6\lib\commons-beanutils-1.*.jar

Installation_top\perf\3.6\lib\commons-digester-1.*.jar

Installation_top\perf\3.6\lib\commons-io-2.*.jar

3)       Decompress the sym-7.2.0.2_build600148.zip package.

4)       Copy all binaries to the corresponding directory on all management hosts:

c.       Copy the log4j2.xml file from local directory into a shared directory:

> cp Installation_top\gui\conf\log4j2.xml %EGO_CONFDIR%\..\..\gui\conf\

d.      Delete all subdirectories and files from the following directories:

Installation_top\gui\work\*

Installation_top\gui\workarea\*

(Optional) %WLP_OUTPUT_DIR%\webgui_hostname\gui\workarea\*

Installation_top\kernel\rest\workarea\*

e.       Clear your browser cache. 

f.         Start the following services:

> egosh service start WEBGUI REST plc purger

Installing on IBM Spectrum Symphony Linux or Windows compute hosts

Since the WEBGUI, REST, plc and purger services are not running on compute hosts, remove the libraries within the following directories to ensure there is no future security concerns:

On Linux:

o    $EGO_TOP/gui/*

o    $EGO_TOP/wlp/*

o    $EGO_TOP/perf/3.6/*

On Windows:

o    Installation_top\gui\*

o    Installation_top\wlp\*

o    Installation_top\perf\3.6\*

Installing on IBM Spectrum Symphony Developer Edition Linux hosts

a.       Use the soamshutdown command to shut down IBM Spectrum Symphony processes on the IBM Spectrum Symphony Developer Edition hosts:

> soamshutdown &

b.       Download the script called script_for_build600148.sh to the $SOAM_HOME directory.

c.        For recovery purposes, log on to each IBM Spectrum Symphony Developer Edition host and run the script to generate a backup file called backup_de_build600148.tar:

> ./script_for_build600148.sh de backup

d.       Download the symde-7.2.0.2_x86_64_build600148.tar.gz package and install the enhancement:

> tar zxfo symde-7.2.0.2_x86_64_build600148.tar.gz -C $SOAM_HOME/

e.       Delete all subdirectories and files from the following directories:

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

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

f.         Clear your browser cache. 

g.       Use the soamstartup command to start IBM Spectrum Symphony processes on the IBM Spectrum Developer Edition hosts:

> soamstartup &

Installing on IBM Spectrum Symphony Developer Edition Windows hosts

a.       Use the soamshutdown command to shut down IBM Spectrum Symphony processes on the IBM Spectrum Symphony Developer Edition hosts:

> echo .| soamshutdown

b.       Download the symde-7.2.0.2_build600148.zip package, and complete the following steps:

1)       Back up the following folders on all Developer Edition hosts:

%SOAM_HOME%\gui\3.6\lib\

%SOAM_HOME%\wlp\usr\servers\gui\apps\

2)       Remove the following files on all Developer Edition hosts:

%SOAM_HOME%\gui\3.6\lib\commons-beanutils-1.*.jar

%SOAM_HOME%\gui\3.6\lib\commons-digester-2.*.jar

%SOAM_HOME%\gui\3.6\lib\commons-fileupload-1.*.jar

%SOAM_HOME%\gui\3.6\lib\commons-io-2.*.jar

%SOAM_HOME%\gui\3.6\lib\commons-lang-2.*.jar

%SOAM_HOME%\gui\3.6\lib\commons-lang3-3.*.jar

%SOAM_HOME%\gui\3.6\lib\commons-logging-1.*.jar

%SOAM_HOME%\gui\3.6\lib\freemarker-2.*.jar

%SOAM_HOME%\gui\3.6\lib\javassist-3.*.jar

%SOAM_HOME%\gui\3.6\lib\ognl-3.*.jar

%SOAM_HOME%\gui\3.6\lib\snakeyaml-1.*.jar

%SOAM_HOME%\gui\3.6\lib\struts2-core-2.*.jar

%SOAM_HOME%\gui\3.6\lib\struts2-json-plugin-2.*.jar

%SOAM_HOME%\gui\3.6\lib\struts2-spring-plugin-2.*.jar

%SOAM_HOME%\gui\3.6\lib\xwork-core-2.*.jar

%SOAM_HOME%\gui\3.6\lib\slf4j-api-1.*.jar

%SOAM_HOME%\wlp\usr\servers\gui\apps\ego\3.6\platform\framework\main.jsp

%SOAM_HOME%\wlp\usr\servers\gui\apps\soam\7.2\symgui\framework\main.jsp

%SOAM_HOME%\wlp\usr\servers\gui\apps\ego\3.6\platform\framework\messages.jsp

%SOAM_HOME%\wlp\usr\servers\gui\apps\soam\7.2\symgui\framework\messages.jsp

%SOAM_HOME%\wlp\usr\servers\gui\apps\ego\3.6\platform\framework\login\login.jsp

%SOAM_HOME%\wlp\usr\servers\gui\apps\soam\7.2\symgui\framework\login\login.jsp

%SOAM_HOME%\wlp\usr\servers\gui\apps\ego\3.6\platform\framework\security\editRolePermission.jsp

%SOAM_HOME%\wlp\usr\servers\gui\apps\soam\7.2\symgui\framework\security\editRolePermission.jsp

%SOAM_HOME%\wlp\usr\servers\gui\apps\soam\7.2\symgui\framework\error.jsp

%SOAM_HOME%\wlp\usr\servers\gui\apps\ego\3.6\platform\framework\error.jsp

%SOAM_HOME%\wlp\usr\servers\gui\apps\ego\3.6\platform\framework\security\userRolePermission.jsp

%SOAM_HOME%\wlp\usr\servers\gui\apps\soam\7.2\symgui\framework\security\userRolePermission.jsp

%SOAM_HOME%\wlp\usr\servers\gui\apps\ego\3.6\platform\widget\message.jsp

%SOAM_HOME%\wlp\usr\servers\gui\apps\soam\7.2\symgui\widget\message.jsp

%SOAM_HOME%\wlp\usr\servers\gui\apps\ego\3.6\platform\WEB-INF\web.xml

%SOAM_HOME%\wlp\usr\servers\gui\apps\ego\3.6\platform\ego\common\commonHeader.jsp

%SOAM_HOME%\wlp\usr\servers\gui\apps\ego\3.6\platform\ego\dashboard\resourceDashboard.jsp

%SOAM_HOME%\wlp\usr\servers\gui\apps\soam\7.2\symgui\WEB-INF\web.xml

%SOAM_HOME%\wlp\usr\servers\gui\apps\soam\7.2\symgui\sym\common\commonHeader.jsp

3)       Decompress the symde-7.2.0.2_build600148.zip package.

4)       Copy all binaries to the corresponding directory on all Developer Edition hosts:

c.        Delete all subdirectories and files in the following directories:

%SOAM_HOME%\gui\work\*

%SOAM_HOME%\gui\workarea\*

d.       Clear your browser cache. 

e.       Use the soamstartup command to start IBM Spectrum Symphony processes on the IBM Spectrum Symphony Developer Edition hosts:

> echo .| soamstartup

3.     Uninstallation

If required, uninstall this enhancement from hosts in your cluster.

Uninstalling from IBM Spectrum Symphony Linux management hosts

a.       Log on to the primary host as the cluster administrator and stop the following services:

> egosh user logon -u Admin -x Admin

> egosh service stop WEBGUI REST plc purger

b.       On each management host, download the script called script_for_build600148.sh to the $EGO_TOP directory.

c.        On each management host, roll back this enhancement:

> ./script_for_build600148.sh grid rollback

> tar -xvf backup_grid_build600148.tar

d.       Delete the $EGO_CONFDIR/../../gui/conf/log4j2.xml file from the shared directory, if it exists.

e.       Delete all subdirectories and files from the following directories:

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

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

(Optional) > rm -rf $WLP_OUTPUT_DIR/webgui_hostname/gui/workarea/*

> rm -rf $EGO_TOP/kernel/rest/workarea/*

f.         Clear your browser cache. 

g.       From the primary host, start the following services:

> egosh service start WEBGUI REST plc purger

Uninstalling from IBM Spectrum Symphony Windows management hosts

a.       Log on to the primary host as the cluster administrator and stop the following services:

> egosh user logon -u Admin -x Admin

> egosh service stop WEBGUI REST plc purger

b.       Restore the following folders from your backup to roll back IBM Spectrum Symphony management hosts to the previous version:

Installation_top\wlp\usr\servers\gui\apps\

Installation_top\wlp\usr\servers\rest\apps\

Installation_top\wlp\usr\shared\resources\rest\

Installation_top\gui\3.6\lib\

Installation_top\perf\3.6\lib\

c.        Delete the %EGO_CONFDIR%\..\..\gui\conf\log4j2.xml file from the shared directory, if it exists.

d.       Delete all subdirectories and files from the following directories:

Installation_top\gui\work\*

Installation_top\gui\workarea\*

(Optional) %WLP_OUTPUT_DIR%\webgui_hostname\gui\workarea\*

Installation_top\kernel\rest\workarea\*

e.       Clear your browser cache. 

f.         From the primary host, start the following services:

> egosh service start WEBGUI REST plc purger

Uninstalling from IBM Spectrum Symphony Developer Edition Linux hosts

a.       Use the soamshutdown command to shut down IBM Spectrum Symphony processes on the IBM Spectrum Symphony Developer Edition hosts:

> soamshutdown &

b.       Download the script called script_for_build600148.sh to the $SOAM_HOME directory.

c.        On each IBM Spectrum Symphony Developer Edition host, roll back this enhancement:

> ./script_for_build600148.sh de rollback

> tar -xvf backup_de_build600148.tar

d.       Delete the $SOAM_HOME/gui/conf/log4j2.xml file.

e.       Delete all subdirectories and files from the following directories:

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

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

f.         Clear your browser cache. 

g.       Use the soamstartup command to start IBM Spectrum Symphony processes on the IBM Spectrum Symphony Developer Edition hosts:

> soamstartup &

Uninstalling from IBM Spectrum Symphony Developer Edition Windows hosts

a.       Use the soamshutdown command to shut down IBM Spectrum Symphony processes on the IBM Spectrum Symphony Developer Edition hosts:

> echo .| soamshutdown

b.      Restore the following folders from your backup to roll back IBM Spectrum Symphony Developer Edition hosts to the previous version:

%SOAM_HOME%\gui\3.6\lib\

%SOAM_HOME%\wlp\usr\servers\gui\apps\

c.      Delete all subdirectories and files from the following directories:

%SOAM_HOME%\gui\work\*

%SOAM_HOME%\gui\workarea\*

d.      Clear your browser cache. 

e.      Use the soamstartup command to start IBM Spectrum Symphony processes on the IBM Spectrum Symphony Developer Edition hosts:

> echo .| soamstartup

4.     List of files

a9d0db41315bf6da3f7375ce3c15c930 sym-7.2.0.2_x86_64_build600148.tar.gz

746939d2609e36d2bc170b0b9eafd0fc symde-7.2.0.2_x86_64_build600148.tar.gz

a37d5e248a8790e83b28ab5ee0b026a8 sym-7.2.0.2_build600148.zip

ecbe3585804ce27aa5d0c2c842700f50 symde-7.2.0.2_build600148.zip

79e4e4c46c5b00b35f75edcf62784939 script_for_build600148.sh

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

6.     Copyright and trademark information

© Copyright IBM Corporation 2021

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.