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

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

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>

   <!-- security patch filter end -->

   <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:

<Service default="true" description="The Execution Service" name="symexecservice">
       <osTypes>
            <osType fileNamePattern="%sessionId%" logDirectory="${SOAM_HOME}/work" name="all">
            ....
               <env name="SYMEXEC_SET_SAME_GROUP">true</env>
           
</osType>
        </osTypes>
</Service>

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>

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

<!-- This parameter defines whether internal resource groups InternalResourceGroup, MapReduceInternalResourceGroup, DataNodeRG, NameNodeRG and SecondaryNodeRG must be hidden on the consumer properties page. By default, this parameter is not defined. To hide multiple resource groups, separate the names by a semicolon (";"). -->

<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")

Copyright IBM Corp. 1992, 2014. All rights reserved.

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:

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

© Copyright IBM Corporation 2018

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

IBM®, the IBM logo, and ibm.com® are trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.