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.