Interim Fix 499980 for Platform Symphony 7.1

Readme File for IBM^® Platform Symphony 7.1 Fix Pack 3

Readme File for: Platform Symphony

Product Release: 7.1 Fix Pack 2

Update Name: Fix Pack 3

Fix ID: sym-7.1-build499980-unic

Publication Date: August 31, 2018

This Fix Pack 3 for Platform Symphony 7.1 is a cumulative package that provides the latest fixes in addition to those already made available with Fix Pack 2. Apply Fix Pack 3 to management, compute, Developer Edition (DE), and client hosts in your Platform Symphony 7.1 cluster to ensure the latest fixes are available.

Contents

1. Download location

2. Installation and configuration

3. Uninstallation

4. List of interim fixes

5. Copyright and trademark information

1. Download location

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

2. Scope

Before you apply this fix pack to your cluster, note the following requirements:

Operating system

· Linux x86_64

· Windows x86_64

Product version

Platform Symphony 7.1 Fix Pack 2

Cluster type

· Platform Symphony grid cluster

· Platform Symphony Developer Edition

· Platform Symphony client

3. Installation and configuration

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

System requirements

· Linux x86_64

· Windows x86_64

Packages

Name	Description
sym7.1_lnx26-lib23-x64_build499980.tar.gz	Package for Linux management hosts
symcomp7.1_lnx26-lib23-x64_build499980.tar.gz	Package for Linux compute hosts
sym7.1-ego3.1_win-x64_build499980.msp	Packages for Windows compute hosts
sym7.1-soam7.1_win-x64_build499980.msp	Packages for Windows compute hosts
symde7.1_lnx26-lib23-x64_build499980.tar.gz	Package for Linux DE hosts
symde7.1_win-x64_build499980.zip	Packages for Windows DE hosts
symde7.1_win-x64_build499980.msp	Packages for Windows DE hosts
symclnt7.1_lnx26-lib23-x64_build499980.tar.gz	Package for Linux client hosts
symclnt7.1_win-x64_build499980.msp	Package for Windows client hosts
install_sym_linux_x86_64.sh	Shell script for Linux management backup/install/rollback

Installing on Linux management, Linux compute and Windows compute hosts

a. Log on to the master 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 in the cluster as the cluster administrator and back up files for recovery purposes. You can use the install_sym_linux_x86_64.sh script to complete the backup automatically as follows:

> source profile.platform

> ./install_sym_linux_x86_64.sh backup

The following files in your cluster will be replaced by this interim fix and must be moved to back up folder, either manually or automatically:

$EGO_TOP/gui/conf/catalina.policy

$EGO_TOP/gui/conf/server.xml

$EGO_TOP/gui/conf/catalina.properties

$EGO_TOP/gui/3.1/tomcat/bin/catalina.sh

$EGO_TOP/gui/3.1/tomcat/

$EGO_TOP/jre/3.1/linux-x86_64/

$EGO_TOP/soam/7.1/linux2.6-glibc2.3-x86_64/etc/sd

$EGO_TOP/gui/perf/3.1/perfgui/WEB-INF/classes/com/platform/perf/report/action/ReportAction.class

$EGO_TOP/gui/ego/3.1/platform/mixWithConsumerTree.jsp

$EGO_TOP/gui/ego/3.1/platform/redirect.jsp

$EGO_TOP/gui/ego/3.1/platform/consumerTree/consumerTree.jsp

$EGO_TOP/gui/3.1/lib/egogui.jar

$EGO_TOP/gui/3.1/lib/commons-ego.jar

$EGO_TOP/gui/soam/7.1/soamgui/symping/symping.jsp

$EGO_TOP/gui/soam/7.1/soamgui/WEB-INF/classes/com/platform/soam/gui/api/TaskCustomLog.class

$EGO_TOP/gui/soam/7.1/soamgui/WEB-INF/classes/com/platform/soam/gui/CommonUtilites.class

$EGO_TOP/gui/soam/7.1/soamgui/WEB-INF/classes/com/platform/soam/gui/web/wizard/CreateAppWizardOperator.class

$EGO_TOP/gui/soam/7.1/soamgui/WEB-INF/classes/com/platform/soam/gui/web/appConf/ImportAppProAction.class

$EGO_TOP/gui/soam/7.1/soamgui/WEB-INF/classes/com/platform/soam/gui/web/appConf/ExportAppProfileAction.class

$EGO_TOP/gui/soam/7.1/soamgui/WEB-INF/classes/com/platform/soam/gui/web/srvpackage/ExportDeploymentXmlAction.class

$EGO_TOP/gui/soam/7.1/soamgui/WEB-INF/classes/com/platform/soam/gui/web/srvpackage/ConfigurePackageProfileAction.class

$EGO_TOP/gui/soam/7.1/soamgui/WEB-INF/classes/com/platform/soam/gui/web/application/RegisterAppXmlAction.class

$EGO_TOP/gui/soam/7.1/soamgui/WEB-INF/classes/com/platform/soam/gui/web/wizard/importAppProActionWizard.class

$EGO_TOP/gui/soam/7.1/soamgui/WEB-INF/classes/com/platform/soam/gui/web/common/FormatXMLAction.class

$EGO_TOP/gui/soam/7.1/soamgui/WEB-INF/classes/com/platform/soam/gui/api/symping/SympingConfSetting.class

$EGO_TOP/gui/soam/7.1/symgui/WEB-INF/lib/soamgui.jar

$EGO_TOP/gui/soam/7.1/symgui/WEB-INF/classes/com/platform/gui/pmr/backend/datastore/util/PMCRackTool.class

$EGO_TOP/gui/soam/7.1/symgui/WEB-INF/classes/com/platform/gui/pmr/web/action/appConf/ExportAppProfileAction.class

$EGO_TOP/gui/soam/7.1/symgui/WEB-INF/classes/com/platform/gui/ego/mdsresplan/action/MDSResPlanDetailAction.class

$EGO_TOP/gui/soam/7.1/symgui/WEB-INF/classes/com/platform/gui/web/rest/SOAMRestResource.class

$EGO_TOP/gui/soam/7.1/symgui/WEB-INF/classes/com/platform/gui/pmr/general/mapreduce/gui/CommonUtilites.class

$EGO_TOP/gui/soam/7.1/symgui/WEB-INF/classes/com/platform/gui/pmr/web/action/applications/AddApplicationAction.class

$EGO_TOP/gui/soam/7.1/symgui/WEB-INF/classes/com/platform/gui/util/EventPolicyUtil.class

$EGO_TOP/gui/soam/7.1/symgui/WEB-INF/classes/com/platform/gui/pmr/web/service/jobs/impl/real/DefaultJobVariables.class

$EGO_TOP/gui/soam/7.1/symgui/WEB-INF/classes/com/platform/gui/pmr/general/vem/gui/api/ConsumerResourcePlanManager.class

$EGO_TOP/gui/soam/7.1/symgui/WEB-INF/classes/com/platform/gui/pmr/general/mapreduce/gui/api/TaskCustomLog.class

$EGO_TOP/gui/soam/7.1/symgui/WEB-INF/classes/com/platform/gui/pmr/general/mapreduce/gui/web/wizard/CreateAppWizardOperator.class

$EGO_TOP/gui/soam/7.1/symgui/WEB-INF/classes/com/platform/gui/pmr/general/mapreduce/gui/web/application/RegisterAppXmlAction.class

$EGO_TOP/gui/soam/7.1/symgui/WEB-INF/classes/com/platform/gui/pmr/web/action/appConf/ImportAppProAction.class

$EGO_TOP/gui/soam/7.1/symgui/WEB-INF/classes/com/platform/gui/util/FusionChartUtil.class

$EGO_TOP/gui/conf/useracl/permission_GUIPermissionSoam.acl

$EGO_TOP/gui/soam/7.1/symgui/WEB-INF/classes/com/platform/gui/framework/web/filter/ExceptionHandlerFilter.class

$EGO_TOP/asc/7.1/lib/commons-ego.jar

$EGO_TOP/gui/soam/7.1/symgui/WEB-INF/classes/com/platform/gui/framework/security/authentication/provider/EGOAuthenticationProvider.class

$EGO_TOP/gui/soam/7.1/soamgui/js/xmlFormEditor_createElement.js

$EGO_TOP/gui/soam/7.1/soamgui/servicePackage/addPackage.jsp

$EGO_TOP/gui/soam/7.1/symgui/generaltable/getDeviceInfo.jsp

$EGO_TOP/3.1/linux2.6-glibc2.3-x86_64/etc/vemkd

$EGO_TOP/soam/7.1/linux2.6-glibc2.3-x86_64/etc/ssm

$EGO_TOP/gui/ego/3.1/platform/resource/resourceProp.jsp

$EGO_TOP/gui/3.1/common_ui/WEB-INF/web.xml

