Readme File for IBM^® Spectrum Symphony RFE 145645

Readme file for: IBM Spectrum Symphony

Product release: 7.2.1

Fix ID: sym-7.2.1-build564819-ms

Publication date: November 23, 2020

Last modified date: November 23, 2020

This enhancement provides two connection configuration attributes:

·        PLATCOMMDRV_BACKLOG_SIZE_ON_LINUX in the sd.xml configuration file to allow you to configure the number of connection requests to be held in the backlog, for one SD (session director) service call and SSM (session management). 

·        EGO_PLATCOMMDRV_BACKLOG_SIZE_ON_LINUX in the ego.conf configuration file to allow you to configure the number of connection requests to be held in the backlog for VEMKD. 

1.    Scope

Before you install this enhancement to your cluster, note the following requirements:

Management host operating system	Linux RHEL 6.x or 7.x
Product version	IBM Spectrum Symphony 7.2.1

 

2.    Installation

Follow these instructions to download and install this enhancement on hosts in your cluster.

Prerequisites

IBM Spectrum Symphony 7.2.1 Advanced Edition must be installed on Linux hosts in your cluster, and interim fix 563042 must installed in your cluster.

Installing on Linux management hosts

a.       Log on to the primary host as the cluster administrator, disable all applications, stop all services and shutdown your cluster:

> egosh user logon -u Admin -x Admin

> soamcontrol app disable all -f

> egosh service stop all

> egosh ego shutdown

b.       On each management host, create a directory (for example, /symfixes) and download the soamcore-7.2.1.0_x86_64_build564819.tar.gz and egocore-3.7.0_x86_64_build564819.tar.gz files to the directory.

c.       Run the egoinstallfixes command to install the soamcore-7.2.1.0_x86_64_build564819.tar.gz and egocore-3.7.0_x86_64_build564819.tar.gz files:

> egoinstallfixes /symfixes/soamcore-7.2.1.0_x86_64_build564819.tar.gz

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

3.    Configuration and usage

This enhancement provides a new attribute in the sd.xml file, called PLATCOMMDRV_BACKLOG_SIZE_ON_LINUX, which allows you to configure the number of connections that can remain in the backlog for the SD service and SSM.

Required or optional: Optional

Valid values: 1 to 36864

Default value: 1000

This enhancement also provides the attribute in the ego.conf file, called EGO_PLATCOMMDRV_BACKLOG_SIZE_ON_LINUX, which allows you to configure the number of connections that can remain in the backlog for the VEMKD. 

Required or optional: Optional

Valid values: 1 to 36864

Default value: 1024

Configuration

a.      On each management host, edit the $EGO_ESRVDIR/esc/conf/services/sd.xml file to add the PLATCOMMDRV_BACKLOG_SIZE_ON_LINUX configuration:

<ego:EnvironmentVariable name="PLATCOMMDRV_BACKLOG_SIZE_ON_LINUX">value</ego:EnvironmentVariable> 

b.      On each management host, edit the $EGO_CONFDIR/ego.conf file to add the parameter EGO_PLATCOMMDRV_BACKLOG_SIZE_ON_LINUX configuration:

EGO_PLATCOMMDRV_BACKLOG_SIZE_ON_LINUX=value

c.       From the primary host, start the cluster and enable your applications:

> egosh ego start

> soamcontrol app enable appName

4.    Uninstallation

If required, uninstall this enhancement from management hosts in your cluster:

a.      Log on to the primary host as the cluster administrator, disable all applications, stop all services and shutdown your cluster:

> egosh user logon -u Admin -x Admin

> soamcontrol app disable all -f 

> egosh service stop all

> egosh ego shutdown

b.      On each management host, roll back this enhancement:

> egoinstallfixes -r 564819

c.       Edit the $EGO_ESRVDIR/esc/conf/services/sd.xml file and remove the PLATCOMMDRV_BACKLOG_SIZE_ON_LINUX configuration. 

d.      Edit the $EGO_CONFDIR/ego.conf file and remove the EGO_PLATCOMMDRV_BACKLOG_SIZE_ON_LINUX configuration.

e.      From the primary host, start the cluster and enable your applications:

> egosh ego start

> soamcontrol app enable appName

5.    List of files

egocore-3.7.0_x86_64_build564819.tar.gz;ec620afd179e53181882912d33d37b34

3.7/linux-x86_64/etc/vemkd;a7e8340bfb4f508e0a8d46962800f3b9

soamcore-7.2.1.0_x86_64_build564819.tar.gz; 22e408d52068f9a199053d3e1dae8606

soam/7.2.1/linux-x86_64/etc/sd;65a917f4ea1684ed797e62f84d15cf29

6.    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. 

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