Readme File for IBM® Spectrum Symphony 7.2.1.1 Interim Fix 601362

Readme file for: IBM Spectrum Symphony

Product/Component Release: 7.2.1.1

Fix ID: sym-7.2.1-build601362-ms

Publication date: December 9, 2022

Fix to update the IBM Spectrum Symphony host factory symA requestor plug-in to limit requests by the IBM Spectrum Symphony session manager's slot demand, instead of by the number of active tasks. This allows symA to scale workload with service to slot ratios that are not one to one. This fix also introduces the batch_return_mode configuration in symA to improve the performance for closing and removing hosts in host factory.

Contents

1.   List of fixes

2.   Download location

3.   Products or 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: P104768

2.    Download location

Download interim fix 601362 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-build601362-ms

4.    Installation and configuration

Follow these instructions to download and install this interim fix on the management hosts in your cluster.

     System requirements

Linux x86_64

Installation

a.     Log on to the primary host as the cluster administrator:

> egosh user logon -u Admin -x Admin

b.     Source the host environment:

(bash) > source $EGO_TOP/profile.platform

(csh) > source $EGO_TOP/cshrc.platform

c.     Stop all services:

> egosh service stop all

d.     On each management host, stop EGO:

> egosh ego shutdown

e.     On each management host, create a directory (for example, /symfixes) and download the egocore-3.7.0_x86_64_build601362.tar.gz package to the directory.

f.       Use the egoinstallfixes command to install the egocore-3.7.0_x86_64_build601362.tar.gz package:

> egoinstallfixes /symfixes/egocore-3.7.0_x86_64_build601362.tar.gz --silent

Important: Running the egoinstallfixes command automatically backs up the current binary files to a fix backup directory.  For recovery purposes of the original file, do not delete this backup directory. For more information on using this command, see the egoinstallfixes command reference.

g.     Use the pversions command to verify the installation:
> pversions -b 601362

h.     On each management host, start EGO, starting at the primary:

> egosh ego start

Configuration

1.     Create a backup copy of the symAreq_config.json file located in the $EGO_CONFDIR/../../eservice/hostfactory/conf/requestors/symA/conf directory.

2.     To enable the batch return feature, set "batch_return_mode" to true in symAreq_config.json. For example:

    "batch_return_mode": true,

 

In this example, symA will use the egosh resource close -b command option to pass the list of hosts to VEMKD in one request. Without the -b option, egosh resource close will make one request for each host. The default for this configuration is false for this fix.

5.    Uninstallation

If required, follow these instructions to uninstall this interim fix on Linux management hosts in your cluster.

a.     Log on to the primary host as the cluster administrator:

> egosh user logon -u Admin -x Admin

b.      Source the host environment:

(bash) > . $EGO_TOP/profile.platform

(csh) > source $EGO_TOP/cshrc.platform

c.      Stop all services:

> egosh service stop all

d.     On each management host, stop EGO:

> egosh ego shutdown

e.     Log on to each management host and roll back this interim fix:

> egoinstallfixes -r 601362

f.       Restore the backed up copy of the symAreq_config.json configuration file.

g.     On each management host, start EGO:

> egosh ego start

6.    List of files

3.7/hostfactory/requestors/symA/scripts/Main.py 0c59ef2d52131e4ff6b16991fe7749aa

3.7/linux-x86_64/bin/egosh 96e8af986815c2985309506e289c4c8f

3.7/linux-x86_64/etc/vemkd 838e7945cf8b1a7fabb44a7baca3b0c8

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.