$EGO_TOP/gui/perf/3.1/perfgui/WEB-INF/web.xml

$EGO_TOP/gui/soam/7.1/symgui/WEB-INF/web.xml

$EGO_TOP/gui/is/7.1/isgui/WEB-INF/web.xml

$EGO_TOP/soam/7.1/linux2.6-glibc2.3-x86_64/bin/symexecservice

$EGO_TOP/gui/ego/3.1/lib/linux2.6-glibc2.3-x86_64/libVEMApiCommon.so

$EGO_TOP/soam/mapreduce/7.1/linux2.6-glibc2.3-x86_64/lib64/libVEMApiCommon.so

$EGO_TOP/soam/mapreduce/7.1/linux2.6-glibc2.3-x86_64/lib/libVEMApiCommon.so

$EGO_TOP/3.1/linux2.6-glibc2.3-x86_64/bin/egosh

$EGO_TOP/3.1/linux2.6-glibc2.3-x86_64/lib/sec_ego_pam_default.so

$EGO_TOP/perf/3.1/lib/perf_dataloader.jar

$EGO_TOP/3.1/linux2.6-glibc2.3-x86_64/lib/policy/libslot.so

$EGO_TOP/gui/3.1/lib/perf_commons.jar

$EGO_TOP/3.1/linux2.6-glibc2.3-x86_64/etc/rs

$EGO_TOP/gui/soam/7.1/soamgui/WEB-INF/classes/com/platform/soam/gui/api/RealLogApiWrapper.class

$EGO_TOP/3.1/linux2.6-glibc2.3-x86_64/etc/egosc

$EGO_TOP/gui/soam/7.1/symgui/WEB-INF/classes/com/platform/gui/framework/pluginImpl/SymBrandServiceImpl.class

$EGO_TOP/soam/7.1/linux2.6-glibc2.3-x86_64/etc/symmkdir

$EGO_TOP/3.1/linux2.6-glibc2.3-x86_64/etc/pem

$EGO_TOP/3.1/linux2.6-glibc2.3-x86_64/etc/lim

$EGO_TOP/perf/soam/7.1/lib/perf_soam_loader.jar

$EGO_TOP/gui/soam/7.1/soamgui/WEB-INF/classes/com/platform/soam/gui/cache/AppInfoCache.class

$EGO_TOP/gui/soam/7.1/symgui/WEB-INF/classes/com/platform/gui/sym/dashboard/service/impl/real/ClusterHealthServiceImpl.class

$EGO_TOP/gui/soam/7.1/symgui/WEB-INF/classes/com/platform/gui/sym/dashboard/service/impl/real/ClusterHealthServiceImpl$1.class

$EGO_TOP/gui/soam/7.1/soamgui/WEB-INF/classes/com/platform/soam/gui/api/SOAMAppList.class

$EGO_TOP/gui/perf/3.1/perfgui/WEB-INF/classes/com/platform/perf/report/csv/GenerateCSV$RollupMethod.class

$EGO_TOP/gui/perf/3.1/perfgui/WEB-INF/classes/com/platform/perf/report/csv/GenerateCSV$1.class

$EGO_TOP/gui/perf/3.1/perfgui/WEB-INF/classes/com/platform/perf/report/csv/GenerateCustomCSV.class

$EGO_TOP/gui/perf/3.1/perfgui/WEB-INF/classes/com/platform/perf/report/csv/GenerateCSV.class

$EGO_TOP/gui/soam/7.1/soamgui/WEB-INF/classes/com/platform/soam/gui/api/SOAMResourceList.class

$EGO_TOP/gui/soam/7.1/soamgui/WEB-INF/classes/com/platform/soam/gui/api/RealSOAMApiWrapper.class

$EGO_TOP/gui/ego/3.1/platform/consumerManage/consumerManage.jsp

$EGO_TOP/gui/ego/3.1/platform/js/ResourcePlan_Functions.js

$EGO_TOP/gui/soam/7.1/symgui/sym/application/js/resourceList.js

$EGO_TOP/gui/soam/7.1/symgui/sym/application/resourceList.jsp

$EGO_TOP/gui/soam/7.1/soamgui/WEB-INF/classes/com/platform/soam/gui/api/SOAMAppConfList.class

$EGO_TOP/3.1/linux2.6-glibc2.3-x86_64/lib/sec_ego_ext_co.so

$EGO_TOP/gui/soam/7.1/soamgui/logretrieve/appLogsList.jsp

$EGO_TOP/gui/soam/7.1/soamgui/logretrieve/showTable.jsp

$EGO_TOP/gui/soam/7.1/soamgui/js/formEditor.js

$EGO_TOP/activation/linux2.6-glibc2.3-x86_64/bin/libcom_platform_ACE_544_04.so.5.4.4

$EGO_TOP/soam/7.1/linux2.6-glibc2.3-x86_64/lib64/libcom_platform_ACE_544_04.so.5.4.4

$EGO_TOP/soam/7.1/linux2.6-glibc2.3-x86_64/lib/libcom_platform_ACE_544_04.so.5.4.4

$EGO_TOP/3.1/linux2.6-glibc2.3-x86_64/lib/libcom_platform_ACE_544_04.so.5.4.4

$EGO_TOP/activation/linux2.6-glibc2.3-x86_64/bin/libcom_platform_ACE_544_04_SSL.so.5.4.4

$EGO_TOP/soam/7.1/linux2.6-glibc2.3-x86_64/lib64/libcom_platform_ACE_544_04_SSL.so.5.4.4

$EGO_TOP/soam/7.1/linux2.6-glibc2.3-x86_64/lib/libcom_platform_ACE_544_04_SSL.so.5.4.4

$EGO_TOP/3.1/linux2.6-glibc2.3-x86_64/lib/libcom_platform_ACE_544_04_SSL.so.5.4.4

$EGO_TOP/gui/soam/7.1/soamgui/WEB-INF/classes/com/platform/soam/gui/api/symping/SympingApi.class

$EGO_TOP/gui/soam/7.1/symgui/sym/application/js/blockedHostList.js

$EGO_TOP/gui/soam/7.1/symgui/pmr/applications/js/applicationblockhost.js

$EGO_TOP/gui/soam/7.1/symgui/pmr/common/js/common.js

$EGO_TOP/perf/3.1/lib/perf_purger.jar

$EGO_TOP/gui/3.1/etc/linux2.6-glibc2.3-x86_64/wsm

$EGO_TOP/soam/mapreduce/7.1/linux2.6-glibc2.3-x86_64/etc/mrss

$EGO_TOP/3.1/linux2.6-glibc2.3-x86_64/etc/pim

$EGO_TOP/gui/soam/7.1/soamgui/WEB-INF/classes/com/platform/soam/gui/api/SdUpdatePackage.class

$EGO_TOP/gui/soam/7.1/soamgui/WEB-INF/classes/com/platform/soam/gui/api/SdUpdatePackageResponse.class

$EGO_TOP/gui/soam/7.1/soamgui/WEB-INF/classes/com/platform/soam/gui/api/SdUpdatePackage$Factory.class

$EGO_TOP/gui/soam/7.1/soamgui/WEB-INF/classes/com/platform/soam/gui/api/SdUpdatePackageResponse$Factory.class

$EGO_TOP/3.1/linux2.6-glibc2.3-x86_64/lib/libvem.so

$EGO_TOP/soam/7.1/linux2.6-glibc2.3-x86_64/lib/libvem.so

$EGO_TOP/asc/7.1/lib/egogui.jar

$EGO_TOP/gui/soam/7.1/soamgui/images/Lminus.png

$EGO_TOP/gui/soam/7.1/soamgui/images/T.png

$EGO_TOP/gui/soam/7.1/soamgui/images/blank.png

$EGO_TOP/gui/soam/7.1/soamgui/images/I.png

$EGO_TOP/gui/soam/7.1/soamgui/images/icon_consumer.png

$EGO_TOP/gui/soam/7.1/soamgui/images/Lplus.png

$EGO_TOP/gui/soam/7.1/soamgui/images/icon_root.png

$EGO_TOP/gui/soam/7.1/soamgui/images/L.png

$EGO_TOP/gui/soam/7.1/soamgui/images/icon_consumer_leaf.png

$EGO_TOP/gui/soam/7.1/soamgui/images/Tminus.png

$EGO_TOP/gui/soam/7.1/soamgui/images/Tplus.png

$EGO_TOP/gui/soam/7.1/soamgui/js/servPackEditor.js

$EGO_TOP/soam/7.1/linux2.6-glibc2.3-x86_64/lib/JavaSoamApi.jar

$EGO_TOP/soam/7.1/linux2.6-glibc2.3-x86_64/lib64/libjnativesoamapi_7.1.0_64.so

