Readme File for IBM® Spectrum Symphony 7.2.0.2 Interim Fix 547183 

Readme File for: IBM Spectrum Symphony

Product Release: 7.2.0.2

Update Name: Interim Fix 547183

Fix ID: sym-7.2.0.2-build547183-ms

Publication Date: May 15, 2020

This interim fix resolves common data compression issues with an IBM Spectrum Symphony client with multicluster session level workload placement enabled. This scenario occurs when there is a session migration due to failover or resource starvation. The recovered session incorrectly processes the common data with the checksum feature enabled.

 

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

2.    Download location

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

3.    Product and components affected

Component name, Platform, Fix ID:

SOAM, Windows x86_64, Linux x86_64, sym-7.2.0.2-build547183-ms

4.    Installation and configuration

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

System requirements

Windows x86_64, Linux x86_64

Installing on IBM Spectrum Symphony Linux hosts

Install this interim fix on all IBM Spectrum Symphony Linux hosts in the cluster:

a)     Log on to the master host in the cluster as the cluster administrator and disable all applications:

       > egosh user logon -u Admin -x Admin

   > soamcontrol app disable all

b)     Log on to each host in your cluster as the cluster administrator and backup the following files for recovery purposes:

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

$SOAM_HOME/7.2/linux-x86_64/lib/libsoambase.so

c)     Download the sym-7.2.0.2_x86_64_build547183.tar.gz package and extract its contents to the $EGO_TOP installation directory:

$ tar zxfo sym-7.2.0.2_x86_64_build547183.tar.gz -C $EGO_TOP

d)      Check the modified time of the following files to verify that the fix was installed correctly:

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

$SOAM_HOME/7.2/linux-x86_64/lib/libsoambase.so

e)      From the master, enable your applications:

   > soamcontrol app enable appName

Installing on IBM Spectrum Symphony Developer Edition Linux hosts

Install this interim fix on all IBM Spectrum Symphony Developer Edition Linux hosts in the cluster:

a)     Log on to each host in your cluster as the cluster administrator. Ensure that no client processes are running, and backup the following files for recovery purposes:

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

$SOAM_HOME/7.2/linux-x86_64/lib/libsoambase.so

b)     Download the symde-7.2.0.2_x86_64_build547183.tar.gz package and extract its contents to the $SOAM_HOME installation directory:

> tar zxfo symde-7.2.0.2_x86_64_build547183.tar.gz -C $SOAM_HOME

c)      Check the modified time of the following files to verify that the fix was installed correctly:

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

$SOAM_HOME/7.2/linux-x86_64/lib/libsoambase.so

Installing on IBM Spectrum Symphony client Linux hosts

Install this interim fix on all IBM Spectrum Symphony client Linux hosts in the cluster:

a)     Log on to each client host in your cluster as the cluster administrator. Ensure that no client processes are running, and backup the following files for recovery purposes:

$SOAM_HOME/lib64/libsoambase.so

$SOAM_HOME/lib/libsoambase.so

b)     Download the symclnt-7.2.0.2.x86_64_build547183.tar.gz package and extract its contents to the $SOAM_HOME installation directory:

> tar zxfo symclnt-7.2.0.2.x86_64_build547183.tar.gz -C $SOAM_HOME

c)      Check the modified time of the following files to verify that the fix was installed correctly:

$SOAM_HOME/lib64/libsoambase.so

$SOAM_HOME/lib/libsoambase.so

Installing on IBM Spectrum Symphony Windows hosts

Install this interim fix on all IBM Spectrum Symphony Windows hosts in the cluster:

a)     Log on to the master host in the cluster as the cluster administrator and disable all applications:

       > egosh user logon -u Admin -x Admin

   > soamcontrol app disable all

b)     Log on to each host in your cluster as the cluster administrator and backup the following files for recovery purposes:

%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib\soambase.dll

%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib\soambase.lib

%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib\soambase.pdb

%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib64\soambase.dll

%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib64\soambase.lib

%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib64\soambase.pdb

c)     Download the sym-7.2.0.2_build547183.zip package and extract its contents to the top level installation directory.

d)     Check the modified time of the following files to verify that the fix was installed correctly:

%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib\soambase.dll

%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib\soambase.lib

%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib\soambase.pdb

%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib64\soambase.dll

%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib64\soambase.lib

%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib64\soambase.pdb

e)      From the master, enable your applications:

   > soamcontrol app enable appName

Installing on IBM Spectrum Symphony Developer Edition Windows hosts

Install this interim fix on all IBM Spectrum Symphony Developer Edition Windows hosts in the cluster:

a)     Log on to each host in your cluster as the cluster administrator. Ensure that no client processes are running, and backup the following files for recovery purposes:

%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib\soambase.dll

%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib\soambase.lib

%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib\soambase.pdb

%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib64\soambase.dll

%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib64\soambase.lib

%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib64\soambase.pdb

b)  Download the symde-7.2.0.2_build547183.zip package and extract its contents to the %SOAM_HOME% directory:

c)  Check the modified time of the following files to verify that the fix was installed correctly:

%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib\soambase.dll

%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib\soambase.lib

%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib\soambase.pdb

%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib64\soambase.dll

%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib64\soambase.lib

%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib64\soambase.pdb

Installing on IBM Spectrum Symphony client Windows hosts

Install this interim fix on all IBM Spectrum Symphony client Windows hosts in the cluster:

