Interim fix 602046 for IBM Spectrum Symphony 7.3

Readme File for IBM^® Spectrum Symphony 7.3.0 Interim Fix 602046

Readme File for: IBM Spectrum Symphony

Product Release: 7.3.0

Update Name: Interim Fix 602046

Fix ID: sym-7.3-build602046

Publication Date: May 31, 2024

This interim fix resolves an issue where the IBM Spectrum Symphony 7.3 client is unable to connect to the session director (SD) when SSL is enabled, caused by failing to read SSL-related parameters when CURL is specified for the Soamfactory::connect() 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: P105142

2. Download location

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

3. Product and components affected

Component name, Platform, Fix ID:

SOAM/SOAM SDK, Linux-x86_64 64, sym-7.3-build602046

4. Installation and configuration

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

System requirements

Linux x86_64

Installing on IBM Spectrum Symphony management and compute hosts

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

> egosh user logon –u Admin –x password

> soamcontrol app disable all

b. On each management and compute host, download the soamcore-7.3.0.0_x86_64_build602046.tar.gz package, for example, to the /symfixes directory.

c. Run the egoinstallfixes command to install the soamcore-7.3.0.0_x86_64_build602046.tar.gz file:

> egoinstallfixes /symfixes/soamcore-7.3.0.0_x86_64_build602046.tar.gz

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.

d. Run the pversions command to verify the installation:

> pversions -b 602046

e. Log on to the primary host as the cluster administrator, enable your applications:

> soamcontrol app enable application_name

Installing on IBM Spectrum Symphony Develop Edition hosts

a. Log on to the IBM Spectrum Symphony Develop Edition host as the cluster administrator and stop the agent:

> soamshutdown

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

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

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

c. Download the symde-7.3.0.0_x86_64_build602046.tar.gz file and decompress to the $SOAM_HOME directory, for example:

> tar zxfo symde-7.3.0.0_x86_64_build602046.tar.gz -C $SOAM_HOME

d. On the IBM Spectrum Symphony Develop Edition host, start the agent:

> soamstartup &

Installing on IBM Spectrum Symphony client hosts

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.3.0.0_x86_64_build602046.tar.gz file and extract its contents to the $SOAM_HOME installation directory:

> tar zxfo symclnt-7.3.0.0_x86_64_build602046.tar.gz -C $SOAM_HOME

5. Uninstallation

If required, follow the instructions in this section to uninstall this interim fix from your cluster:

Uninstalling from IBM Spectrum Symphony management and compute hosts

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

> egosh user logon -u Admin -x password

> soamcontrol app disable all

b. On each management and compute host, roll back this interim fix:

> egoinstallfixes -r 602046

c. Log on to the primary host as the cluster administrator, enable your applications:

> soamcontrol app enable application_name

Uninstalling from IBM Spectrum Develop Edition hosts

a. Log on to the IBM Spectrum Symphony Develop Edition host as the cluster administrator and stop the agent:

> soamshutdown

b. Log on to each IBM Spectrum Symphony Develop Edition host in the cluster and restore your backup files:

$SOAM_HOME\7.3\linux-x86_64\lib64\libsoambase.so

$SOAM_HOME\7.3\linux-x86_64\lib\libsoambase.so

c. On the IBM Spectrum Symphony Develop Edition host, start the agent:

> soamstartup &

Uninstallaing from IBM Spectrum Symphony client hosts

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

b. Restore your backup files:

$SOAM_HOME\lib\libsoambase.so

$SOAM_HOME\lib64\libsoambase.so

6. List of files

d93c027f260e40b13988517afc7536e3 soamcore-7.3.0.0_x86_64_build602046.tar.gz/soam/7.3/linux-x86_64/lib/libsoambase.so
8873bd0ead6768ccfafb33046c4a100b soamcore-7.3.0.0_x86_64_build602046.tar.gz/soam/7.3/linux-x86_64/lib64/libsoambase.so
d93c027f260e40b13988517afc7536e3 symclnt-7.3.0.0_x86_64_build602046.tar.gz/lib/libsoambase.so
8873bd0ead6768ccfafb33046c4a100b symclnt-7.3.0.0_x86_64_build602046.tar.gz/lib64/libsoambase.so
d93c027f260e40b13988517afc7536e3 symde-7.3.0.0_x86_64_build602046.tar.gz/7.3/linux-x86_64/lib/libsoambase.so
8873bd0ead6768ccfafb33046c4a100b symde-7.3.0.0_x86_64_build602046.tar.gz/7.3/linux-x86_64/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

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.