$EGO_TOP/soam/7.1/linux2.6-glibc2.3-x86_64/lib64/libsoambase.so

$EGO_TOP/soam/7.1/linux2.6-glibc2.3-x86_64/lib/libsoambase.so

$EGO_TOP/soam/7.1/linux2.6-glibc2.3-x86_64/lib/libjnativesoamapi_7.1.0.so

$EGO_TOP/3.1/linux2.6-glibc2.3-x86_64/bin/utils/unzip

$EGO_TOP/soam/7.1/linux2.6-glibc2.3-x86_64/bin/utils/unzip

$EGO_TOP/3.1/linux2.6-glibc2.3-x86_64/etc/elim.host_info

$EGO_TOP/soam/mapreduce/7.1/linux2.6-glibc2.3-x86_64/lib/hadoop-2.6.0/jackson-annotations-2.2.3.jar

$EGO_TOP/soam/mapreduce/7.1/linux2.6-glibc2.3-x86_64/lib/hadoop-2.6.0/jackson-core-2.2.3.jar

$EGO_TOP/soam/mapreduce/7.1/linux2.6-glibc2.3-x86_64/lib/hadoop-2.6.0/jackson-databind-2.2.3.jar

$EGO_TOP/gui/3.1/lib/commons-fileupload-1.3.1.jar

$EGO_TOP/gui/soam/7.1/symgui/WEB-INF/lib/commons-fileupload-1.3.1.jar

$EGO_TOP/gui/3.1/lib/commons-io-1.2.jar

$EGO_TOP/gui/soam/7.1/symgui/WEB-INF/lib/org.apache.commons-io-1.4.jar

$EGO_TOP/gui/soam/7.1/symgui/WEB-INF/lib/commons-lang3-3.1.jar

$EGO_TOP/gui/perf/3.1/perfgui/WEB-INF/lib/freemarker-2.3.18.jar

$EGO_TOP/gui/soam/7.1/symgui/WEB-INF/lib/freemarker-2.3.18.jar

$EGO_TOP/gui/soam/7.1/symgui/WEB-INF/lib/javassist-3.9.0.GA.jar

$EGO_TOP/gui/perf/3.1/perfgui/WEB-INF/lib/ognl-3.0.6.jar

$EGO_TOP/gui/soam/7.1/symgui/WEB-INF/lib/ognl-3.0.6.jar

$EGO_TOP/gui/perf/3.1/perfgui/WEB-INF/lib/struts2-core-2.3.16.3.jar

$EGO_TOP/gui/soam/7.1/symgui/WEB-INF/lib/struts2-core-2.3.16.3.jar

$EGO_TOP/gui/soam/7.1/symgui/WEB-INF/lib/struts2-json-plugin-2.3.16.3.jar

$EGO_TOP/gui/soam/7.1/symgui/WEB-INF/lib/struts2-spring-plugin-2.3.16.3.jar

$EGO_TOP/gui/soam/7.1/symgui/WEB-INF/lib/velocity-1.5.jar

$EGO_TOP/gui/soam/7.1/symgui/WEB-INF/lib/xstream-1.4.2.jar

$EGO_TOP/gui/perf/3.1/perfgui/WEB-INF/lib/xwork-core-2.3.16.3.jar

$EGO_TOP/gui/soam/7.1/symgui/WEB-INF/lib/xwork-core-2.3.16.3.jar

$EGO_TOP/gui/3.1/lib/commons-collections-3.2.1.jar

$EGO_TOP/perf/3.1/lib/commons-collections-3.1.jar

$EGO_TOP/soam/mapreduce/7.1/linux2.6-glibc2.3-x86_64/lib/commons-collections-3.2.1.jar

c. On each management host, copy the sym7.1_lnx26-lib23-x64_build499980.tar.gz package and decompress it to the $EGO_TOP installation directory:

> tar zxfo sym7.1_lnx26-lib23-x64_build499980.tar.gz -C $EGO_TOP

Note: You can use the install_sym_linux_x86_64.sh script to complete the installation automatically as follows:

> source profile.platform

> ./install_sym_linux_x86_64.sh install

a) If you ran the “egoconfig mghost shared_dir” command during installation to set up a shared location for configuration files, ensure that the configuration file is changed in the shared directory:

> cp $EGO_TOP/gui/conf/catalina.policy $EGO_CONFDIR/../../gui/conf/catalina.policy

> cp $EGO_TOP/gui/conf/catalina.properties $EGO_CONFDIR/../../gui/conf/catalina.properties

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

b) If you modified the $EGO_CONFDIR/../../gui/conf/server.xml configuration file for details such as the GUI service port, manually redo those changes.

d. On each management host, modify the following configuration files:

a) Edit the $EGO_CONFDIR/../../gui/conf/web.xml file as follows:

<welcome-file-list>

...

</welcome-file-list>

<security-constraint>

<web-resource-collection>

<web-resource-name>Restrict for ALL</web-resource-name>

