Readme File for IBM® Spectrum Symphony 7.3.1 Interim Fix 601951

Readme File for: IBM Spectrum Symphony

Product Release: 7.3.1

Update Name: Interim Fix 601951

Fix ID: sym-7.3.1-build601951-bbva

Publication Date: March 29, 2024

 

This trial fix resolves deadlocking the service instance manager (SIM) when starting a service for a closed session in an IBM Spectrum Symphony 7.3.1 cluster. This fix is only for the R_TagHierarchy 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: P105094

2.   Download location

Download interim fix 601951 from the following location: https://www.ibm.com/eserver/support/fixes/

3.   Product and components affected

Component name, Platform, Fix ID:

SOAM, Linux-x86_64, sym-7.3.1-build601951-bbva

4.   Installation and configuration

Follow the instructions in this section to download and install this interim fix on your cluster.

System requirements

Linux-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 password

> soamcontrol app disable all

b.     Download the packages to each of your management and compute host (or just one host if you are using a shared file system) to, for example, to a /symfixes directory.

c.     Run the egoinstallfixes command to install the soamcore-7.3.1.0_x86_64_build601951.tar.gz files:

> egoinstallfixes /symfixes/soamcore-7.3.1.0_x86_64_build601951.tar.gz

Note: Running the egoinstallfixes command automatically backs up the current binary files to a fix backup directory for recovery purposes. Do not delete this backup directory; you will need it if you want to recover the original files. For more information on using this command, see the egoinstallfixes command reference.

d.     Run the pversions command to verify the installation:

> pversions -b 601951

e.     Update the application profile to add the  SOAM_CANCEL_BIND_SESSION_END environment variable with a value of true. This parameter releases an unprovisioned slot if a closed session owns the slot for more than 60 seconds:

<SOAM version="7.3.1">

    <SSM ......>

          <osTypes>

              <osType name="all" ......>

                  ......

                  <env name="SOAM_CANCEL_BIND_SESSION_END">true</env>

              </osType>

          </osTypes>

With this parameter configured, the following message will be logged in the SSM log:

2024-03-22 01:39:35.919 GMT INFO [28787:140414022817536] ssm.ssmcore.ARM - ARM::getEnvCancelBindSessionEnd environment variable SOAM_CANCEL_BIND_SESSION_END is set with true, corresponding feature is enabled.

Also keep the SSM_SIM_HEARTBEAT_INTERVAL_SECONDS and SSM_SIM_NO_RESPONSE_TIMEOUT_SECONDS parameter set in the application profile, as they will also help with the issue.

f.       Enable the applications:

soamcontrol app enable application_name

 

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 password

> soamcontrol app disable all

b.     Roll back this interim fix:

> egoinstallfixes -r 601951

c.     From the primary host, enable the applications:

> soamcontrol app enable application_name

6. List of files

   soam/7.3.1/linux-x86_64/etc/ssm
   soam/7.3.1/linux-x86_64/etc/sim

 

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 2024

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.