Readme File for IBM® Spectrum Symphony 7.2.1.1 Interim Fix 543928 

Readme File for: IBM Spectrum Symphony

Product Release: 7.2.1.1

Update Name: Interim Fix 543928

Fix ID: sym-7.2.1.1-build543928

Publication Date: April 2, 2020

 

With recursive workload, a task’s child sessions continue if the task cannot be complete in its current condition. However, in some cases, these child sessions need to be stopped, as the task subsequently creates new child sessions when the task is executed again. The old child sessions are no longer needed. This interim fix provides a flag to stop these old sessions. 

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: P103487

2.    Download location

Download interim fix 543928 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.2.1.1-build543928

4.    Installation and configuration

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

System requirements

Linux x86_64

Installation

a.      Log on to the master host as the cluster administrator, disable the applications and stop the SD service:

> egosh user logon -u Admin -x Admin

> soamcontrol app disable all 

> egosh service stop SD

b.      On each management host, create a directory (for example, /symfixes) and download the soamcore-7.2.1.1_x86_64_build543928.tar.gz package to the directory.

c.      Use the egoinstallfixes command to install the package:

> egoinstallfixes /symfixes/soamcore-7.2.1.1_x86_64_build543928.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.

d.     Enable this enhancement by manually editing the sd.xml file:

1)    Open the $EGO_CONFDIR/../../eservice/esc/conf/services/sd.xml file.

2)    Configure the SSM_CLOSE_CHILD_SESSIONS_OF_RETRIED_TASK environment variable. Valid values are TRUE or FALSE. The default is FALSE.

For example, to close all child sessions for a retried task, set the value to TRUE, as follows:

<sc:ServiceDefinition ...>

    …

    <sc:ActivityDescription>

        <ego:Attribute name="hostType" type="xsd:string">X86_64</ego:Attribute>

        <ego:ActivitySpecification>

      …

        <ego:EnvironmentVariable name="SSM_CLOSE_CHILD_SESSIONS_OF_RETRIED_TASK">TRUE</ego:EnvironmentVariable>

        …

        </ego:ActivitySpecification>

    </sc:ActivityDescription>

    …

</sc:ServiceDefinition>

3)    Apply your changes:

> egosh service modify SD -f $EGO_CONFDIR/../../eservice/esc/conf/services/sd.xml

e.   Start the SD service and enable applications:

> egosh service start SD

> soamcontrol app enable appName

5.    Uninstallation

If required, follow the instructions in this section to uninstall this interim fix from your cluster.

a.      Log on to the master host as the cluster administrator, disable applications and stop the SD service:

> egosh user logon -u Admin -x Admin

> soamcontrol app disable all

> egosh service stop SD

b.      Log on to each management host and roll back this fix.

> egoinstallfixes -r 543928

d.      Remove the SSM_CLOSE_CHILD_SESSIONS_OF_RETRIED_TASK environment variable from the sd.xml file.

e.   Start the SD service and enable applications:

> egosh service start SD

> soamcontrol app enable appName

6.    List of files

soam/7.2.1/linux-x86_64/etc/sd

soam/7.2.1/linux-x86_64/etc/ssm

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 2020

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.