Readme File for IBM® Spectrum Symphony RFE 151791
Readme File for: IBM Spectrum Symphony
Product Release: 7.3
Fix ID: sym-7.3-build600707-cs
Publication Date: October 15, 2021
Enhancement to allow the CPU limit to be specified in hyper-threads, instead of
cores, for IBM Spectrum Symphony 7.3 on Windows.
Contents
1. List of fixes
2. Installation and configuration
3. Uninstallation
4. List of files
5. Product notifications
6. Copyright and trademark information
Before you install this enhancement to your cluster, note the following requirements:
|
Operating system |
Windows 64-bit operating systems |
|
Product version |
IBM Spectrum Symphony 7.3 |
2. Installation and configuration
Follow the instructions in this section to download and install this interim fix to your cluster.
System requirements
Windows x86_64
Installation
a. Log on to the primary host as the cluster administrator and disable all applications:
> egosh user logon -u Admin -x Admin
> soamcontrol app disable all
b. Log on to management host and each compute host in the cluster, copy the sym-7.3.0.0-soamcore-7.3.0.0_build600707.msp package, and complete one of the following steps:
· For an interactive installation, double-click the sym-7.3.0.0-soamcore-7.3.0.0_build600707.msp package 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_build600707.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 upgrade.
c. Run the pversions command to verify the installation:
> pversions
IBM Spectrum Computing family:
SOAM core 7.3 for IBM Spectrum Symphony 7.3.0.0
Update for Symphony 7.3.0
(build"600707")
IBM Spectrum Computing family: EGO
core 3.8.0.0
IBM Spectrum Computing family: IBM
JRE 8.0.5.37
IBM Spectrum Computing family: IBM
WebSphere Application Server Liberty Profile 19.0.0.6
IBM Spectrum Computing family: EGO
management 3.8.0.0
IBM Spectrum Computing family:
SOAM management 7.3 for IBM Spectrum Symphony 7.3.0.0
IBM Spectrum Computing family: EGO
RESTful API Server 3.8.0.0
Copyright IBM Corp. 1992, 2016.
All rights reserved.
US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
d. Enable applications:
> soamcontrol app
enable application_name
Configuration
After applying this enhancement, enable it.
a.
Set the
following environment variable for the session manager in the application
profile:
<SSM resReq=""
shutDownTimeout="300" startUpTimeout="60"
workDir="${EGO_SHARED_TOP}/soam/work">
<osTypes>
<osType name="all">
<env
name="SOAM_ENABLE_HYPERTHREAD_CPU_LIMIT">true</env>
</osType>
</osTypes>
b.
Configure the CPU limit,
in hyper-threads, in the service/osTypes/osType section:
<resourceUsage>
<cpu cpuLimit="4"/>
</resourceUsage>
c.
Register
the updated application profile:
> soamreg application_profile.xml
Once enabled, the following ssm.log message will be logged at INFO level:
SOAM_ENABLE_HYPERTHREAD_CPU_LIMIT is enabled. The CPU fencing limit must be
defined in CPU threads.
3. Uninstallation
If required, follow the instructions in this section to uninstall this enhancement from your cluster.
a. Log on to the primary host as the cluster administrator and disable all applications:
> egosh user logon -u Admin -x Admin
> soamcontrol app disable all
b. Log on to each compute 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 “600707”) and click Uninstall.
· To roll back from the IBM Spectrum Symphony command prompt, enter the following command:
C:\>msiexec /uninstall {E10EEC7D-CD4D-4C0A-8A24-344707A8C737} /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:
o interim_fix_code is the identifier of the .msp package
for the interim fix; in this case, {E10EEC7D-CD4D-4C0A-8A24-344707A8C737}.
o product_code is the identifier of the .msi file in 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 interim fix rollback; in this case, sym_rollback.log.
c. Enable applications:
> soamcontrol app enable application_name
4. List of files
sym-7.3.0.0-soamcore-7.3.0.0_build600707.msp 1803135111eae9a818c292a6d7df7158
soam\7.3\w2k3_x64-vc7-psdk\etc\sim.exe b8734bf9d148fab1b9d454a554f2d045
soam\7.3\w2k3_x64-vc7-psdk\etc\sim.pdb 9f6b23380c5efa623362f83f2e827e99
soam\7.3\w2k3_x64-vc7-psdk\etc\ssm.exe 34736e087f89ffc19a5aa1a8e2e49cb5
soam\7.3\w2k3_x64-vc7-psdk\etc\ssm.pdb 38257032898d100e8be32ec072854d5b
5. 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.
6. Copyright and trademark information
© Copyright IBM Corporation 2021
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.