Readme File for IBM® Spectrum Symphony 7.2.1.1 Interim Fix 519166
Readme File for: IBM Spectrum Symphony
Product Release: 7.2.1.1
Update Name: Interim Fix 519166
Fix ID: sym-7.2.1.1-build519166-cs
Publication Data: May 10, 2019
This
is a cumulative patch for IBM Spectrum Symphony 7.2.1.1 that includes the
following interim fixes for IBM Spectrum Symphony 7.1.2:
·
sym-7.1.2-build473977-cs:
Interim fix to resolve issues when a client application does not set a timeout
for the closeSession method. This fix provides
the SOAM_SESSION_CLOSE_TIMEOUT environment variable,
enabling the closeSession call to be terminated
if the operation does not complete within the specified duration in IBM
Spectrum Symphony 7.1.2.
·
sym-7.1.2-build482346: Interim fix to resolve memory leaks by
configuring the EGO_ENABLE_HASH_EULER_RELEASE parameter to release
resident VEMKD data on Windows hosts in IBM Spectrum Symphony 7.1.2.
·
sym-7.1.2-build493460: Interim fix to resolve issues with client
connections to the grid based on the PLATCOMMDRV_BACKLOG_SIZE_ON_WINDOWS configuration in IBM
Spectrum Symphony 7.1.2.
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
APARs: P102419, P102506, P102613
2. Download location
Download interim fix 519166 from the following location: https://www.ibm.com/eserver/support/fixes/
3. Product and components affected
Component name, Platform, Fix ID:
EGO/SOAM, Windows x86_64, sym-7.2.1.1-build519166-cs
4. Installation and configuration
Follow the instructions in this section to download and install this interim fix in your cluster.
Prerequisite
Fix Pack 7.2.1.1 (fix ID sym-7.2.1-build507069) must
be applied to your 7.2.1 cluster.
System requirements
Windows x86_64
Installation
a. Log on to the master host as the cluster administrator and shut down the cluster:
> soamcontrol app disable all
> egosh service stop all
> egosh ego shutdown all
b. Log on to each management host in the cluster, copy the sym-7.2.1-egocore-3.7.0_build519166.msp and sym-7.2.1-soamcore-7.2.1_build519166.msp packages, and complete one of the following steps:
· For an interactive installation, double-click the sym-7.2.1-egocore-3.7.0_build519166.msp package first and follow the prompts, then double-click the sym-7.2.1-soamcore-7.2.1_build519166.msp package and follow the prompts.
· For a silent installation, enter the following commands from the command prompt in the order specified:
C:\>msiexec /update
C:\sym-7.2.1-egocore-3.7.0_build519166.msp /l*v updateSym.log /norestart /quiet REINSTALLMODE=omus
C:\>msiexec /update C:\sym-7.2.1-soamcore-7.2.1_build519166.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.
c.
Log on to
each compute host in the cluster, copy the sym-7.2.1-soamcore-7.2.1_build519166.msp package, and complete one of the following steps:
·
For an
interactive installation, double-click the sym-7.2.1-soamcore-7.2.1_build519166.msp package and follow the prompts.
· For a silent installation, enter the following command from the command prompt:
C:\>msiexec /update C:\sym-7.2.1-soamcore-7.2.1_build519166.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.
d. Log on to each client host in the cluster, copy the symclnt-7.2.1_build519166.msp package, and complete one of the following steps:
· For an interactive installation, double-click the symclnt-7.2.1_build519166.msp package and follow the prompts.
· For a silent installation, enter the following command from the command prompt:
C:\>msiexec /update C:\symclnt-7.2.1_build519166.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.
e. Verify the installation with “pversions” command:
> pversions
IBM
Spectrum Computing family: SOAM core 7.2.1 for IBM Spectrum Symphony 7.2.1.0
Update
for Symphony 7.2.1.0 : (build"507069"),
(build"519166")
IBM Spectrum
Computing family: IBM JRE 8.0.5.16
IBM
Spectrum Computing family: Monitoring for IBM Spectrum Scale 3.7.0.0
IBM
Spectrum Computing family: IBM WebSphere Application Server Liberty Profile
18.0.0.1
IBM
Spectrum Computing family: EGO RESTful API Server 3.7.0.0
Update
for Symphony 7.2.1.0 (build"507069")
IBM
Spectrum Computing family: EGO core 3.7.0.0
Update
for Symphony 7.2.1.0 : (build"507069"),
(build"519166")
IBM
Spectrum Computing family: EGO management 3.7.0.0
Update
for Symphony 7.2.1.0 (build"507069")
IBM
Spectrum Computing family: SOAM management 7.2.1 for IBM Spectrum Symphony
7.2.1.0
Update
for Symphony 7.2.1.0 (build"507069")
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.
f.
Configure the EGO_ENABLE_HASH_EULER_RELEASE=Y in %EGO_CONFDIR%\ego.conf.
g.
Configure
the PLATCOMMDRV_BACKLOG_SIZE_ON_WINDOWS and PLATCOMMDRV_POOL_SIZE environment variables in Installation_top\eservice\esc\conf\services\sd.xml:
<sc:ActivityDescription>
<ego:Attribute
name="hostType" type="xsd:string">NTX64</ego:Attribute>
<ego:ActivitySpecification>
<ego:Command>Installation_top\soam\7.2.1\w2k3_x64-vc7-psdk\etc\sd</ego:Command>
<ego:EnvironmentVariable
name="PLATCOMMDRV_BACKLOG_SIZE_ON_WINDOWS">200</ego:EnvironmentVariable>
<ego:EnvironmentVariable
name="PLATCOMMDRV_POOL_SIZE">15</ego:EnvironmentVariable>
h.
Configure the
PLATCOMMDRV_BACKLOG_SIZE_ON_WINDOWS, PLATCOMMDRV_POOL_SIZE and SOAM_SESSION_CLOSE_TIMEOUT environment variables in the application profile.
For example:
<SSM resReq="" workDir="${EGO_SHARED_TOP}/soam/work" startUpTimeout="60"
shutDownTimeout="300">
<osTypes>
<osType name="hostType"
startCmd="${SOAM_HOME}/${VERSION_NUM}/${EGO_MACHINE_TYPE}/etc/ssm.exe"
workDir="${EGO_CONFDIR}/../../soam/work">
<env
name="PLATCOMMDRV_BACKLOG_SIZE_ON_WINDOWS">200</env>
<env
name="PLATCOMMDRV_POOL_SIZE">15</env>
</osType>
</osTypes>
And:
<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.2.1/%sessionId%" workDir="${SOAM_HOME}/work">
<env name="SOAM_SESSION_CLOSE_TIMEOUT">5</env>
</osType>
</osTypes>
i. Log on to the master host as the cluster administrator and start the cluster, register and enable the applications:
> egosh
ego start all
> soamreg application_profile_file
> soamcontrol app enable <appName>
5. Uninstallation
If required, follow the instructions in this section to uninstall this interim fix in your cluster.
a. Log on to the master host as the cluster administrator and shut down the cluster:
> soamcontrol app disable all
> egosh service stop all
> egosh ego shutdown all
b.
Roll back
this interim fix installation:
On each
management host:
·
To roll back from
the Windows Control Panel, go to Control Panel > Programs and Features
> View installed updates, click Update for Symphony 7.2.1.0 (build"519166") and click Uninstall. Then click Update for Symphony 7.2.1.0 (build"519166") and click Uninstall.
·
To roll back
from the IBM Spectrum Symphony command prompt, enter the following command:
C:\>msiexec /uninstall {334236BC-4625-4D30-858F-1D8533EFC418} /package {FBBCB6EA-7BE4-4C45-ACB0-C4E7036E4A1F} /norestart /quiet /l*v sym_rollback.log
C:\>msiexec /uninstall {60D4C939-62D6-4C7D-BB07-B014565DBAC0} /package {688D2323-983E-4F46-97E2-C41D1C644347} /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, {334236BC-4625-4D30-858F-1D8533EFC418} for sym-7.2.1-egocore-3.7.0_build519166.msp and {60D4C939-62D6-4C7D-BB07-B014565DBAC0} for sym-7.2.1-soamcore-7.2.1_build519166.msp.
o <product_code> is the identifier of the MSI file in the product installation package; in this case, {FBBCB6EA-7BE4-4C45-ACB0-C4E7036E4A1F} for the sym-7.2.1-egocore-3.7.0_build519166.msp and {688D2323-983E-4F46-97E2-C41D1C644347} for sym-7.2.1-soamcore-7.2.1_build519166.msp.
o <rollback_log> is the name of the log file to capture details
of the interim fix rollback; in this case, sym_rollback.log.
On each compute host:
· To roll back from the Windows Control Panel, go to Control Panel > Programs and Features > View installed updates, click Update for Symphony 7.2.1.0 (build"519166") and click Uninstall.
· To roll back from the IBM Spectrum Symphony command prompt, enter the following command:
C:\>msiexec /uninstall {60D4C939-62D6-4C7D-BB07-B014565DBAC0} /package {688D2323-983E-4F46-97E2-C41D1C644347} /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, {60D4C939-62D6-4C7D-BB07-B014565DBAC0}.
o <product_code> is the identifier of the MSI file in the product installation package; in this case, {688D2323-983E-4F46-97E2-C41D1C644347}.
o <rollback_log> is the name of the log file to capture details
of the interim fix rollback; in this case, sym_rollback.log.
On each client host:
· To roll back from the Windows Control Panel, go to Control Panel > Programs and Features > View installed updates, click Update for Symphony 7.2.1.0 (build"519166") and click Uninstall.
· To roll back from the IBM Spectrum Symphony command prompt, enter the following command:
C:\>msiexec /uninstall {11D31AC7-0588-4FCA-B1B6-E75866FD9DE1} /package {A5B17CE9-32A9-47F6-80E0-C64BAE0D4F89} /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, {11D31AC7-0588-4FCA-B1B6-E75866FD9DE1}.
o <product_code> is the identifier of the MSI file in the product installation package; in this case, {A5B17CE9-32A9-47F6-80E0-C64BAE0D4F89}.
o <rollback_log> is the name of the log file to capture details of the interim fix rollback; in this case, sym_rollback.log.
c. Remove the configuration from ego.conf and environment variables from application profile.
d. Log on to the master host as the cluster
administrator and start the cluster, register and enable the applications:
> egosh ego start all
> soamreg application_profile_file
> soamcontrol app enable <appName>
6. List of files
sym-7.2.1-egocore-3.7.0_build519166.msp:
3.7/etc/vemkd.exe
3.7/etc/vemkd.pdb
sym-7.2.1-soamcore-7.2.1_build519166.msp:
soam/7.2.1/w2k3_x64-vc7-psdk/etc/sd.exe
soam/7.2.1/w2k3_x64-vc7-psdk/etc/sd.pdb
soam/7.2.1/w2k3_x64-vc7-psdk/etc/ssm.exe
soam/7.2.1/w2k3_x64-vc7-psdk/etc/ssm.pdb
soam/7.2.1/w2k3_x64-vc7-psdk/lib64/soambase.dll
soam/7.2.1/w2k3_x64-vc7-psdk/lib64/soambase.pdb
soam/7.2.1/w2k3_x64-vc7-psdk/lib/soambase.dll
soam/7.2.1/w2k3_x64-vc7-psdk/lib/soambase.pdb
symclnt-7.2.1_build519166.msp:
lib64/soambase.dll
lib64/soambase.pdb
lib/soambase.dll
lib/soambase.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.