Readme File for IBM® Spectrum Symphony 7.2.1 Interim Fix 600827

Readme File for: IBM Spectrum Symphony

Product Release: 7.2.1

Update Name: Interim Fix 600827

Fix ID: sym-7.2.1-build600827-ms

Publication Date:   February 14, 2022

 

Interim fix for the IBM Spectrum Symphony client to select the correct SSM URL based on the SOAM_USE_VIRTUAL_HOSTNAME environment variable.

 

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

2.    Download location

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

3.    Product and components affected

Component name, Platform, Fix ID:

SOAM SD, Linux x86_64, sym-7.2.1-build600827-ms

SOAM SDK library, Linux x86_64 and Windows x86_64, sym-7.2.1-build600827-ms

 

4.    Installation and configuration

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

System requirements

·       IBM Spectrum Symphony: Linux x86_64

·       IBM Spectrum Symphony client:

o   Linux x86_64

o   Windows x86_64

Prerequisites

Before applying this interim fix, install the IBM Spectrum Symphony 7.2.1 enhancement 600650 on your primary host, primary candidate hosts, and management hosts.

 

Installing on IBM Spectrum Symphony management hosts and compute hosts

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

> egosh user logon -u Admin -x Admin

b.      Disable all applications, stop all services, and shut down the cluster:

> soamcontrol app disable all

> egosh service stop all

> egosh ego shutdown

c.       On each management and compute host, download the soamcore-7.2.1.0_x86_64_build600827.tar.gz package to, for example, the /symfixes directory.

d.      Run the egoinstallfixes command to install the soamcore-7.2.1.0_x86_64_build600827.tar.gz package:

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

Note: Running the egoinstallfixes command automatically backs up the current binary files to a fix backup directory for recovery purposes. Do not delete this backup directory; you will need it if you want to recover the original files. For more information on using this command, see the egoinstallfixes command reference.

e.      Run the pversions command to verify the installation: 

> pversions -b 600827

f.        Log on to the primary host, start the cluster, and enable your applications:

> egosh ego start all

> soamcontrol app enable application_name

Installing on IBM Spectrum Symphony client hosts on Linux

a.      Log on to the IBM Spectrum Symphony client host and stop the running client.

b.      Back up the following files which will be replaced by this interim fix:

$SOAM_HOME/lib/libsoambase.so

$SOAM_HOME/lib64/libsoambase.so

c.       Download the symclnt-7.2.1.0_x86_64-build600827.tar.gz file and extract its contents to the top-level installation directory:

> tar zxfo symclnt-7.2.1.0_x86_64-build600827.tar.gz -C $SOAM_HOME

Installing on IBM Spectrum Symphony client hosts on Windows

a.      Log on to the IBM Spectrum Symphony client host and stop the running client.

b.      Back up the following files which will be replaced by this interim fix:

%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

c.       Download the symclnt-7.2.1.0_build600827.tar.gz file and extract its contents to %SOAM_HOME% directory.

5.    Uninstallation

Uninstalling from IBM Spectrum Symphony management hosts and compute hosts

a.      Log on to the IBM Spectrum Symphony management as the cluster administrator:

> egosh user logon -u Admin -x Admin

b.      Stop all applications, stop all services, and shut down the cluster:

> soamcontrol app disable all

> egosh service stop all

> egosh ego shutdown

c.       On each management or compute host, roll back this interim fix:

> egoinstallfixes -r 600827

d.      Log on to the primary host, start the cluster, and enable your applications:

> egosh ego start all

> egosh user logon -u Admin -x Admin

> soamcontrol app enable application_name

Uninstalling from IBM Spectrum Symphony client hosts on Linux

a.      Log on to the IBM Spectrum Symphony client host and stop the running client.

b.      Restore your backup version of the following files:

$SOAM_HOME/lib/libsoambase.so

$SOAM_HOME/lib64/libsoambase.so

Uninstalling from IBM Spectrum Symphony client hosts on Windows

a.      Log on to the IBM Spectrum Symphony client host and stop the running client.

b.      Restore your backup version of the following files:

%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

soamcore-7.2.1.0_x86_64_build600827.tar.gz c61656a298da794a7be4744708889075

soam/7.2.1/linux-x86_64/etc/sd 5060657aac191dc26fe4eaf70494b897

soam/7.2.1/linux-x86_64/lib64/libsoambase.so 382c3e11a2750a8941470ba1c469ce98

soam/7.2.1/linux-x86_64/lib/libsoambase.so 7c83f8f9e922982b5f8c6c04cb2923e2

symclnt-7.2.1.0_x86_64-build600827.tar.gz f9036ed6e24a2c1a1de105fe2b4115f3

lib64/libsoambase.so 382c3e11a2750a8941470ba1c469ce98

lib/libsoambase.so 7c83f8f9e922982b5f8c6c04cb2923e2

symclnt-7.2.1.0_build600827.tar.gz 45add72346eb79fcec687fd7cab2b01c

lib\soambase.dll b0d96612fafdcf695c4f9b257ee200cd

lib\soambase.lib cf0bc89cb4607f9fb6c27f87ba4ac429

lib\soambase.pdb 206c9005a3fcb91a3a4a8c6bf6647e4d

lib64\soambase.dll bcdd1c9c843479481c36319bbdf45ec8

lib64\soambase.lib fe5820ec535ad16a6d5734cf63398abb

lib64\soambase.pdb e7919770f6181087f61d9eabc11e853c

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.