Readme File for IBM® Spectrum Symphony 7.3 Interim Fix 601467

Readme File for: IBM Spectrum Symphony

Product Release: 7.3

Update Name: Interim Fix 601467

Fix ID: sym-7.3-build601467

Publication Date: February 22, 2023

 

This interim fix provides a resolution when SD deadlocks, as a result of running the soamreg -f command multiple times, concurrently, in IBM Spectrum Symphony 7.3.

 

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

2.  Download location

Download interim fix 601467 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, Windows x86_64, sym-7.3-build601467

4.  Installation and configuration

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

System requirements

Linux x86_64, Windows x86_64

Installation on Linux host

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

> egosh user logon -u Admin -x password

> soamcontrol app disable all

> egosh service stop SD

b.      On each management host, create a directory (for example, /symfixes directory) and download the soamcore-7.3.0.0_x86_64_build601467.tar.gz package to the directory.

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

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

Important: Running the egoinstallfixes command automatically backs up the current binary files to a fix backup directory.  For recovery purposes of the original file, do not delete this backup directory. For more information on using this command, see the egoinstallfixes command reference.

d.      Run the pversions command to verify the installation:

> pversions -b 601467

e.      From the primary host, start the SD service and enable your applications:

> egosh service start SD

> soamcontrol app enable applicationName

Installation on Windows host

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

> egosh user logon -u Admin -x password

> soamcontrol app disable all

> egosh service stop SD

b.       On each management host, copy the sym-7.3.0.0-soamcore-7.3.0.0_build601467.msp package, and complete one of the following steps:

ž   For an interactive installation, double-click the .msp packages and follow the prompts.

ž   For a silent installation, enter the following command from the IBM Spectrum Symphony command prompt:

C:\>msiexec /update C:\sym-7.3.0.0-soamcore-7.3.0.0_build601467.msp /l*v updateSym.log /norestart /quiet REINSTALLMODE=omus

The command syntax is as follows:

C:\>msiexec /update sym_package_name_path /l*v sym_install_log /norestart /quiet REINSTALLMODE=omus

where:

ž sym_package_name_path is the fully qualified file name to the .msp package.

ž sym_install_log is the log file for the interim fix.

c.       Run the pversions command to verify the installation:

> pversions

d.       From the primary host, start the SD service and enable your applications:

> egosh service start SD

> soamcontrol app enable applicationName

5.  Uninstallation

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

Uninstallation on Linux host

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

> egosh user logon -u Admin -x password

> soamcontrol app disable all

> egosh service stop SD

b.      Log on to each management host and roll back this interim fix:

> egoinstallfixes -r 601467

c.       From the primary host, start the SD service and enable your applications:

> egosh service start SD

> soamcontrol app enable applicationName

Uninstallation on Windows host

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

> egosh user logon -u Admin -x password

> soamcontrol app disable all

> egosh service stop SD

b.       Log on to each host in the cluster and roll back to the previous version of IBM Spectrum Symphony, either from Windows Control Panel or from the IBM Spectrum Symphony command prompt:

ž   To roll back from the Windows Control Panel, go to Control Panel > Programs and Features > View installed updates, click Update for Symphony 7.3.0 (build “601467”) and click Uninstall.

ž   To roll back from the IBM Spectrum Symphony command prompt, enter the following commands:

C:\>msiexec /uninstall {4BD671F9-FF5E-4044-8CC0-6D74C82BD78B} /package {5B7B0C11-4DDB-4C5F-96A2-D1DCF66DBB64} /norestart /quiet /l*v sym_rollback.log

The command syntax is as follows:

C:\>msiexec /uninstall interim_fix_code /package product_code /norestart /quiet /l*v rollback_log

where:

ž interim_fix_code is the identifier of the .msp package for the interim fix; for example, {4BD671F9-FF5E-4044-8CC0-6D74C82BD78B}.

ž product_code is the identifier of the .msi file in the original product installation package; for example, {5B7B0C11-4DDB-4C5F-96A2-D1DCF66DBB64}.

ž rollback_log is the name of the log file to capture details of the rolled back interim fix; for example, sym_rollback.log.

c.       From the primary host, start the SD service and enable your applications:

> egosh service start SD

> soamcontrol app enable applicationName

6.     List of files

soamcore-7.3.0.0_x86_64_build601467.tar.gz

soam/7.3/linux-x86_64/etc/sd

sym-7.3.0.0-soamcore-7.3.0.0_build601467.msp

soam\7.3\w2k3_x64-vc7-psdk\etc\sd.exe

soam\7.3\w2k3_x64-vc7-psdk\etc\sd.pdb

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 2023

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 jurisimictions 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.