Readme
File for IBM® Spectrum Symphony
7.2.0.2 Interim Fix 550995
Readme
File for: IBM Spectrum Symphony
Product
Release: 7.2.0.2
Update
Name: Interim Fix 550995
Fix
ID: sym-7.2.0.2-build550995-ms
Publication
Date: July 6, 2020
This interim fix resolves a misleading exception message on the
client side, when the client fails to connect to the IBM Spectrum Symphony multicluster master cluster and the
home cluster in IBM
Spectrum Symphony 7.2.0.2.
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:
P103720
2.
Download
location
Download
interim fix 550995 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-build550995-ms
4.
Installation
and configuration
Follow
the instructions in this section to download and install this interim fix to 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 back up 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_build550995.tar.gz package and extract its
contents to the $EGO_TOP installation directory:
> tar zxfo sym-7.2.0.2_x86_64_build550995.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 host, 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 back up
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_build550995.tar.gz package and extract its contents to
the $SOAM_HOME
installation directory:
> tar zxfo symde-7.2.0.2_x86_64_build550995.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 back up 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_build550995.tar.gz package and extract its
contents to the $SOAM_HOME
installation directory:
>
tar zxfo symclnt-7.2.0.2.x86_64_build550995.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 back up 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_build550995.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 host, 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 back up
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_build550995.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 back up 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_build550995.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 host, 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 host, 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_build550995.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_build550995.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_build550995.tar.gz
lib64/libsoambase.so
lib/libsoambase.so
sym-7.2.0.2_build550995.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_build550995.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_build550995.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.