a)     Log on to each client host in your cluster as the cluster administrator. Ensure that no client processes are running, and backup the following files for recovery purposes:

%SOAM_HOME%\lib\soambase.dll

%SOAM_HOME%\lib\soambase.lib

%SOAM_HOME%\lib\soambase.pdb

%SOAM_HOME%\lib64\soambase.dll

%SOAM_HOME%\lib64\soambase.lib

%SOAM_HOME%\lib64\soambase.pdb

b)     Download the symclnt-7.2.0.2_build547183.zip package and extract its contents to the %SOAM_HOME% directory:

c)     Check the modified time of the following files to verify that the fix was installed correctly:

%SOAM_HOME%\lib\soambase.dll

%SOAM_HOME%\lib\soambase.lib

%SOAM_HOME%\lib\soambase.pdb

%SOAM_HOME%\lib64\soambase.dll

%SOAM_HOME%\lib64\soambase.lib

%SOAM_HOME%\lib64\soambase.pdb

5.    Uninstallation

If required, follow the instructions in this section to uninstall this interim fix from your cluster. Ensure that no client or services processes are running on the current hosts.

Uninstalling from IBM Spectrum Symphony Linux hosts 

a)     Log on to the master host in the cluster as the cluster administrator and disable all applications:

       > egosh user logon -u Admin -x Admin

   > soamcontrol app disable all

b)     Log on to each host in your cluster as the cluster administrator and restore the following files from your backup:

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

$SOAM_HOME/7.2/linux-x86_64/lib/libsoambase.so

c)      From the master, enable your applications:

   > soamcontrol app enable appName

Uninstalling from IBM Spectrum Symphony Developer Edition Linux hosts 

Log on to each host as the cluster administrator, ensure that no client or services processes are running and restore the following files from your backup:

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

$SOAM_HOME/7.2/linux-x86_64/lib/libsoambase.so

Uninstalling from IBM Spectrum Symphony client Linux hosts 

Log on to each client host as the cluster administrator, ensure that no client or services processes are running and restore the following files from your backup:

$SOAM_HOME/lib64/libsoambase.so

$SOAM_HOME/lib/libsoambase.so

Uninstalling from IBM Spectrum Symphony Windows hosts 

a)     Log on to the master host in the cluster as the cluster administrator and disable all applications:

       > egosh user logon -u Admin -x Admin

   > soamcontrol app disable all

b)     Log on to each host in your cluster as the cluster administrator and restore the following files from your backup:

%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib\soambase.dll

%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib\soambase.lib

%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib\soambase.pdb

%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib64\soambase.dll

%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib64\soambase.lib

%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib64\soambase.pdb

c)     From the master, enable your applications:

   > soamcontrol app enable appName

     Uninstalling from IBM Spectrum Symphony Developer Edition Windows hosts 

Log on to each host as the cluster administrator, ensure that no client or services processes are running and restore the following files from your backup:

%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib\soambase.dll

%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib\soambase.lib

%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib\soambase.pdb

%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib64\soambase.dll

%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib64\soambase.lib

%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib64\soambase.pdb

Uninstalling from IBM Spectrum Symphony client Windows hosts 

Log on to each client host as the cluster administrator, ensure that no client or services processes are running and restore the following files from your backup:

%SOAM_HOME%\lib\soambase.dll

%SOAM_HOME%\lib\soambase.lib

%SOAM_HOME%\lib\soambase.pdb

%SOAM_HOME%\lib64\soambase.dll

%SOAM_HOME%\lib64\soambase.lib

%SOAM_HOME%\lib64\soambase.pdb

6.    List of files

   sym-7.2.0.2_x86_64_build547183.tar.gz

soam/7.2/linux-x86_64/lib64/libsoambase.so

soam/7.2/linux-x86_64/lib/libsoambase.so

symde-7.2.0.2_x86_64_build547183.tar.gz

7.2/linux-x86_64/lib64/libsoambase.so

7.2/linux-x86_64/lib/libsoambase.so

symclnt-7.2.0.2.x86_64_build547183.tar.gz

lib64/libsoambase.so

lib/libsoambase.so

sym-7.2.0.2_build547183.zip

soam\7.2\w2k3_x64-vc7-psdk\lib\soambase.dll

soam\7.2\w2k3_x64-vc7-psdk\lib\soambase.lib

soam\7.2\w2k3_x64-vc7-psdk\lib\soambase.pdb

soam\7.2\w2k3_x64-vc7-psdk\lib64\soambase.dll

soam\7.2\w2k3_x64-vc7-psdk\lib64\soambase.lib

soam\7.2\w2k3_x64-vc7-psdk\lib64\soambase.pdb

symde-7.2.0.2_build547183.zip

7.2\w2k3_x64-vc7-psdk\lib\soambase.dll

7.2\w2k3_x64-vc7-psdk\lib\soambase.lib

7.2\w2k3_x64-vc7-psdk\lib\soambase.pdb

7.2\w2k3_x64-vc7-psdk\lib64\soambase.dll

7.2\w2k3_x64-vc7-psdk\lib64\soambase.lib

7.2\w2k3_x64-vc7-psdk\lib64\soambase.pdb

symclnt-7.2.0.2_build547183.zip

lib\soambase.dll

lib\soambase.lib

lib\soambase.pdb

lib64\soambase.dll

lib64\soambase.lib

lib64\soambase.pdb

7.    Product notification

To receive information about product solution and patch updates automatically, subscribe to product notifications on the My Notifications page 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.