Readme File for IBM^® Spectrum Symphony 7.1.2 Interim Fix 538070

Readme File for: IBM Spectrum Symphony

Product Release: 7.1.2

Update Name: Interim Fix 538070

Fix ID: sym-7.1.2-build538070-jpmc

Publication Date: January 16, 2020

This interim fix resolves the client hanging when using the SoamConnection.openSession method for Java API.

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

2.   Download location

Download interim fix 538070 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.1.2-build538070-jpmc

4.   Installation and configuration

System requirements

linux-x86_64

Installing on IBM Spectrum Symphony Developer Edition and client hosts

a.      Log on to the master host as cluster administrator and disable your applications:

> egosh user logon -u Admin -x Admin

> soamcontrol app disable all

b.      For recovery purposes, back up the following files, which will be replaced by this interim fix:

·       Log on to each IBM Spectrum Symphony Developer Edition host and back up the following file:

$SOAM_HOME/7.1.2/linux-x86_64/lib64/libsoambase.so

·       Log on to each client host and back up the following file:

$SOAM_HOME/lib64/libsoambase.so

c.      Install this interim fix:

·       On each IBM Spectrum Symphony Developer Edition host, copy the symde-7.1.2.0_x86_64_build538070.tar.gz package and decompress it to the top-level installation directory:

> tar zxfo symde-7.1.2.0_x86_64_build538070.tar.gz -C $SOAM_HOME

·       On each client host, copy the symclnt-7.1.2.0.x86_64_build538070.tar.gz package and decompress it to the top-level installation directory:

> tar zxfo symclnt-7.1.2.0.x86_64_build538070.tar.gz -C $SOAM_HOME

d.      Log on to the master host as cluster administrator and enable your applications:

> egosh user logon -u Admin -x Admin

> soamcontrol app enable <appName>

  

  When you submit workload, you can set the API_CALL_TIMEOUT environment variable on the client side:

     Syntax: API_CALL_TIMEOUT=value

Description: Defines the number of seconds the IBM Spectrum Symphony API waits to complete the API call to the session director or session manager before it times out. For a client to submit workload, the client must connect to an application and then call the IBM Spectrum Symphony API to interact with a session created on this connection. The timeout value can be any unsigned integer and -1, which is treated specially to specify that the API never times out.

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 cluster administrator and disable your applications:

> egosh user logon -u Admin -x Admin

> soamcontrol app disable all

b.      Restore the following files from your backup:

·       Log on to each IBM Spectrum Symphony Developer Edition host and restore the following file from your backup:

$SOAM_HOME/7.1.2/linux-x86_64/lib64/libsoambase.so

·       Log on to each client host and restore the following file from your backup:

$SOAM_HOME/lib64/libsoambase.so

c.      Log on to the master host as cluster administrator and enable your applications:

> egosh user logon -u Admin -x Admin

> soamcontrol app enable <appName>

6.   List of files

symde-7.1.2.0_x86_64_build538070.tar.gz:

7.1.2/linux-x86_64/lib64/libsoambase.so

symclnt-7.1.2.0.x86_64_build538070.tar.gz:

lib64/libsoambase.so

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.