Readme File for IBM® Spectrum Symphony 7.3.1 Interim Fix 600863

Readme file for: IBM Spectrum Symphony

Product release: 7.3.1

Update Name: Interim Fix 600863

Fix ID: sym-7.3.1-build600863-cs

Publication date: January 14, 2022


This fix applies to the IBM Spectrum Symphony multicluster feature. It resolves connection issues from the multicluster primary host to an IBM Spectrum Symphony 7.3.1 cluster with the outbound connection feature enabled.

 Contents

1. List of fixes

2. Download location

3. Product and components affected

4. Installation and usage

5. Uninstallation

6. List of files

7.  Product notifications

8.  Copyright and trademark information

 

1.    List of fixes

APAR: P104464

2.    Download location

Download interim fix 600863 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, sym-7.3.1-build600863-cs

4.    Installation and usage

Installing on the IBM Spectrum Symphony multicluster primary cluster

a.        Log on to the multicluster primary cluster as the cluster administrator:

egosh user logon -u Admin -x Admin

b.        Shut down the SMCM:

egosh service stop SMCM

c.        On the primary host (and on each primary candidate host), copy the symmc-7.3.1.0_build600863.msp package to a temporary location on the host and install the package:

o   For an interactive installation, double-click the symmc-7.3.1.0_build600863.msp package and follow the prompts.

o   For a silent installation, enter the following command from the command prompt:

C:\>msiexec /update C:\symmc-7.3.1.0_build600863.msp /l*v install.log /norestart /quiet REINSTALLMODE=omus 

The command syntax is as follows:

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

where:

o   sym_package_name_path is the fully qualified path to the .msp package; in this case, C:\symmccore-7.3.1.0_build600863.msp.

o   install.log is the log file for the upgrade. 

d.     Use the pversions command to verify the installation:

> pversions

e.     Start the SMCM service:

> egosh service start SMCM

Installing on IBM Spectrum Symphony management hosts

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

a.     Log on to the primary host as the cluster administrator and stop the SMCP service:

> egosh service stop SMCP

b.     On each management host, download the sym-7.3.1.0-soamcore-7.3.1.0_build600863.msp package to a temporary location on the host and install the package:

o   For an interactive installation, double-click the .msp package and follow the prompts.

o   For a silent installation, enter the following command from the command prompt:

C:\>msiexec /update C:\sym-7.3.1.0-soamcore-7.3.1.0_build600863.msp /l*v install.log /norestart /quiet REINSTALLMODE=omus 

The command syntax is as follows:

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

where:

o   sym_package_name_path is the fully qualified path to the .msp package; in this case, C:\sym-7.3.1.0-soamcore-7.3.1.0_build600863.msp.

o   install.log is the log file for the upgrade.

c.     Use the pversions command to verify the installation:

> pversions

d.     Start the SMCP service:

> egosh service start SMCP

Usage

Three modifications were made in this fix:

1.     The EGO service credential for the SMCP is now updated once an hour and not every four hours. As a credential expires after eight hours, updating every four hours may lead to credential expiry if VEMKD was down at the four hours mark.

2.     The IBM Spectrum Symphony cluster information will be resent to the SMCM if the SMCM does not acknowledge receipt of this information.

3.     The outbound connection retry interval was reduced from 30 minutes to one minute after about five minutes of failed connection attempts.

This fix also simplifies the connection debugging between the SMCP and SMCM by logging the registration status at the default log level for both the SMCP and SMCM.

5.    Uninstallation

Uninstalling from the IBM Spectrum Symphony multicluster primary cluster

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

a.     Log on to the primary host as the cluster administrator and stop the SMCM service:

> egosh service stop SMCM

b.     On each management host, uninstall the fix:

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

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

C:\> msiexec /uninstall {3759C671-1612-4693-9528-7B4389C29881} /package {2D475A91-0059-4295-A44E-DCFC3DBA43B4} /norestart /quiet /l*v rollback.log

The command syntax is as follows:

C:\> msiexec /uninstall interim_fix_code /package product_code /norestart /quiet /l*v rollback.log

where:

o   interim_fix_code is the identifier of the .msp package for this interim fix, in this case, {3759C671-1612-4693-9528-7B4389C29881}.

o   product_code is the identifier of the .msi file for the original product installation package, in this case, {2D475A91-0059-4295-A44E-DCFC3DBA43B4}.

o   rollback.log is the name of the log file to capture details of the rollback.

c.     Start the SMCM service:

> egosh service start SMCM

Uninstalling from IBM Spectrum Symphony management hosts

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

d.     Log on to the primary host as the cluster administrator and stop the SMCP service:

> egosh service stop SMCP

e.     On each management host, uninstall the fix:

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

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

C:\> msiexec /uninstall {55768954-42B1-4542-B1F0-E5BEBA142D9C} /package {91FF0A77-C792-4BCD-B657-5B1D1762836E} /norestart /quiet /l*v rollback.log

The command syntax is as follows:

C:\> msiexec /uninstall interim_fix_code /package product_code /norestart /quiet /l*v rollback.log

where:

o   interim_fix_code is the identifier of the .msp package for this interim fix, in this case, {55768954-42B1-4542-B1F0-E5BEBA142D9C}.

o   product_code is the identifier of the .msi file for the original product installation package, in this case, {91FF0A77-C792-4BCD-B657-5B1D1762836E}.

o   rollback.log is the name of the log file to capture details of the rollback.

f.       Start the SMCP service:

> egosh service start SMCP

6.    List of files

symmc-7.3.1.0_build600863.msp

smc\7.3.1\w2k3_x64-vc7-psdk\etc\smcmaster.exe

smc\7.3.1\w2k3_x64-vc7-psdk\etc\smcmaster.pdb

sym-7.3.1.0-soamcore-7.3.1.0_build600863.msp

soam\7.3.1\w2k3_x64-vc7-psdk\etc\smcproxy.exe

soam\7.3.1\w2k3_x64-vc7-psdk\etc\smcproxy.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 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.