Readme File for IBM® Spectrum Symphony 7.3 Interim Fix 601678
Readme File for: IBM Spectrum Symphony
Product Release: 7.3
Update Name: Interim Fix 601678
Fix ID: sym-7.3-build601678-cs
Publication Date: September 1, 2023
This fix provides a new parameter
called SOAM_SEND_COMMONDATA_TIMEOUT_SECONDS, used to configure the timeout
value (in seconds) of sending common data from the SSM to a service. If the
service is unable to get the expected common data within the configured time,
the service will be terminated, and corresponding slots will be released. This
fix is supported for the R_PriorityScheduling policy.
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: P104930
2. Download location
Download interim fix 601678 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.3-build601678-cs
4. Installation and configuration
Follow the instructions in this section to download and install this interim fix to your cluster.
System requirements
Windows x86_64
Installation and configuration
a. Log on to the primary host as the cluster administrator and disable all applications:
> egosh user logon -u Admin -x Admin
> soamcontrol app disable all
b. Log on to each management and compute host in the cluster, copy the sym-7.3.0.0-soamcore-7.3.0.0_build601678.msp package, and complete one of the following steps:
· For an interactive installation, double-click the sym-7.3.0.0-soamcore-7.3.0.0_build601678.msp package and follow the prompts.
· For a silent installation, enter the following command from the IBM Spectrum Symphony command prompt:
C:\>msiexec /update C:\sym-7.3.0.0-soamcore-7.3.0.0_build601678.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:
· sym_package_name_path is the fully qualified file name to the .msp package.
· sym_install_log is the log file for the upgrade.
c. Run the pversions command to verify the installation:
> pversions
IBM Spectrum Computing family:
SOAM core 7.3 for IBM Spectrum Symphony 7.3.0.0
Update for Symphony 7.3.0
(build"601678")
IBM Spectrum Computing family: EGO
core 3.8.0.0
IBM Spectrum Computing family: IBM
JRE 8.0.5.37
IBM Spectrum Computing family: IBM
WebSphere Application Server Liberty Profile 19.0.0.6
IBM Spectrum Computing family: EGO
management 3.8.0.0
IBM Spectrum Computing family:
SOAM management 7.3 for IBM Spectrum Symphony 7.3.0.0
IBM Spectrum Computing family: EGO
RESTful API Server 3.8.0.0
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.
d. Configuration applications:
Add the SOAM_SEND_COMMONDATA_TIMEOUT_SECONDS environment
variable into the SOAM section of the application profile. Specify an integer
between 5 to 2147483647 to indicate the timeout value (in seconds) of sending
common data from the SSM to a service. If the service is unable to get the
expected common data within the configured time, the service will be
terminated, and corresponding slots will be released.
<SOAM
version="7.3">
<SSM resReq=""
workDir="${EGO_SHARED_TOP}/soam/work">
<osTypes>
<osType
name="all" ……>
……
<env
name="SOAM_SEND_COMMONDATA_TIMEOUT_SECONDS">30</env>
</osType>
</osTypes>
Once you
have added the environment variable to your application profile, register the
application profile to enable this feature with soamreg
command.
e. Enable
applications:
> soamcontrol app enable application_name
Related
logs
With this feature enabled, a message like
following can be found at SSM’s log:
2023-08-14
03:09:35.605 GMT INFO [8359:140227683370752] ssm.ssmcore.ARM
- ARM::getEnvSendCommonDataTimeout
SOAM_SEND_COMMONDATA_TIMEOUT_SECONDS parameter is enabled with value
<30>.
Any service that cannot get common data in the configured
time will be terminated, and a message like following can be found at SSM’s
log:
2023-08-14
08:20:00.130 GMT INFO [21002:140583263790848] ssm.ssmcore.SSN
- SSN::monitorBindCommonData
session 2202 cannot get common data in configured time for stp
5167d1e8-3a7b-11ee-c000-00000a0b7b6a-140583263790848-21002 on host testmachine, stp will be cleaned.
5. Uninstallation
If required, follow the instructions in this section to uninstall this interim fix from your cluster.
a. Log on to the primary host as the cluster administrator and disable all applications:
> egosh user logon -u Admin -x Admin
> soamcontrol app disable all
b. Log on to each management and compute host in the cluster and roll back to the previous version of IBM Spectrum Symphony, either from Windows Control Panel or from the IBM Spectrum Symphony command prompt:
· To roll back from the Windows Control Panel, go to Control Panel > Programs and Features > View installed updates, click Update for Symphony 7.3.0 (build “601678”) and click Uninstall.
· To roll back from the IBM Spectrum Symphony command prompt, enter the following command:
C:\>msiexec /uninstall {F9481CF9-A5C8-4ED5-908E-856336006D77} /package {5B7B0C11-4DDB-4C5F-96A2-D1DCF66DBB64} /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, {F9481CF9-A5C8-4ED5-908E-856336006D77}.
o product_code is the identifier of the .msi file in the original product installation package; in this case, {5B7B0C11-4DDB-4C5F-96A2-D1DCF66DBB64}.
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. Enable applications:
> soamcontrol app
enable application_name
6. List of files
soam\7.3\w2k3_x64-vc7-psdk\etc\ssm.exe
soam\7.3\w2k3_x64-vc7-psdk\etc\ssm.pdb
soam\7.3\w2k3_x64-vc7-psdk\etc\sim.exe
soam\7.3\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 2023
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.