Readme File
for IBM® Spectrum Symphony 7.1.2 Interim Fix 473977
Readme File for: IBM
Spectrum Symphony
Product Release: 7.1.2
Update Name: Interim
Fix 473977
Fix ID: sym-7.1.2-build473977-cs
Publication Date: November
17, 2017
When a client
application in IBM Spectrum Symphony 7.1.2 does not set a timeout for the closeSession method, the closeSession call hangs indefinitely under some
circumstances, causing creation of new sessions in multi-thread clients to
hang. This interim fix provides a resolution for this issue by introducing a
new environment variable, SOAM_SESSION_CLOSE_TIMEOUT, which specifies the duration within which a
session must be closed. If a session is not closed within the specified
duration, the closeSession call is terminated. The recommended
value for SOAM_SESSION_CLOSE_TIMEOUT is 5 (seconds) or greater. By default, the environment variable is not
defined.
Contents
1. List of fixes
2. Download location
3. Product and components affected
4. Installation and configuration
5. Uninstallation
6. List of files
7. Copyright and trademark information
1.
List of fixes
APAR: P102419
2.
Download location
Download interim fix 473977 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.1.2-build473977-cs
4.
Installation and configuration
Follow the instructions in this
section to download and install this interim fix in your cluster.
System
requirements
Windows x86_64
Installing
on management and compute hosts
1. Log on to the master host in the cluster as the
cluster administrator and disable your applications:
> soamcontrol app disable all
2. Log on to each management and compute host in the cluster, copy
the sym-7.1.2.0-soamcore-7.1.2.0_build473977.msp package, and complete one of the following steps:
o
For an interactive installation
o
For a silent installation, enter the following command
from the command prompt:
C:\>msiexec
/update C:\sym-7.1.2.0-soamcore-7.1.2.0_build473977.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 of 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: IBM
WebSphere Application Server Liberty Profile 8.5.5.9
IBM Spectrum Computing family: EGO
management 3.4.0
IBM Spectrum Computing family: SOAM core
7.1.2 for IBM Spectrum Symphony 7.1.2
Update for Symphony 7.1.2.0
(build"473977")
IBM Spectrum Computing family: SOAM
management 7.1.2 for IBM Spectrum Symphony 7.1.2
IBM Spectrum Computing family: EGO core
3.4.0
IBM Spectrum Computing family:
Monitoring for IBM Spectrum Scale 3.4.0
IBM Spectrum Computing family: EGO RESTful
API Server 3.4.0
IBM Spectrum Computing family: IBM JRE
1.8.0.3
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. Configure the SOAM_SESSION_CLOSE_TIMEOUT environment variable in the application profile:
o
From the
cluster management console, go
to Workload > Symphony > Application Profiles and click your application profile. In the Service Definition section, expand Environment Variables, add
a new one named SOAM_SESSION_CLOSE_TIMEOUT, and set a value (5 is recommended).
o
From the
command line interface, manually edit the application profile to add SOAM_SESSION_CLOSE_TIMEOUT; then, register the application by using the soamreg command. For example:
<Service
default="true" description="The Symping
Service" name="sympingservice">
<osTypes>
<osType
fileNamePattern="%sessionId%.%taskId%." logDirectory="${SOAM_HOME}/work"
name="all"
startCmd="${SOAM_HOME}/${VERSION_NUM}/${EGO_MACHINE_TYPE}/bin/sympingservice"
subDirectoryPattern="symping7.1.2/%sessionId%" workDir="${SOAM_HOME}/work">
<env
name="SOAM_SESSION_CLOSE_TIMEOUT">5</env>
</osType>
</osTypes>
5. Log on to the master host in the cluster as the
cluster administrator and enable your applications:
> soamcontrol app enable
<appName>
Installing
on client hosts
1. Log on to each client host in the cluster and copy
the symclnt-7.1.2.0_build473977.msp package.
2. Complete one of the following steps:
o
For an interactive installation
o
For a silent installation, enter the following
command from the command prompt:
C:\>msiexec
/update C:\symclnt-7.1.2.0_build473977.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 of the .msp package.
o
<sym_install_log> is the log file for the
upgrade.
3. Set the environment variable in System Environment
Variables or from the command prompt; for example:
> set SOAM_SESSION_CLOSE_TIMEOUT=5
5.
Uninstallation
If required, follow the
instructions in this section to uninstall this interim fix in your cluster.
Uninstalling
on management and compute hosts
1. Log on to the master host in the cluster as the
cluster administrator and disable your applications:
> soamcontrol app disable all
2. Roll back this
interim fix installation:
o To
roll back from the Windows Control Panel, go to Control Panel > Programs
and Features > View installed updates, click Update for Symphony 7.1.2.0
(build"473977") and click Uninstall.
o To
roll back from the IBM Spectrum Symphony command prompt, enter the following
command:
C:\>msiexec
/uninstall {29B4D253-E159-468D-BB22-21C84B962938} /package
{445FC793-46B4-4B0A-99CE-2662B1164812} /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, {29B4D253-E159-468D-BB22-21C84B962938}.
o
<product_code> is the identifier of
the .msi file in the product installation
package; in this case, {445FC793-46B4-4B0A-99CE-2662B1164812}.
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. Remove the SOAM_SESSION_CLOSE_TIMEOUT environment variable from the application profile, then register the
profile.
4. Log on to the master host in the cluster as the
cluster administrator and enable your applications:
> soamcontrol app enable <appName>
Uninstalling
on client hosts
1. Roll back this
interim fix installation:
To roll back this interim fix installation from
the Windows Control Panel, go to Control Panel > Programs and Features
> View installed updates, click Update for Symphony 7.1.2.0 (build"473977") and click Uninstall.
To roll back this interim fix
installation from the IBM Spectrum Symphony command prompt, enter the following
command:
C:\>msiexec
/uninstall {A7CF5D21-D0B6-48BC-AB85-DA0D79BC908A} /package
{85D2044F-9BC1-4EAE-AED3-5575270DC18F} /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, {A7CF5D21-D0B6-48BC-AB85-DA0D79BC908A}.
o
<product_code> is the identifier of
the .msi file in the product installation
package; in this case, {85D2044F-9BC1-4EAE-AED3-5575270DC18F}.
o
<rollback_log> is
the name of the log file to capture details of the interim fix rollback; in
this case, sym_rollback.log.
2. Remove the SOAM_SESSION_CLOSE_TIMEOUT environment variable in the System Environment Variables or from the
command prompt.
6.
List
of files
soambase.dll
soambase.pdb
7.
Copyright
and trademark information
© Copyright IBM Corporation 2017
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.