Readme File for IBM® Platform Symphony 7.1.1 Interim Fix 600338
Readme File for: IBM Platform Symphony
Product Release: 7.1.1
Update Name: Interim Fix 600338
Fix ID: sym-7.1.1-build600338
Publication Date: April 13, 2021
With this interim fix you can call the Linux function malloc_trim(), and specify the interval (in seconds) for the call. This can help reduce Linux memory fragment issues.
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:
P104165
2. Download location
Download interim fix 600338 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.1.1-build600338
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 as the cluster administrator and disable all 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.1.1/linux-x86_64/etc/ssm
c. Download the pssasetup2015_linux-x86_64_build600338.tar.gz package and install the interim fix:
>
tar zxfo
pssasetup2015_linux-x86_64_build600338.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 SOAM_MALLOCTRIM_INTERVAL environment
variable to the application profile:
<SSM ……>
<osTypes>
<osType
name="X86_64" workDir="${EGO_CONFDIR}/../../soam/work">
<env
name="SOAM_HOME">${EGO_TOP}/soam</env>
<env
name="SOAM_MALLOCTRIM_INTERVAL">60</env>
……
</osType>
</osTypes>
......
</SSM>
Here are details
about the SOAM_MALLOCTRIM_INTERVAL parameter:
Description: Specifies
the interval (in seconds) to call the Linux function malloc_trim
using parameter 0. If its value is 0, malloc_trim
will not be called.
Where used: SOAM >
SSM > osTypes > osType
Required or
optional:
Optional
Valid values: 1 to
4294967295
With
this environment variable configured, 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] ARM::callMalloctrimPeriodically
The system will call the <malloc_trim> function
every 60 seconds.
If
the SOAM_MALLOCTRIM_INTERVAL 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 <appName>
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 as the cluster administrator and disable all 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.1.1/linux-x86_64/etc/ssm
c. Remove the SOAM_MALLOCTRIM_INTERVAL environment
variable set in the “Configuration and usage”
section.
d. From the primary host, enable the applications:
> soamcontrol app enable <appName>
6. List of files
7070601d489e3c039c0208bc00b00a3e soam/7.1.1/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.