<url-pattern>/*</url-pattern>

<http-method>HEAD</http-method>

<http-method>OPTIONS</http-method>

<http-method>TRACE</http-method>

</web-resource-collection>

<auth-constraint>

</auth-constraint>

</security-constraint>

<security-constraint>

...

</security-constraint>

b) Edit the $EGO_TOP/gui/ego/3.1/platform/WEB-INF/web.xml file as follows:

<filter-mapping>

...

</filter-mapping>

<filter>

<filter-name>RestAPISecurityFilter</filter-name>

<filter-class>com.platform.common.gui.rest.RestAPISecurityFilter</filter-class>

</filter>

<filter-mapping>

<filter-name>RestAPISecurityFilter</filter-name>

<url-pattern>/rest/ego/*</url-pattern>

</filter-mapping>

c) Edit the $EGO_CONFDIR/../../eservice/esc/conf/services/sd.xml file as follows:

<sc:ActivityDescription>

<ego:Attribute name="hostType" type="xsd:string">X86_64</ego:Attribute>

<ego:ActivitySpecification>

....

<ego:EnvironmentVariable name="SSM_CREATE_SUB_DIRECTORY_WITH_HISTORY_PERMISSIONS">y</ego:EnvironmentVariable>

.....

</ego:ActivitySpecification>

</sc:ActivityDescription>

d) Ensure that the owner of the symmkdir file is the same as the SD owner, then change permissions to ensure that the symmkdir file can be executed by all SSMs with the SD owner:

> chmod 4xxx symmkdir

where “xxx” is the permission that allows all SSMs to run symmkdir.

e) Edit the $EGO_TOP/soam/profiles/enabled/symexec7.1.xml file as follows:

f) Edit the $EGO_TOP/gui/ego/3.1/platform/WEB-INF/web.xml and $EGO_TOP/gui/soam/7.1/soamgui/WEB-INF/web.xml files as follows:

<servlet-name>dwr-invoker</servlet-name>

<servlet-class>org.directwebremoting.servlet.DwrServlet</servlet-class>

<init-param>

<param-name>debug</param-name>

<param-value>true</param-value>

</init-param>

             <init-param>
                 <param-name>crossDomainSessionSecurity</param-name>
                 <param-value>false</param-value>
             </init-param>

</servlet>

g) Edit the $EGO_CONFDIR/../../gui/conf/pmcconf/pmc_conf_ego.xml file as follows:

<Parameter>
<Name>hideInternalResourceGroup</Name>

<Value>InternalResourceGroup;MapReduceInternalResourceGroup;DataNodeRG;NameNodeRG;SecondaryNodeRG;</Value>
</Parameter>

e. On each management host, delete all subdirectories and files in the GUI work directory:

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

f. Open a web browser and clear your browser cache.

g. Log on to each Linux compute host in the cluster and back up the following files, which will be replaced by this interim fix:

$EGO_TOP/soam/7.1/linux2.6-glibc2.3-x86_64/etc/sim

$EGO_TOP/soam/7.1/linux2.6-glibc2.3-x86_64/bin/symexecservice

$EGO_TOP/3.1/linux2.6-glibc2.3-x86_64/bin/egosh

$EGO_TOP/3.1/linux2.6-glibc2.3-x86_64/etc/pem

$EGO_TOP/3.1/linux2.6-glibc2.3-x86_64/etc/lim

$EGO_TOP/3.1/linux2.6-glibc2.3-x86_64/lib/sec_ego_pam_default.so

$EGO_TOP/3.1/linux2.6-glibc2.3-x86_64/lib/sec_ego_ext_co.so

$EGO_TOP/soam/7.1/linux2.6-glibc2.3-x86_64/lib/libsoambase.so

$EGO_TOP/soam/7.1/linux2.6-glibc2.3-x86_64/lib/JavaSoamApi.jar

$EGO_TOP/soam/7.1/linux2.6-glibc2.3-x86_64/lib64/libjnativesoamapi_7.1.0_64.so

$EGO_TOP/soam/7.1/linux2.6-glibc2.3-x86_64/lib64/libsoambase.so

$EGO_TOP/soam/7.1/linux2.6-glibc2.3-x86_64/lib/libjnativesoamapi_7.1.0.so

$EGO_TOP/3.1/linux2.6-glibc2.3-x86_64/etc/elim.host_info

h. On each Linux compute host, copy the symcomp7.1_lnx26-lib23-x64_build499980.tar.gz package and decompress it to the $EGO_TOP installation directory:

> tar zxfo symcomp7.1_lnx26-lib23-x64_build499980.tar.gz -C $EGO_TOP

i. On each Windows compute host, copy the sym7.1-ego3.1_win-x64_build499980.msp and sym7.1-soam7.1_win-x64_build499980.msp packages, and complete one of the following steps:

· To perform an interactive installation, double-click the sym7.1-ego3.1_win-x64_build499980.msp package and follow the prompts. Then, click the sym7.1-soam7.1_win-x64_build499980.msp package and follow the prompts.

· To perform a silent installation from the Platform Symphony command line, enter the following commands:

C:\>msiexec /update C:\sym7.1-ego3.1_win-x64_build499980.msp /l*v updateEgo.log /norestart /quiet REINSTALLMODE=omus

C:\>msiexec /update C:\sym7.1-soam7.1_win-x64_build499980.msp /l*v updateSoam.log /norestart /quiet REINSTALLMODE=omus

The command syntax is as follows:

C:\>msiexec /update sym_package_name_path /l*v sym_install_log /norestart /quiet REINSTALLMODE=omus

where:

o sym_package_name_path is the fully qualified path to the .msp packages.

o sym_install_log is the log file for the upgrade.

j. Run the “pversions” command to verify the installation. For example:

> pversions

Platform EGO 3.1.0

Update for Symphony 7.1.0: (build"345782"), (build"499980")

IBM Platform Symphony 7.1.0

Update for Symphony 7.1.0: (build"345782"), (build"499980")

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

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

> egosh ego start all

> soamcontrol app enable AppName

Installing on Linux DE hosts

a. Log on to each DE host as the cluster administrator and stop the agent:

> source profile.platform

> soamshutdown

b. On each DE host, move the following files to back up folder, which will be replaced by this interim fix:

$SOAM_HOME/7.1/linux2.6-glibc2.3-x86_64/lib64/libsoambase.so

$SOAM_HOME/7.1/linux2.6-glibc2.3-x86_64/lib64/libjnativesoamapi_7.1.0_64.so

$SOAM_HOME/7.1/linux2.6-glibc2.3-x86_64/lib/JavaSoamApi.jar

$SOAM_HOME/7.1/linux2.6-glibc2.3-x86_64/lib/libsoambase.so

$SOAM_HOME/7.1/linux2.6-glibc2.3-x86_64/lib/libjnativesoamapi_7.1.0.so

$SOAM_HOME/7.1/include/SoamInterfaces.h

$SOAM_HOME/7.1/include/SoamSessionUpdateAttributes.h

$SOAM_HOME/7.1/src/SoamSessionUpdateAttributes.cpp

$SOAM_HOME/gui/3.1/lib/commons-collections-3.2.1.jar

$SOAM_HOME/gui/3.1/lib/commons-digester-1.8_1.jar

$SOAM_HOME/gui/3.1/lib/commons-fileupload-1.3.1.jar

$SOAM_HOME/gui/3.1/lib/commons-io-1.2.jar

$SOAM_HOME/gui/3.1/lib/commons-logging-1.1.1.jar

$SOAM_HOME/gui/soam/7.1/symgui/WEB-INF/lib/commons-fileupload-1.3.1.jar

$SOAM_HOME/gui/soam/7.1/symgui/WEB-INF/lib/commons-lang3-3.1.jar

$SOAM_HOME/gui/soam/7.1/symgui/WEB-INF/lib/freemarker-2.3.18.jar

$SOAM_HOME/gui/soam/7.1/symgui/WEB-INF/lib/javassist-3.9.0.GA.jar

$SOAM_HOME/gui/soam/7.1/symgui/WEB-INF/lib/ognl-3.0.6.jar

$SOAM_HOME/gui/soam/7.1/symgui/WEB-INF/lib/org.apache.commons-io-1.4.jar

$SOAM_HOME/gui/soam/7.1/symgui/WEB-INF/lib/struts2-core-2.3.16.3.jar

$SOAM_HOME/gui/soam/7.1/symgui/WEB-INF/lib/struts2-json-plugin-2.3.16.3.jar

$SOAM_HOME/gui/soam/7.1/symgui/WEB-INF/lib/struts2-spring-plugin-2.3.16.3.jar

$SOAM_HOME/gui/soam/7.1/symgui/WEB-INF/lib/xwork-core-2.3.16.3.jar

c. Copy the symde7.1_lnx26-lib23-x64_build499980.tar.gz package and decompress it to the $SOAM_HOME installation directory:

> tar zxfo sym7.1_lnx26-lib23-x64_build499980.tar.gz -C $SOAM_HOME

d. On each DE host, delete all subdirectories and files in the GUI work directory:

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

e. Open a web browser and clear your browser cache.

f. Log on to the DE host as the cluster administrator and start the agent:

> soamstartup &

Installing on Linux client hosts

a. Log on to each client host as the cluster administrator and set the environment:

> source profile.platform

b. On each client host, back up the following files, which will be replaced by this interim fix:

$SOAM_HOME/lib/JavaSoamApi.jar

$SOAM_HOME/lib64/libjnativesoamapi_7.1.0_64.so

$SOAM_HOME/lib64/libsoambase.so

$SOAM_HOME/lib/libsoambase.so

$SOAM_HOME/lib/libjnativesoamapi_7.1.0.so

c. Copy the symclnt7.1_lnx26-lib23-x64_build499980.tar.gz package and decompress it to the $SOAM_HOME installation directory:

> tar zxfo symclnt7.1_lnx26-lib23-x64_build499980.tar.gz -C $SOAM_HOME

Installing on Windows DE hosts

a. Log on to each DE host as the cluster administrator and stop the agent:

> soamshutdown

b. On each DE host, move the following files to back up folder, which will be replaced by this interim fix:

%SOAM_HOME%\7.1\w2k3_x64-vc7-psdk\lib64\soambase.dll

%SOAM_HOME%\7.1\w2k3_x64-vc7-psdk\lib64\soambase.lib

%SOAM_HOME%\7.1\w2k3_x64-vc7-psdk\lib64\soambase.pdb

%SOAM_HOME%\7.1\w2k3_x64-vc7-psdk\lib\soambase.dll

%SOAM_HOME%\7.1\w2k3_x64-vc7-psdk\lib\soambase.lib

%SOAM_HOME%\7.1\w2k3_x64-vc7-psdk\lib\soambase.pdb

%SOAM_HOME%\7.1\w2k3_x64-vc7-psdk\lib64\jnativesoamapi_7.1.0_64.dll

%SOAM_HOME%\7.1\w2k3_x64-vc7-psdk\lib64\jnativesoamapi_7.1.0_64.pdb

%SOAM_HOME%\7.1/w2k3_x64-vc7-psdk/lib/JavaSoamApi.jar

%SOAM_HOME%\7.1\w2k3_x64-vc7-psdk\lib\jnativesoamapi_7.1.0.dll

%SOAM_HOME%\7.1\w2k3_x64-vc7-psdk\lib\jnativesoamapi_7.1.0.pdb

%SOAM_HOME%\7.1\include\SoamInterfaces.h

%SOAM_HOME%\7.1\include\SoamSessionUpdateAttributes.h

%SOAM_HOME%\7.1\src\SoamSessionUpdateAttributes.cpp

%SOAM_HOME%\gui\3.1\lib\commons-collections-3.2.1.jar

%SOAM_HOME%\gui\3.1\lib\commons-digester-1.8_1.jar

%SOAM_HOME%\gui\3.1\lib\commons-fileupload-1.3.1.jar

%SOAM_HOME%\gui\3.1\lib\commons-io-1.2.jar

%SOAM_HOME%\gui\3.1\lib\commons-logging-1.1.1.jar

%SOAM_HOME%\gui\soam\7.1\symgui\WEB-INF\lib\commons-fileupload-1.3.1.jar

%SOAM_HOME%\gui\soam\7.1\symgui\WEB-INF\lib\commons-lang3-3.1.jar

%SOAM_HOME%\gui\soam\7.1\symgui\WEB-INF\lib\freemarker-2.3.18.jar

%SOAM_HOME%\gui\soam\7.1\symgui\WEB-INF\lib\javassist-3.9.0.GA.jar

%SOAM_HOME%\gui\soam\7.1\symgui\WEB-INF\lib\ognl-3.0.6.jar

%SOAM_HOME%\gui\soam\7.1\symgui\WEB-INF\lib\struts2-core-2.3.16.3.jar

%SOAM_HOME%\gui\soam\7.1\symgui\WEB-INF\lib\struts2-json-plugin-2.3.16.3.jar

%SOAM_HOME%\gui\soam\7.1\symgui\WEB-INF\lib\struts2-spring-plugin-2.3.16.3.jar

%SOAM_HOME%\gui\soam\7.1\symgui\WEB-INF\lib\xwork-core-2.3.16.3.jar

%SOAM_HOME%\gui\soam\7.1\symgui\WEB-INF\lib\org.apache.commons-io-1.4.jar

c. Copy the symde7.1_win-x64_build499980.zip package and decompress it to the %SOAM_HOME% installation directory:

d. Copy the symde7.1_win-x64_build499980.msp package and complete one of the following steps:

· To perform an interactive installation, double-click the .msp package and follow the prompts.

· To perform a silent installation from the Platform Symphony command line, enter the following command:

C:\>msiexec /update C:\symde7.1_win-x64_build499980.msp /l*v updateDE.log /norestart /quiet REINSTALLMODE=omus

The command syntax is as follows:

C:\>msiexec /update sym_package_name_path /l*v sym_install_log /norestart /quiet REINSTALLMODE=omus

where:

o sym_package_name_path is the fully qualified path to the .msp package.

o sym_install_log is the log file for the upgrade.

e. Go to Control Panel > Programs and Features > View installed updates, check Update for Symphony 7.1.0 (build “499980”).

f. On each DE host, delete all subdirectories and files in the GUI work directory:

%SOAM_HOME%/gui/work/*

g. Open a web browser and clear your browser cache.

h. Log on to the DE host as the cluster administrator and start the agent:

> soamstartup

Installing on Windows client hosts

a. Log on to each client host as the cluster administrator.

b. On each client host, copy the symclnt7.1_win-x64_build499980.msp package and complete one of the following steps:

· To perform an interactive installation, double-click the .msp package and follow the prompts.

· To perform a silent installation from the Platform Symphony command line, enter the following command:

C:\>msiexec /update C:\symclnt7.1_win-x64_build499980.msp /l*v updateclnt.log /norestart /quiet REINSTALLMODE=omus

The command syntax is as follows:

C:\>msiexec /update sym_package_name_path /l*v sym_install_log /norestart /quiet REINSTALLMODE=omus

where:

o sym_package_name_path is the fully qualified path to the .msp package.

o sym_install_log is the log file for the upgrade.

c. Go to Control Panel > Programs and Features > View installed updates, check Update for Symphony 7.1.0 (build “499980”).

4. Uninstallation

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

Uninstalling on Linux management, Linux compute and Windows compute hosts

a. Log on to the master 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 in the cluster, use the install_sym_linux_x86_64.sh script to totally and automatically roll back the installation as follows:

> source profile.platform

> ./install_sym_linux_x86_64.sh rollback

Or, manually remove the following higher version files, then restore the original files from your backup:

$EGO_TOP/gui/3.1/lib/commons-collections-3.2.2.jar

$EGO_TOP/gui/3.1/lib/commons-fileupload-1.3.2.jar

$EGO_TOP/gui/3.1/lib/commons-io-2.2.jar

$EGO_TOP/gui/3.1/lib/commons-lang3-3.2.jar

$EGO_TOP/gui/3.1/tomcat

$EGO_TOP/gui/perf/3.1/perfgui/WEB-INF/lib/freemarker-2.3.22.jar

$EGO_TOP/gui/perf/3.1/perfgui/WEB-INF/lib/ognl-3.0.21.jar

$EGO_TOP/gui/perf/3.1/perfgui/WEB-INF/lib/struts2-core-2.3.34.jar

$EGO_TOP/gui/perf/3.1/perfgui/WEB-INF/lib/xwork-core-2.3.34.jar

$EGO_TOP/gui/soam/7.1/symgui/WEB-INF/lib/commons-fileupload-1.3.2.jar

$EGO_TOP/gui/soam/7.1/symgui/WEB-INF/lib/commons-io-2.2.jar

$EGO_TOP/gui/soam/7.1/symgui/WEB-INF/lib/commons-lang3-3.2.jar

$EGO_TOP/gui/soam/7.1/symgui/WEB-INF/lib/freemarker-2.3.22.jar

$EGO_TOP/gui/soam/7.1/symgui/WEB-INF/lib/javassist-3.11.0.GA.jar

$EGO_TOP/gui/soam/7.1/symgui/WEB-INF/lib/ognl-3.0.21.jar

$EGO_TOP/gui/soam/7.1/symgui/WEB-INF/lib/struts2-core-2.3.34.jar

$EGO_TOP/gui/soam/7.1/symgui/WEB-INF/lib/struts2-json-plugin-2.3.34.jar

$EGO_TOP/gui/soam/7.1/symgui/WEB-INF/lib/struts2-spring-plugin-2.3.34.jar

$EGO_TOP/gui/soam/7.1/symgui/WEB-INF/lib/velocity-1.6.4.jar

$EGO_TOP/gui/soam/7.1/symgui/WEB-INF/lib/xstream-1.4.10.jar

$EGO_TOP/gui/soam/7.1/symgui/WEB-INF/lib/xwork-core-2.3.34.jar

$EGO_TOP/jre/3.1/linux-x86_64

$EGO_TOP/perf/3.1/lib/commons-collections-3.2.2.jar

$EGO_TOP/soam/7.1/linux2.6-glibc2.3-x86_64/etc/symmkdir

$EGO_TOP/soam/mapreduce/7.1/linux2.6-glibc2.3-x86_64/lib/commons-collections-3.2.2.jar

$EGO_TOP/soam/mapreduce/7.1/linux2.6-glibc2.3-x86_64/lib/hadoop-2.6.0/jackson-annotations-2.9.3.jar

$EGO_TOP/soam/mapreduce/7.1/linux2.6-glibc2.3-x86_64/lib/hadoop-2.6.0/jackson-core-2.9.3.jar

$EGO_TOP/soam/mapreduce/7.1/linux2.6-glibc2.3-x86_64/lib/hadoop-2.6.0/jackson-databind-2.9.3.jar

c. Check the shared_dir files:

> cp $EGO_TOP/gui/conf/catalina.policy $EGO_CONFDIR/../../gui/conf/catalina.policy

> cp $EGO_TOP/gui/conf/catalina.properties $EGO_CONFDIR/../../gui/conf/catalina.properties

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

b) If you modified the $EGO_CONFDIR/../../gui/conf/server.xml configuration file for details such as the GUI service port, manually redo those changes.

d. Remove the configurations updated during installation.

e. On each management host, delete all subdirectories and files in the GUI work directory:

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

f. Open a web browser and clear your browser cache.

g. Log on to each Linux compute host in the cluster and restore the files that you backed up during installation.

h. Log on to each Windows compute host in the cluster, roll back to the previous version either from the Windows Control Panel or from the Platform Symphony command line:

· To roll back from the Windows Control Panel, go to Control Panel > Programs and Features > View installed updates, click Update for Symphony 7.1.0 (build “499980”), and click Uninstall.

· To roll back from the Platform Symphony command line, enter the following command:

C:\msiexec /uninstall {3F079FA5-EF28-4A9D-BCF4-0E42F1C1D3CC} /package {555A2738-A103-40AD-84A2-7BFAA2697296} /norestart /quiet /l*v sym_rollbackSoam.log

C:\msiexec /uninstall {35F0BD25-D4C2-4A5A-AAE2-5039B2F59E96} /package {C45B1816-5299-4893-A88D-C11621C02B9D} /norestart /quiet /l*v sym_rollbackEgo.log

The command syntax is as follows:

C:\>msiexec /uninstall interim_fix_code /package product_code /norestart /quiet /l*v rollback_log

where:

o interim_fix_code is the identifier of the .msp package for the interim fix; in this case, {3F079FA5-EF28-4A9D-BCF4-0E42F1C1D3CC} and {35F0BD25-D4C2-4A5A-AAE2-5039B2F59E96}.

o product_code is the identifier of the .msi file in the original product installation package; in this case, {555A2738-A103-40AD-84A2-7BFAA2697296} and {C45B1816-5299-4893-A88D-C11621C02B9D}.

o rollback_log is the name of the log file to capture details of the interim fix rollback; in this case, sym_rollback.log.

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

> egosh ego start all

> soamcontrol app enable AppName

Uninstalling on Linux DE hosts

a. Log on to each DE host as the cluster administrator and stop the agent:

> source profile.platform

> soamshutdown

b. On each DE host, remove the following higher version files introduced by this interim fix, then restore the original files from your backup:

$SOAM_HOME/gui/soam/7.1/symgui/WEB-INF/lib/commons-io-2.2.jar

$SOAM_HOME/gui/soam/7.1/symgui/WEB-INF/lib/commons-fileupload-1.3.2.jar

$SOAM_HOME/gui/soam/7.1/symgui/WEB-INF/lib/commons-lang3-3.2.jar

$SOAM_HOME/gui/soam/7.1/symgui/WEB-INF/lib/freemarker-2.3.22.jar

$SOAM_HOME/gui/soam/7.1/symgui/WEB-INF/lib/javassist-3.11.0.GA.jar

$SOAM_HOME/gui/soam/7.1/symgui/WEB-INF/lib/ognl-3.0.21.jar

$SOAM_HOME/gui/soam/7.1/symgui/WEB-INF/lib/struts2-core-2.3.34.jar

$SOAM_HOME/gui/soam/7.1/symgui/WEB-INF/lib/struts2-json-plugin-2.3.34.jar

$SOAM_HOME/gui/soam/7.1/symgui/WEB-INF/lib/struts2-spring-plugin-2.3.34.jar

$SOAM_HOME/gui/soam/7.1/symgui/WEB-INF/lib/xwork-core-2.3.34.jar

$SOAM_HOME/gui/soam/7.1/symgui/WEB-INF/lib/xstream-1.4.10.jar

$SOAM_HOME/gui/soam/7.1/symgui/WEB-INF/lib/velocity-1.6.4.jar

$SOAM_HOME/gui/3.1/lib/commons-collections-3.2.2.jar

$SOAM_HOME/gui/3.1/lib/commons-digester-2.0.jar

$SOAM_HOME/gui/3.1/lib/commons-fileupload-1.3.2.jar

$SOAM_HOME/gui/3.1/lib/commons-io-2.2.jar

$SOAM_HOME/gui/3.1/lib/commons-lang3-3.2.jar

$SOAM_HOME/gui/3.1/lib/commons-logging-1.1.3.jar

c. On each DE host, delete all subdirectories and files in the GUI work directory:

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

d. Open a web browser and clear your browser cache.

e. Log on to the DE host as the cluster administrator and start the agent:

> soamstartup &

Uninstalling on Linux client hosts

a. Log on to each client host as the cluster administrator and set the environment:

> source profile.platform

b. On each host, restore the files that you backed up during installation.

Uninstalling on Windows DE hosts

a. Log on to each DE host as the cluster administrator and stop the agent:

> soamshutdown

b. On each DE host, remove the following higher version files introduced by this interim fix, then restore the original files from your backup:

%SOAM_HOME%\gui\soam\7.1\symgui\WEB-INF\lib\commons-io-2.2.jar

%SOAM_HOME%\gui\soam\7.1\symgui\WEB-INF\lib\commons-fileupload-1.3.2.jar

%SOAM_HOME%\gui\soam\7.1\symgui\WEB-INF\lib\commons-lang3-3.2.jar

%SOAM_HOME%\gui\soam\7.1\symgui\WEB-INF\lib\freemarker-2.3.22.jar

%SOAM_HOME%\gui\soam\7.1\symgui\WEB-INF\lib\javassist-3.11.0.GA.jar

%SOAM_HOME%\gui\soam\7.1\symgui\WEB-INF\lib\ognl-3.0.21.jar

%SOAM_HOME%\gui\soam\7.1\symgui\WEB-INF\lib\struts2-core-2.3.34.jar

%SOAM_HOME%\gui\soam\7.1\symgui\WEB-INF\lib\struts2-json-plugin-2.3.34.jar

%SOAM_HOME%\gui\soam\7.1\symgui\WEB-INF\lib\struts2-spring-plugin-2.3.34.jar

%SOAM_HOME%\gui\soam\7.1\symgui\WEB-INF\lib\xwork-core-2.3.34.jar

%SOAM_HOME%\gui\soam\7.1\symgui\WEB-INF\lib\xstream-1.4.10.jar

%SOAM_HOME%\gui\soam\7.1\symgui\WEB-INF\lib\velocity-1.6.4.jar

%SOAM_HOME%\gui\3.1\lib\commons-collections-3.2.2.jar

%SOAM_HOME%\gui\3.1\lib\commons-digester-2.0.jar

%SOAM_HOME%\gui\3.1\lib\commons-fileupload-1.3.2.jar

%SOAM_HOME%\gui\3.1\lib\commons-io-2.2.jar

%SOAM_HOME%\gui\3.1\lib\commons-lang3-3.2.jar

%SOAM_HOME%\gui\3.1\lib\commons-logging-1.1.3.jar

c. Roll back to the previous version either from the Windows Control Panel or from the Platform Symphony command line:

· To roll back from the Windows Control Panel, go to Control Panel > Programs and Features > View installed updates, click Update for Symphony 7.1.0 (build “499980”), and click Uninstall.

· To roll back from the Platform Symphony command line, enter the following command:

C:\msiexec /uninstall {D20B88B7-F547-4CE8-92EE-DD0024FDBAE3} /package {4AE5AC79-E24B-42B2-9D12-6DB6E9EC41BD} /norestart /quiet /l*v sym_rollback.log

The command syntax is as follows:

C:\>msiexec /uninstall interim_fix_code /package product_code /norestart /quiet /l*v rollback_log

where:

o interim_fix_code is the identifier of the .msp package for the interim fix; in this case, {D20B88B7-F547-4CE8-92EE-DD0024FDBAE3}.

o product_code is the identifier of the .msi file in the original product installation package; in this case, {4AE5AC79-E24B-42B2-9D12-6DB6E9EC41BD}.

o rollback_log is the name of the log file to capture details of the interim fix rollback; in this case, sym_rollback.log.

d. On each DE host, delete all subdirectories and files in the GUI work directory:

%SOAM_HOME%/gui/work/*

e. Open a web browser and clear your browser cache.

f. Log on to the DE host as the cluster administrator and start the agent:

> soamstartup

Uninstalling on Windows client hosts

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

b. Roll back to the previous version either from the Windows Control Panel or from the Platform Symphony command line:

· To roll back from the Windows Control Panel, go to Control Panel > Programs and Features > View installed updates, click Update for Symphony 7.1.0 (build “499980”), and click Uninstall.

· To roll back from the Platform Symphony command line, enter the following command:

C:\msiexec /uninstall {0910BD5F-24C1-4307-ACB4-FC4D799C85C9} /package {5FDF6EA5-0B86-4717-9139-8A6740C9C9A5} /norestart /quiet /l*v sym_rollback.log

The command syntax is as follows:

C:\>msiexec /uninstall interim_fix_code /package product_code /norestart /quiet /l*v rollback_log

where:

o interim_fix_code is the identifier of the .msp package for the interim fix; in this case, {0910BD5F-24C1-4307-ACB4-FC4D799C85C9}.

o product_code is the identifier of the .msi file in the original product installation package; in this case, {5FDF6EA5-0B86-4717-9139-8A6740C9C9A5}.

o rollback_log is the name of the log file to capture details of the interim fix rollback; in this case, sym_rollback.log.

5. List of interim fixes

Interim Fix ID	Summary
347690	Within PMC, the Resource Plan page does not show the “Slot allocation policy” section for user with Admin permission (not the built-in Cluster Admin user role).
350652	Adding a package dependency from the PMC on Microsoft Internet Explorer 10 fails with error message “Fatal error at line 1, column 1: Invalid document structure”.
351346	In a Platform Symphony and LSF cluster environment, there is a repeated licensing warning in the master lim.
351347	When attempting to retrieve the SSM log for multiple selected hosts using PMC, it fails to retrieve any SSM logs and shows “NODATA” error.
351726	If the logged-on user is not assigned to any consumer and accesses the LSF jobs page, the WEBGUI service will crash and restart.
351963	The EGO shell (egosh) exits with code greater than 0, if you run the egosh command with unsupported or missing input values.
353105	Display cluster name on PMC main console page for window title.
353266	When viewing a package dependency using PMC, it fails to clearly show the package dependencies in the tree hierarchy.
353956	When the EGO_RBAC_COMPATIBILITY parameter is enabled, the egosh rg -l command does not return the appropriate results.
357645	Java service instance will crash on Windows.
362597	This fix addresses high and medium web AppScan issues reported for the EGO server.
364944	When there are many Java threads calling PMC configuration files by using the WEBGUI service, in race conditions, this results in two Java threads, each with CPU usage reaching 99%.
366001	Misleading error message in SIM logs about blocked hosts.
366258	This fix resolves the VEMKD core dumping if there is a long value for the client name attribute in vem_register().
366295	This fix resolves the issue of encountering an exception on the PMC when you add a package dependency.
366600	Regardless of the log level setting, the EGO security plug-in log file contains DEBUG level messages.
368921	The Client JVM could cause a core dump after running the client sample.
372501	The Kerberos vemkd-pem authentication failed.
372507	This fix resolves issues caused when the SSM consumer execution user is not in the same user group as the cluster administrator user.
375368	Apache Commons Collections requires update to 3.2.2 to fix COLLECTIONS-580.
375780	For an environment with both Platform Symphony 7.1 and LSF 9.1.1, there is a compatibility issue with the PIM file.
375782	Upgrading IBM JRE to 6.0 SR16FP15 or 7.0 SR9FP20 for use with Platform Symphony.
377118	The Platform Symphony client may create multiple connections to the same SSM.
379621	Three MapReduce-related issues: the MapReduce shuffle service (MRSS) crashes, MapReduce jobs cannot complete, and SSM crashes.
381745	When the WEBGUI service's memory usage exceeds the value indicated in the MEM_HIGH_MARK setting within the wsm.conf file, WSM (web server manager) will restart the WEBGUI service and fail to register the client.
382168	When the data purger uses an Oracle database to clean up Platform Enterprise Reporting Framework (PERF) data, the data purger throws an exception, which causes the purger to not function.
386792	The VEMKD process crashes when starting a service in which an execution user is defined but no corresponding consumer execution user is defined.
388480	Upgrade IBM JRE to 6.0 SR16FP20, 7.0 SR9FP30, or 8.0 SR2FP10 for use with Platform Symphony.
393036	If the InstanceToSlotRatio feature is enabled, VEMKD core dumps when reclaiming allocation.
394068	Unable to view details for a blocked host and see the allocation ID for the host within the Platform Management Console.
394277	The order clause in consumer resReq does not function.
394545	on dashboard, the symphony application list should use cache to enhance performance.
394603	This fix enhances the common data update feature of IBM Platform Symphony, providing a new API to ignore all the obsolete common data updates.
396094	Issue while writing history data into files because of invalid file handles.
396388	When attempting to retrieve logs for more than one host using the Platform Management Console, the system retrieves no logs and shows an error message.
398458	VEMKD core dumps when using logging at the DEBUG level.
398595	On the PMC Dashboard branding area, it shows “IBM Platform Symphony Express Edition” while it should be “IBM Platform Symphony Advanced Edition”.
398762	Upgrading Apache Tomcat to version 6.0.45 for use with Platform Symphony 7.1.
399373	When egosc startup very slowly, the existing EGO service processes may get killed by EGO.
400766	The Platform Symphony client may crash or hang when the SSM connection is unstable.
401818	The service instance manager (SIM) kills a critical system process, causing Windows to no longer function and require a system reboot.
402863	The Platform Symphony client to session director (SD) error connection is reset.
403839	A user role without EGO_CONSUMER_CONTROL and EGO_CONSUMER_MODIFY permissions cannot see the global actions list on the Application Profile page within the Platform Management Console.
404589	Unable to check the Heuristic host blocking check box on the Platform Symphony Application Profiles page within the management console.
406230	If the InstanceToSlotRatio feature is enabled, VEMKD core dumps when reclaiming allocation.
407011	Long log name is truncated for Platform Symphony applications.
408279	Report exported from a customized report shows incorrect content in .csv format.
408607	To improve SSM performance and memory usage, you can disable the task runtime information notification and the boundary event notification.
410636	The repository server (RS) service takes a long time to start up when the grid synchronization feature is enabled.
413073	Package deployment fails because the built-in 32-bit unzip binary provided with Platform Symphony lacks some 32-bit libraries in Linux.
413348	This interim fix addresses one defect related to the security plug-in of PAM.
416279	The error message “Too many users are accessing the Console at the same time. Try again later.” displays on the management console.
416695	On compute hosts, the LIM service does not log a warning when the host cannot start because the fully qualified domain name or host name exceeds 63 characters.
418281	Management console memory continually increases until it reaches the MEM_HIGH_MARK value.
418503	On compute hosts, the LIM service does not log a warning when the host cannot start because the fully qualified domain name or host name exceeds 63 characters.
418666	Unable to click host name from application resources list page.
419360	Clicking the check all button for a hybrid policy on the Resource Plan page within the Platform management console resets all values to their default values.
419908	Providing a non-existing host name on the host list page shows an error message. Then, switching to the host icon page, shows an exception string instead of a message.
420751	For a Platform Symphony 5.1 environment, when you submit workload using the 5.1 client to a Platform Symphony 7.1 cluster, and a task fails, the client shows an ECODE_ERROR_NOT_PROPAGATED_BUT_EXPECTED exception.
421303	Unable to see internal resource groups on the Consumer properties page.
421633	The Session Timeout and Task Execution Timeout fields on the session summary tab display “-1” instead of “-”.
421923	Running the egosh user users4role -r role -p consumer_name command does not support non-leaf consumers.
422392	You are unable to sort by the Slots column on the Resources tab within the management console.
423324	SIM cannot acquire the read lock for a package because the package lock file attribute information has been changed.
423589	After exporting a standard or customize report in .csv format, you are unable to sort data by ascending or descending order using the TIME_STAMP column.
424446	The management console displays the error message: “Too many users are accessing the Console at the same time. Try again later.” when viewing the applications list.
426941	SIM hangs when it returns task results to SSM.
428035	Idle slots in SSM remain despite sessions being closed.
430849	In some cases, there are more service instances running on the compute host than the number of slots assigned to the host.
432279	In a race condition, the catalina.out file shows an java.lang.ArrayIndexOutOfBoundsException error message, which leads the system to be unable to load cluster health data in the management console.
432616	A user associated with non-cluster administrator role using the “/” consumer node loads the management console dashboard using cached mode, and is unable to retrieve the applications list.
432967	Misleading error message in the SIM log, regarding a restarted service.
433117	When there is an <appname>_session.soamdb.<timestamp> file generated in the $SOAM_HOME/work/history/ directory, the session history loader reads this file and delays for several hours, causing missing data.
433142	Upon experiencing a high volume of traffic, the system traffic returns to normal, but LIM still shows that hosts are in busy state.
433166	Applications cannot execute because SSM is restarted by two threads simultaneously.
433256	EGO fails to detect that a container in ZOMBIE state is older than host uptime.
435071	Misleading error message in the SIM log, regarding a restarted service.
435953	The service instance (SI) executes the onCreateService method a second time when an idle global standby service is attached to an application.
436027	Interim fix for Linux 64-bit hosts to prevent VEMKD and EGOSC from crashing under race conditions on a file system.
436074	This fix enables SSM to create subdirectories under the $EGO_CONFDIR/../../soam/work/history directory with the same permissions as the $EGO_CONFDIR/../../soam/work/history directory.
436211	When there are many (such as hundreds of) timestamp folders in the $PERF_WORKDIR/backupdata/symsessionloader/ directory, after the database is recovered, the loader controller (PLC) requires several seconds of delay to load each timestamp file.
437337	With this feature, user can call the Linux function malloc_trim, and specify the interval (in seconds) for the call. This can help reduce Linux memory fragment issues.
437350	In some cases, SIM encounters errors from the onCreateService and onSessionEnter, SI methods, which trigger both onCreateService and onSessionEnter error handling.
438031	Support group configuration in the /etc/ego.sudoers file for the EGO_STARTUP_USERS, and in the $EGO_CONFDIR/ego.cluster.<cluster-name> file for the Administrators.
438779	In some cases, there are more service instances running on the compute host than the number of slots assigned to the host.
441269	In some cases, SIM will trigger two error handing for register and SessionEnter exit, at last, the host will be blocked by SessionEnter exit error handing.
442043	NullPointerException in catalina.out log when the WEBGUI service restarts.
444876	Resource reclaim of service instance triggers abnormal error handling
445601	VEMKD terminates by signal SIGALRM with IBM Platform Symphony 7.1 Advanced Edition
446496	The content of service profiles could be wiped out if file system failures occur after failover when cluster is deployed to an IBM Spectrum Scale shared file system.
446807	This readme file provides guidance on upgrading Apache Struts from version 2.3.16.3 to version 2.3.32 in IBM Platform Symphony 7.1 Fix Pack 1 to fix the S2-045 vulnerability.
448490	Interim fix for race conditions issue, wherein the SSM for one application exits when another application's history file is renamed.
451187	Interim fix to resolve issue of VEMKD terminating when it cannot reach the PEM by net link in IBM Platform Symphony 7.1.
451525	Interim fix to output trace message to a single line when SSM dumps log messages in IBM Platform Symphony 7.1
453242	Upgrading IBM JRE to version 6.0 sr16fp45, 7.0 sr10fp5, or 8.0 sr4fp5 for use with Platform Symphony and Spectrum Symphony.
454264	This interim fix provides a resolution for SSM issues in IBM Platform Symphony 7.1 Fix Pack 1, when empty task history files generated on SSM startup are never switched and are continually committed to disk through fsync operations.
454357	Interim fix to retrieve session manager (SSM) logs for the built-in symping7.1 application when a new resource group is specified for the application's SSM.
455270	Interim fix for SSM, SD reporting incorrect error code in negative cases.
458079	This interim fix provides instructions on upgrading the Apache Tomcat version for IBM Platform Symphony 7.1 Fix Pack 1 in order to address multiple security vulnerabilities in Tomcat (CVE-2017-5647, CVE-2017-5648, and CVE-2017-5651).
458732	Interim fix to resolve incorrect number of processors, cores, and threads detected on certain Windows platforms in Platform Symphony 7.1 Fix Pack 1.
460147	A user, with view permission to view packages for a specific consumer branch, cannot view packages deployed to its parent nodes in this branch.
460627	Interim fix to resolve WEBGUI startup issue when the Derby database (derbydb) hangs in an IBM Platform Symphony 7.1 Fix Pack 1 cluster.
463141	SSM caches invalid permissions when VEMKD is not responsive. When VEMKD is responsive again, SSM will use the cached permissions. This interim fix provides a resolution for this issue.
464437	For a parent consumer that is set a share limit in the Share policy resource plan, slot reclaim among the child consumers shows total allocation for the children exceeding the parent’s share limit, when the children’s total demand is larger than the parent’s share limit. This interim fix resolves this issue, so that the parent’s share allocation limit is enforced for the children.
464444	Windows hosts, in a large cluster, might become unavailable when the following error is reported in the LIM log: “Failed in sending/receiving a message: Message too long”. This interim fix provides a resolution for this issue.
466852	This interim fix provides instructions on upgrading the Apache Tomcat version from v6.0.43 to v7.0.79 in IBM Platform Symphony 7.1 Fix Pack 1 in order to address security vulnerability in Tomcat (CVE-2017-7674).
468017	This readme file provides guidance on upgrading Apache Struts to version 2.3.34 in IBM Platform Symphony 7.1 Fix Pack 1 in order to fix the S2-052 vulnerability.
468194	Interim fix for IBM Platform Symphony 7.1 Fix Pack 1 to resolve java.lang.OutOfMemoryError errors for the loader controller (plc).
469044	When you deploy service package through the add package page in IBM Platform Symphony 7.1 PMC console, The package name field did not verify the invalid characters such as space. This intertrim fix provides a resolution for this issue.
469379	Interim fix for Platform Symphony 7.1 with PAM authentication when the “egosh activity list” and “egosh activity view” commands impact VEMKD performance.
469465	Interim fix for Platform Symphony 7.1 enabling the SSM to terminate the ‘symmkdir’ process following a timeout to avoid generating zombie processes. This fix provides a new environment variable, SSM_CREATE_SUB_DIRECTORY_WITH_HISTORY_PERMISSIONS_TIMEOUT, to configure the timeout duration as desired.
470161	Interim fix for Platform Symphony 7.1 to resolve the number of global standby service instances (SIs) outnumbers the number of slots on the host.
470527	Interim fix enabling the “egosh resource list” command in Platform Symphony 7.1 Fix Pack 1 to show complete disk information (through the ‘diskInfo’ attribute) for resources in the cluster.
472257	Interim fix upgrading Apache Tomcat from v6.0.43 to v8.5.23 in IBM Platform Symphony 7.1 Fix Pack 1 to address Tomcat security vulnerability CVE-2017-12617.
472782	Interim fix enabling the “egosh resource list” command in Platform Symphony 7.1 Fix Pack 1 to show complete disk information (through the ‘diskInfo’ attribute) for resources in the cluster.
474993	Interim fix to resolve the issue of incorrect number of slots shown for a resource group when using the advanced “ngpus” formula in IBM Platform Symphony 7.1.
475484	Interim fix to resolve issue of the SSM in Platform Symphony 7.1 not releasing slots even after the session is killed, making slots unusable for other sessions or applications.
476838	Interim fix to resolve WEBGUI core dump in Platform Symphony 7.1. Following the core dump, the JNI code invokes other JNI API, instead of clearing the exception.
476850	Interim fix to resolve dependency on the egogui.jar file when you install fixes in your Platform Symphony 7.1 cluster that contain the commons-ego.jar file.
477766	Interim fix to resolve connection issues between the SSM and the SIM in Platform Symphony 7.1, causing a task to run indefinitely.
478098	Interim fix for Platform Symphony 7.1 introducing the SYMEXEC_SET_SAME_GROUP environment variable to specify whether an SI and its child processes must be set to the same process group.
478267	Interim fix with instructions on upgrading Jackson databind, core, and annotations in IBM Platform Symphony 7.1 Fix Pack 1 in order to fix security vulnerability S2-055.
478374	Interim fix to resolve security vulnerability reported for XFSv2 (included in Platform Symphony 7.1) that allows application pages to be captured within a frame from another server.
478467	Interim fix to update hosts in a static resource group in Platform Symphony 7.1. This issue occurs when you install interim fixes that contain the egogui.jar file and relates to a dependency on the resourceProp.jsp file.
478634	Interim fix to resolve the Client JVM could cause a core dump after running the client sample in a Platform Symphony 7.1 Fix Pack 1 cluster.
478701	Interim fix to resolve VEMKD core dump issue if fails to send a start container request to PEM in IBM Platform Symphony 7.1.
478859	Interim fix to resolve incorrect time stamp for the task soamdb file under race conditions in IBM Platform Symphony 7.1.
478867	Interim fix for IBM Platform Symphony 7.1 to improve VEMKD performance in a large cluster, when hosts are evaluated tens of thousands of times for allocation resource requirements.
479051	Interim fix to upgrade the IBM JRE in multiple product versions in order to fix a security vulnerability in IBM Java SDK.
485556	Update for Platform Symphony’s external load information manager (elim) to support additional network card names. Previously, only network card names starting with the letter "e" were supported.
486396	Interim fix for Platform Symphony 7.1 Fix Pack 1 to resolve Arbitrary Remote Command Execution (RCE).
487169	Interim fix to resolve the Client JVM could cause a core dump after running the client sample in a Platform Symphony 7.1 Fix Pack 1 cluster.
489313	Interim fix to validate unsupported characters such as spaces when service packages are added from the PMC in Platform Symphony 7.1 Fix Pack 1.
490491	Interim fix for environment variable values that are truncated at the comma when an application profile is updated through the PMC in Platform Symphony 7.1 Fix Pack 1.
491204	Interim fix to upgrade the IBM JRE in multiple product versions in order to fix a security vulnerability in IBM Java SDK.
491553	Interim fix upgrading Apache Tomcat from v6.0.43 to v8.5.31 in IBM Platform Symphony 7.1 Fix Pack 1 to address security vulnerability in Tomcat (CVE-2017-15698, CVE-2017-15706, CVE-2018-1323, CVE-2018-1305, CVE-2018-1304).
492835	Interim fix to resolve authentication failures that are logged to the Tomcat log file in Platform Symphony 7.1 Fix Pack 1.
493059	Interim fix to resolve SD crash issue under race conditions in Platform Symphony 7.1 Fix Pack 1.
493378	Interim fix to resolve vertical authorization bypass vulnerability on the Symping page in Platform Symphony 7.1 Fix Pack 1.
493888	Interim fix to resolve reclaim issues in IBM Platform Symphony 7.1 when the maximum reclaim grace period for a consumer is greater than 4294 seconds.
494537	Interim fix to resolve the XML Entity Expansion in Platform Symphony 7.1 Fix Pack 1.
494795	Interim fix to remove user passwords being shown in clear text when 'symping' is run from the cluster management console in Platform Symphony 7.1 Fix Pack 1.
495155	Interim fix to clean up leftover empty directories after SSM migration in Platform Symphony 7.1 Fix Pack 1.
495321	Interim fix to prevent Arbitrary File Reads from the PMC in Platform Symphony 7.1 Fix Pack 1.
495462	Interim fix to show 'Rxpackets' and 'Txpackets' in numbers (instead of bytes) when looking up a host's network data from the PMC in Platform Symphony 7.1 Fix Pack 1.
495471	Interim fix to prevent arbitrary URL redirection from the PMC in Platform Symphony 7.1 Fix Pack 1.
495667	Interim fix to prevent Stored Cross-Site Scripting (XSS) from the PMC in Platform Symphony 7.1 Fix Pack 1.
497119	Interim fix to remove unnecessary log messages when the smcproxy service queries workload status of applications whose SSM is not running because the application is not prestarted and is yet to receive workload in Platform Symphony 7.1 Fix Pack 1.
497456	Interim fix to update the IBM JRE in multiple product versions for security vulnerabilities.
497568	Interim fix upgrading Apache Tomcat in Platform Symphony 7.1 Fix Pack 1 to address security vulnerability CVE-2018-8014.

6. Copyright and trademark information

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.