Readme File for IBM® Spectrum Symphony 7.3 Interim Fix 601265
Readme file for: IBM Spectrum Symphony
Product release: 7.3
Fix ID: sym-7.3-build601265-uc
Publication date: September 9, 2022
This interim fix implements the getState()
API to get connection status. This fix applies only to the multiple SSM feature
within IBM Spectrum Symphony.
Contents
1.
List of fixes
2.
Download location
3.
Products or 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: P104731
2.
Download location
Download interim fix 601265 from the
following location: https://www.ibm.com/support/fixcentral
3.
Products or components affected
Component
name, Platform, Fix ID:
SOAM/SDK, Linux 64-bit, Windows 64-bit, sym-7.3-build601265-uc
4.
Installation
Follow these instructions to
download and install this fix on hosts in your cluster.
a. Log on to a management host as the cluster administrator and disable all applications:
> egosh
user logon -u Admin -x Admin
> soamcontrol
app disable all
b. On each management host and compute host, download the sym-7.3.0.0-soamcore-7.3.0.0_build601265.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.0.0-soamcore-7.3.0.0_build601265.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.0.0-soamcore-7.3.0.0_build601265.msp.
o install.log is the log file for the upgrade.
c. Use the pversions command to verify the installation:
> pversions
d. Log on to the primary host as the cluster administrator and enable the applications:
> soamcontrol app enable application_name
a. Log on to the IBM Spectrum Symphony Developer Edition host, disable all applications then stop the agent:
> soamcontrol
app disable all
> echo .| soamshutdown
b. On each IBM Spectrum Symphony Developer Edition host, download the symde-7.3.0.0_build601265.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:\symde-7.3.0.0_build601265.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:\symde-7.3.0.0_build601265.msp.
o install.log is the log file for the upgrade.
c. Log on to the IBM Spectrum Symphony Developer Edition host, start the agent and enable the applications:
> echo .|
soamstartup
> soamcontrol app enable application_name
a. Log on to the IBM Spectrum Symphony client host and stop the running client.
b. On each IBM Spectrum Symphony client host, download the symclnt-7.3.0.0_build601265.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:\symclnt-7.3.0.0_build601265.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:\symclnt-7.3.0.0_build601265.msp.
o install.log is the log file
for the upgrade.
a. Log on to a management host as the cluster administrator and disable all applications:
> egosh user logon -u Admin -x Admin
> soamcontrol app disable all
b.
Download the
package to each of your management and compute host, for example, to a
/symfixes
directory.
c.
Run the
egoinstallfixes
command to install the sym-7.3.0.0_x86_64_build601265.tar.gz file:
> egoinstallfixes /symfixes/sym-7.3.0.0_x86_64_build601265.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.
d. Use the pversions command to verify the installation:
> pversions -b 601265
e. Log on to the primary host as the cluster administrator and enable the applications:
> soamcontrol app enable
application_name
a. Log on to the IBM Spectrum Symphony Developer Edition host, disable all applications and stop the agent:
> soamcontrol
app disable all
> soamshutdown
b. Back up the following files:
$SOAM_HOME/7.3/linux-x86_64/lib64/libsoambase.so
$SOAM_HOME/7.3/linux-x86_64/lib/libsoambase.so
c. On each IBM Spectrum Symphony Developer Edition host, download the symde-7.3.0.0_x86_64_build601265.tar.gz package and extract its content to the $SOAM_HOME installation directory:
> tar zxfo
symde-7.3.0.0_x86_64_build601265.tar.gz -C $SOAM_HOME
d. Log on to the IBM Spectrum Symphony Developer Edition host, start the agent and enable the applications:
> soamstartup
&
> soamcontrol
app enable application_name
a. Log on to the IBM Spectrum Symphony client host and stop the running client.
b. Back up the following files:
$SOAM_HOME/lib64/libsoambase.so
$SOAM_HOME/lib/libsoambase.so
c. On each IBM Spectrum Symphony client host, copy the symclnt-7.3.0.0_x86_64-build601265.tar.gz package and extract its content to the $SOAM_HOME installation directory:
> tar zxfo
symclnt-7.3.0.0_x86_64-build601265.tar.gz -C $SOAM_HOME
a. Log on to the IBM Spectrum Symphony management as the cluster administrator and disable all applications:
> egosh user logon -u Admin -x Admin
> soamcontrol
app disable all
b. On each management host and compute 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.0 (build “601265”) and click Uninstall.
o To roll back from the IBM Spectrum Symphony command prompt, enter the following command:
C:\> msiexec /uninstall {C1A758D0-D526-472D-8D29-AC9C7BB2932F} /package {5B7B0C11-4DDB-4C5F-96A2-D1DCF66DBB64} /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,
{C1A758D0-D526-472D-8D29-AC9C7BB2932F}.
o product_code is the identifier of the .msi file for the original product installation package, in this case, {5B7B0C11-4DDB-4C5F-96A2-D1DCF66DBB64}.
o rollback.log is
the name of the log file to capture details of the rollback.
c. Log on to the primary host as the cluster administrator and enable the applications:
> soamcontrol app enable application_name
a. Log on to the IBM Spectrum Symphony Developer Edition host, disable all applications and stop the agent:
> soamcontrol
app disable all
> echo .| soamshutdown
b. On each IBM Spectrum Symphony Developer Edition 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.0 (build “601265”) and click Uninstall.
o To roll back from the IBM Spectrum Symphony command prompt, enter the following command:
C:\> msiexec /uninstall {E777861A-7A78-4B02-B817-45D3EC566DAC} /package {22654A06-21CF-422C-B5E1-387C1EDC788E} /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, {E777861A-7A78-4B02-B817-45D3EC566DAC}.
o product_code is the identifier of the .msi file for the original product installation package, in this case, {22654A06-21CF-422C-B5E1-387C1EDC788E}.
o rollback.log is
the name of the log file to capture details of the rollback.
c. Log on to the IBM Spectrum Symphony Developer Edition host, start the agent and enable the applications:
> echo .|
soamstartup
> soamcontrol
app enable application_name
a. Log on to the IBM Spectrum Symphony client host and stop the running client.
b. On each IBM Spectrum Symphony client 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.0 (build “601265”) and click Uninstall.
o To roll back from the IBM Spectrum Symphony command prompt, enter the following command:
C:\> msiexec /uninstall {02598BE9-C988-4471-8F91-12C0AF8AF2C8} /package {D0374E2E-2D3C-4240-9642-D99621AD5463} /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,
{02598BE9-C988-4471-8F91-12C0AF8AF2C8}.
o product_code is the identifier of the .msi file for the original product installation package, in this case, {D0374E2E-2D3C-4240-9642-D99621AD5463}.
o rollback.log is the name of the log file to capture details of the rollback.
a. Log on to the IBM Spectrum Symphony management as the cluster administrator and disable all applications:
> egosh user logon -u Admin -x Admin
> soamcontrol
app disable all
b. On each management host and compute host, uninstall the fix:
> egoinstallfixes
-r 601265
c. Log on to the primary host as the cluster administrator and enable the applications:
> soamcontrol
app enable application_name
a. Log on to the IBM Spectrum Symphony Developer Edition host, disable all applications and stop the agent:
> soamcontrol
app disable all
> soamshutdown
c. Restore the backed-up files:
$SOAM_HOME/7.3/linux-x86_64/lib64/libsoambase.so
$SOAM_HOME/7.3/linux-x86_64/lib/libsoambase.so
d. Log on to the IBM Spectrum Symphony Developer Edition host, start the agent and enable all applications:
> soamstartup
&
> soamcontrol
app enable application_name
a. Log on to the IBM Spectrum Symphony client host and stop the running client.
b. Restore the backed-up files:
$SOAM_HOME/lib64/libsoambase.so
$SOAM_HOME/lib/libsoambase.so
sym-7.3.0.0-soamcore-7.3.0.0_build601265.msp
c0d0beed68673ae090817284328f2029
soam/7.3/w2k3_x64-vc7-psdk/lib64/soambase.dll 5abe371bfce96980365a4a622cc46399
soam/7.3/w2k3_x64-vc7-psdk/lib64/soambase.pdb 7e4249fddb77b30c3e01df2caa1dafd4
soam/7.3/w2k3_x64-vc7-psdk/lib/soambase.dll 63f8199eac2420249debfef8c437060e
soam/7.3/w2k3_x64-vc7-psdk/lib/soambase.pdb 4fa931b326103c710dc5966105c82af6
symde-7.3.0.0_build601265.msp
075379dafe2159787c17a1e46cf17536
7.3/w2k3_x64-vc7-psdk/lib64/soambase.dll
5abe371bfce96980365a4a622cc46399
7.3/w2k3_x64-vc7-psdk/lib64/soambase.pdb
7e4249fddb77b30c3e01df2caa1dafd4
7.3/w2k3_x64-vc7-psdk/lib/soambase.dll
63f8199eac2420249debfef8c437060e
7.3/w2k3_x64-vc7-psdk/lib/soambase.pdb
4fa931b326103c710dc5966105c82af6
symclnt-7.3.0.0_build601265.msp
3fa385c188aa9d42a58988f0d2553c8c
lib64/soambase.dll
5abe371bfce96980365a4a622cc46399
lib64/soambase.pdb
7e4249fddb77b30c3e01df2caa1dafd4
lib/soambase.dll
63f8199eac2420249debfef8c437060e
lib/soambase.pdb
4fa931b326103c710dc5966105c82af6
sym-7.3.0.0_x86_64_build601265.tar.gz 2a499caf9e9145cf31ae81485868f747
soam/7.3/linux-x86_64/lib64/libsoambase.so
08c94304e4675360b31ccb76cbfae99e
soam/7.3/linux-x86_64/lib/libsoambase.so aeac4dafcddad5a0914e905fbe5be546
symde-7.3.0.0_x86_64_build601265.tar.gz
3a78886ad47e36e75ae03a099cc1eb2c
7.3/linux-x86_64/lib64/libsoambase.so
08c94304e4675360b31ccb76cbfae99e
7.3/linux-x86_64/lib/libsoambase.so aeac4dafcddad5a0914e905fbe5be546
symclnt-7.3.0.0_x86_64-build601265.tar.gz
6a8532e90eaf1856a8a7a4cba158f6df
lib64/libsoambase.so
08c94304e4675360b31ccb76cbfae99e
lib/libsoambase.so
aeac4dafcddad5a0914e905fbe5be546
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.
© 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.