Readme File for IBM^® Spectrum Symphony 7.2.1 Interim Fix 601036

Readme File for: IBM Spectrum Symphony

Product Release: 7.2.1

Update Name: Interim Fix 601036

Fix ID: sym-7.2.1-build601036

Publication Date: March 9, 2022

 

This interim fix resolves a stop Docker pod timeout issue for IBM Spectrum Symphony 7.2.1. This fix adds a new DISABLE_STOPPING_DOCKER_POD_TWICE setting to disable IBM Spectrum Symphony from running the stop action twice, when the Docker daemon is unresponsive.

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

2.      Download location

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

3.      Product and components affected

Component name, Platform, Fix ID:

EGO, Linux x86_64, sym-7.2.1-build601036

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

Installing

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 -f

b.       On each management and compute host find and remove all the Python pyc files from $EGO_TOP/3.7/linux-x86_64/etc/egodocker/ and its subdirectories:

> find $EGO_TOP/3.7/linux-x86_64/etc/egodocker/ -name *.pyc -exec rm -f {} \;

c.       On each management and compute host, create a directory (for example, /symfixes) and download the egocore-3.7.0_x86_64_build601036.tar.gz file to the directory.

d.       Run the egoinstallfixes command to install the egocore-3.7.0_x86_64_build601036.tar.gz file:

> egoinstallfixes /symfixes/egocore-3.7.0_x86_64_build601036.tar.gz

Note: 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.

e.       Run the pversions command to verify the installation:

> pversions -b 601036

f.        From the primary host, enable your applications:

> soamcontrol app enable application_name

Configuring

By default, when the Docker daemon is unresponsive, IBM Spectrum Symphony attempts to stop the Docker container pod to a maximum of two attempts. To enable IBM Spectrum Symphony to disable the second try, configure the DISABLE_STOPPING_DOCKER_POD_TWICE setting in the Docker section of the application profile. Valid values are Y or y. By default, this setting is not enabled

      Here is an example of enable this setting:

      <osTypes>

        <osType name="X86_64" startCmd="/shared/cluster/sym721/soam/7.2.1/linux-x86_64/etc/sim" workDir="${EGO_CONFDIR}/../../soam/work">

          ...

          <env name="DISABLE_STOPPING_DOCKER_POD_TWICE">Y</env>

          ...

        </osType>

           </osTypes>

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 -f

b.       Log on to each management and compute host in the cluster and roll back this interim fix:

> egoinstallfixes -r 601036

c.      On each management and compute host find and remove all the Python pyc files from $EGO_TOP/3.7/linux-x86_64/etc/egodocker/ and its subdirectories:

> find $EGO_TOP/3.7/linux-x86_64/etc/egodocker/ -name *.pyc -exec rm -f {} \;

d.       From the primary host, enable your applications:

> soamcontrol app enable application_name

6.      List of files

3.7/linux-x86_64/etc/egodocker/dockercontroller.py
3.7/linux-x86_64/etc/egodocker/libs/pod/dockerclient.py
3.7/linux-x86_64/etc/egodocker/libs/pod/dockerpod.py
3.7/linux-x86_64/etc/egodocker/libs/pod/timeout.py
3.7/linux-x86_64/etc/egodocker/libs/pod/dockercontainers.py
3.7/linux-x86_64/etc/egodocker/libs/external/docker/api/container.py
3.7/linux-x86_64/etc/egodocker/libs/external/docker/api/image.py
3.7/linux-x86_64/etc/egodocker/libs/external/docker/utils/utils.py
3.7/linux-x86_64/etc/egodocker/libs/external/docker/client.py
3.7/linux-x86_64/etc/egodocker/libs/pod/constants.py

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 2022

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.