IBM Support

OOMEHandler will not listen to the Heap memory - tenured-LOA memory pool because its maximum size is XX megabytes and the threshold requested is YY megabytes. The maximum allowed threshold is 10.0% of the heap's size (approximately ZZ megabytes).

Troubleshooting


Problem

The problem is that after applying5.2.1.7-P8CSS-IF007,  5.5.1.0-P8CSS-IF003 or 5.5.2.0-P8CSS-IF002, the Content Search Services (CSS) traceN.log reports the following message:
OOMEHandler will not listen to the Heap memory - tenured-LOA memory pool because its maximum size is XX megabytes and the threshold requested is YY megabytes. The maximum allowed threshold is 10.0% of the heap's size (approximately ZZ megabytes).

 

Cause

The patches in question also upgraded the Java version to Java 8.  There is a change to how memory pool statistics are reported in that release of Java.  A JVM argument is required to force the MemoryPoolMXBean memory reporting to show up as a single heap pool and prevent CSS erroneous memory threshold reporting.

Diagnosing The Problem

You will see the error message in the traceN.log file:
OOMEHandler will not listen to the Heap memory - tenured-LOA memory pool because its maximum size is XX megabytes and the threshold requested is YY megabytes. The maximum allowed threshold is 10.0% of the heap's size (approximately ZZ megabytes).
(where XX, YY and ZZ will vary based on your individual environmental settings)

Resolving The Problem

The solution to this particular error is to change the CSS startup.bat or .sh file as follows.  
startup.bat (Windows):
Insert the new JVM argument -XX:+HeapManagementMXBeanCompatibility in between the HEAP_SIZE and SHUTDOWN_ON_OOM portions of the Java call.  For example:
"%JAVA_HOME%\bin\java" -classpath "%CLASSPATH%" com.ibm.es.nuvo.launcher.Launcher "%CONFIG_DIR%" -Xmx%HEAP_SIZE% -XX:+HeapManagementMXBeanCompatibility %SHUTDOWN_ON_OOM% %1 %2 %3 %4 %5 %6 %7 %8 %9 %IPv6Flag%
startup.sh (AIX/Linux):
Insert the new JVM argument -XX:+HeapManagementMXBeanCompatibility in between the HEAP_SIZE and REST portions of the Java call. For example:
"$JAVA_HOME/bin/java" -classpath "$CLASSPATH" com.ibm.es.nuvo.launcher.Launcher "$CONFIG_PATH" $1 $2 $3 $4 $5 $6 $7 $8 $9 $BIT_FLAG -Xmx$HEAP_SIZE -XX:+HeapManagementMXBeanCompatibility -DREST=true "$SHUTDOWN_ON_OOM" $IPv6Flags
Optional:You may also elect to include the comments below explaining the change to preceed the call to Java:
Windows
REM The -XX:+HeapManagementMXBeanCompatibility JVM policy flag required to force MemoryPoolMXBean memory
REM reporting as a single heap pool and prevent erroneous memory threshold reporting (see defect 15928)
AIX/Linux
# The -XX:+HeapManagementMXBeanCompatibility JVM policy flag required to force MemoryPoolMXBean memory
# reporting as a single heap pool and prevent erroneous memory threshold reporting (see defect 15928)

Document Location

Worldwide

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSNVNV","label":"FileNet Content Manager"},"Component":"IBM FileNet Content Search Services","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"5.2.1.7-P8CSS-IF007;5.5.1.0-P8CSS-IF003;5.5.2.0-P8CSS-IF002","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Product Synonym

CSS;

Document Information

Modified date:
22 August 2019

UID

ibm11071678

Page Feedback