Readme File for IBM® Spectrum Symphony 7.2 Interim Fix 525818
Readme File for: IBM Spectrum Symphony
Product Release: 7.2
Update Name: Interim Fix 525818
Fix ID: sym-7.2-build525818
Publication Date: July 29, 2019
In Spectrum Symphony 7.2.0.0, a task retries indefinitely with the sessionRetryCount not incrementing, causing the sessionRetryLimit setting in the application profile to not take effect. This issue occurs under specific error-handling conditions. This interim fix provides a resolution for this issue.
Contents
1. List of fixes
2. Download location
3. Product and components affected
4. Installation and configuration
5. Uninstallation
6. List of files
7. Product notifications
8. Copyright and trademark information
1. List of fixes
APAR: P103140
2. Download location
Download interim fix 525818 from the following location: https://www.ibm.com/eserver/support/fixes/
3. Product and components affected
Component name, Platform, Fix ID:
SOAM, Windows x86_64, sym-7.2-build525818
4. Installation and configuration
System requirements
Windows x86_64
Installation
1. Log on to the master host as the cluster administrator, stop all services, and shut down the cluster:
> egosh user logon -u Admin -x Admin
> soamcontrol app disable all
> egosh service stop all
> egosh ego shutdown all
2. Log on to each host in the cluster, copy the sym-7.2.0.0-soamcore-7.2.0.0_build525818.msp package, and complete one of the following steps:
o To perform an interactive installation, double-click the .msp package.
o To perform a silent installation from the IBM Spectrum Symphony command line, complete these steps:
C:\>msiexec /update C:\sym-7.2.0.0-soamcore-7.2.0.0_build525818.msp /l*v updateSym.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 file name to the .msp package.
o <sym_install_log> is the log file for the upgrade.
3. Run the “pversions” command to verify the installation. For example:
> pversions
IBM Spectrum Computing family: EGO management 3.6.0
IBM Spectrum Computing family: Monitoring for IBM Spectrum Scale 3.6.0
IBM Spectrum Computing family: SOAM management 7.2 for IBM Spectrum Symphony 7.2.0
IBM Spectrum Computing family: EGO core 3.6.0
IBM Spectrum Computing family: EGO RESTful API Server 3.6.0
IBM Spectrum Computing family: IBM JRE 8.0.3.21
IBM Spectrum Computing family: IBM WebSphere Application Server Liberty Profile 8.5.5.9
IBM Spectrum Computing family: SOAM core 7.2 for IBM Spectrum Symphony 7.2.0
Update for Symphony 7.2.0 (build"525818")
Copyright IBM Corp. 1992, 2016. All rights reserved.
US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
4. On the management host, enable this fix by adding the ENABLE_SESSIONRETRY_FOR_BINDININVOKE parameter in the %EGO_CONFDIR%\..\..\eservice\esc\conf\services\sd.xml file:
<sc:ActivityDescription>
<ego:Attribute name="hostType" type="xsd:string">NTX64</ego:Attribute>
<ego:ActivitySpecification>
<ego:Command>"${EGO_TOP}\soam\7.2\w2k3_x64-vc7-psdk\etc\sd"</ego:Command>
<ego:EnvironmentVariable name="SOAM_HOME">${EGO_TOP}\soam</ego:EnvironmentVariable>
<ego:EnvironmentVariable name="ENABLE_SESSIONRETRY_FOR_BINDININVOKE">TRUE</ego:EnvironmentVariable>
…
</sc:ActivityDescription>
5. From the master host, start the cluster and enable your applications:
> egosh user logon -u Admin -x Admin
> egosh ego start all
> soamcontrol app enable <appName>
5. Uninstallation
1. Log on to the master host as the cluster administrator and disable all applications:
> egosh user logon -u Admin -x Admin
> soamcontrol app disable all
> egosh service stop all
> egosh ego shutdown <hostname>
2. Log on to each host in the cluster, roll back to the previous version of IBM Spectrum Symphony either from the Windows Control Panel or from the IBM Spectrum Symphony command line:
o To roll back from the Windows Control Panel, go to Control Panel > Programs and Features > View installed updates, click Update for Symphony 7.2.0 (build “525818”) and click Uninstall.
o To roll back from the IBM Spectrum Symphony command line, enter the following command:
C:\>msiexec /uninstall {3514AE4A-F5E0-4F43-B5E2-0A4D1978B21B} /package {723546FD-35E8-4275-92DF-7BE96E65A5F6} /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, {3514AE4A-F5E0-4F43-B5E2-0A4D1978B21B}.
o <product_code> is the identifier of the .msi file in the product installation package; in this case, {723546FD-35E8-4275-92DF-7BE96E65A5F6}.
o <rollback_log> is the name of the log file to capture details of the interim fix rollback; in this case, sym_rollback.log.
3. On the management host, remove the ENABLE_SESSIONRETRY_FOR_BINDININVOKE parameter that was added to the %EGO_CONFDIR%\..\..\eservice\esc\conf\services\sd.xml file.
4. From the master host, start the cluster and enable your applications:
> egosh user logon -u Admin -x Admin
> egosh ego start all
> soamcontrol app enable <appName>
6. List of files
soam\7.2\w2k3_x64-vc7-psdk\etc\sd.exe
soam\7.2\w2k3_x64-vc7-psdk\etc\sd.pdb
soam\7.2\w2k3_x64-vc7-psdk\etc\ssm.exe
soam\7.2\w2k3_x64-vc7-psdk\etc\ssm.pdb
soam\7.2\w2k3_x64-vc7-psdk\etc\sim.exe
soam\7.2\w2k3_x64-vc7-psdk\etc\sim.pdb
7. Product notifications
To receive information about product solution and patch updates automatically, subscribe to product notifications on the My Notifications page http://www.ibm.com/support/mynotifications/ on the IBM Support website (http://support.ibm.com). You can edit your subscription settings to choose the types of information you want to get notification about, for example, security bulletins, fixes, troubleshooting, and product enhancements or documentation changes.
8. Copyright and trademark information
© Copyright IBM Corporation 2019
U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
IBM®, the IBM logo, and ibm.com® are trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.