Readme File for IBM® Spectrum Symphony 7.2.0.2 Interim Fix 600227
Readme File for: IBM Spectrum Symphony
Product Release: 7.2.0.2
Update Name: Interim Fix 600227
Fix ID: sym-7.2.0.2-build600227-ms
Publication Date: February 26, 2021
This interim fix adds instrumentation logs for non-exclusive reclaims triggered by exclusive hosts.
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:
P104099
2. Download location
Download interim fix 600227 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, sym-7.2.0.2-build600227-ms
4. Installation and configuration
Follow the instructions in this section to download and install this interim fix to your cluster.
System requirements
Linux x86_64
Installation
a. Log on to the primary host in the cluster as the cluster administrator and disable the applications:
> egosh user logon -u Admin -x Admin
> soamcontrol app disable all
b. For recovery purposes, log on to each management host in your cluster as the cluster administrator and back up the following file:
$EGO_TOP/soam/7.2/linux-x86_64/etc/ssm
c. Download the sym-7.2.0.2_x86_64_build600227.tar.gz package and install the interim fix:
>
tar zxfo sym-7.2.0.2_x86_64_build600227.tar.gz -C
$EGO_TOP/
d. Update
the configurations based on the “Configuration and usage” section.
Configuration and usage
a. Configure
the application profile for the SSM that needs to monitor, and register it by adding the SYM_INSTRUMENT_TS004766208 environment
variable to the application profile:
<SOAM
version="7.2">
<SSM ......>
<osTypes>
<osType
name="all" startCmd="${SOAM_HOME}/${VERSION_NUM}/${EGO_MACHINE_TYPE}/etc/ssm"
workDir="${EGO_CONFDIR}/../../soam/work">
<env
name="SOAM_HOME">${EGO_TOP}/soam</env>
<env
name="PATH">${SOAM_HOME}/${VERSION_NUM}/${EGO_MACHINE_TYPE}/lib:${SOAM_HOME}/${VERSION_NUM}/${EGO_MACHINE_TYPE}/etc:${SOAM_HOME}/${VERSION_NUM}/${EGO_MACHINE_TYPE}/bin:/bin:/usr/bin:/local/share/bin</env>
<env
name="LD_LIBRARY_PATH">${SOAM_HOME}/${VERSION_NUM}/${EGO_MACHINE_TYPE}/lib64</env>
<env name="SYM_INSTRUMENT_TS004766208">TRUE</env>
</osType>
</osTypes>
......
</SSM>
With
this environment variable configured, INFO level messages as the following will
be logged in SSM’s log:
2021-01-09
10:47:10.221 GMT INFO [4087:139680633440000] servers.common.resmngr.VEMResManagerBase
- env SYM_INSTRUMENT_TS004766208 is enabled.
With
this environment variable, if a non-exclusive reclaim happens on this SSM, INFO
level messages such as the following, will be logged in SSM’s log:
2021-01-09
10:57:12.557 GMT INFO [32324:140303059105536] servers.common.resmngr.VEMResManagerBase
- target host <testhost>
is not exclusive in record.
2021-01-09
10:57:12.557 GMT INFO [32324:140303059105536] servers.common.resmngr.VrmCompositeResource
- Enter VrmCompositeResource::dump
2021-01-09
10:57:12.557 GMT INFO [32324:140303059105536] servers.common.resmngr.VrmCompositeResource
- VrmCompositeResource name = <testhost>
resourceGroup <ComputeHosts>
osType = <X86_64> consumerId
= </SymTesting/Symping72> allocationId
= <17> cpuFactor = <23.1> exclusiveReleaseFlag = <0> exclusive = <0> hostOk = <1>
2021-01-09
10:57:12.557 GMT INFO [32324:140303059105536] servers.common.resmngr.VrmCompositeResource
- Exit VrmCompositeResource::dump
Upon
running the soamlog ssm.dump application_name -l
LOG_INFO command, for hosts that assigned this SSM, the information will
be logged in SSM’s log, as follows:
2021-01-09
09:18:46.158 GMT INFO [11846:139763434391296] servers.common.resmngr.VrmCompositeResource
- Enter VrmCompositeResource::dump
2021-01-09
09:18:46.158 GMT INFO [11846:139763434391296] servers.common.resmngr.VrmCompositeResource
- VrmCompositeResource name = <testhost>
resourceGroup <ComputeHosts>
osType = <X86_64> consumerId
= </SymTesting/Symping72> allocationId
= <11> cpuFactor = <23.1> exclusiveReleaseFlag = <0> exclusive = <1> hostOk = <1>
2021-01-09
09:18:46.158 GMT INFO [11846:139763434391296] servers.common.resmngr.VrmCompositeResource
- Exit VrmCompositeResource::dump
If
the SYM_INSTRUMENT_TS004766208
environment variable is not configured; the new logic will not work.
b. After completing the configuration settings, from the primary host, enable the applications:
> soamcontrol app enable app_name
5. Uninstallation
If required, follow the instructions in this section to uninstall this interim fix from your cluster.
a. Log on to the primary host in the cluster as the cluster administrator and disable the applications:
> egosh user logon -u Admin -x Admin
> soamcontrol app disable all
b. Log on to each management host in your cluster as the cluster administrator and restore your backup for the following file:
$EGO_TOP/soam/7.2/linux-x86_64/etc/ssm
c. Remove the SYM_INSTRUMENT_TS004766208 environment
variable set in the “Configuration and usage”
section.
d. From the primary host, enable the applications:
> soamcontrol app enable app_name
6. List of files
4fb6772979556cb1181a8c3b74c7eade soam/7.2/linux-x86_64/etc/ssm
7. Product notification
To receive information about product solution and patch updates automatically, subscribe to product notifications on the My Notifications page 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 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.