IT48664: ACE VERIFY ALL CAN FAIL BECAUSE OF OUTOFMEMORY

APAR status

• Closed as documentation error.

Error description

• ACE VERIFY ALL CAN FAIL BECAUSE OF OUTOFMEMORY with below java
  stack
  BIP15045I: Verifying checksums of files in installation, this
  may take a few minutes ... JVMDUMP055I Processing dump event
  "systhrow", detail "java/lang/OutOfMemoryError", exception "Java
  heap space" at 2025/09/22 07:59:54 - please wait. JVMDUMP032I
  JVM requested System dump using
  '/opt/ace-13.0.4.2/core.20250922.075954.20709762.0001.dmp' in
  response to an event Note: "Enable full CORE dump" in smit is
  set to FALSE and as a result there will be limited threading
  information in core file. JVMDUMP010I System dump written to
  /opt/ace-13.0.4.2/core.20250922.075954.20709762.0001.dmp
  JVMDUMP032I JVM requested Heap dump using
  '/opt/ace-13.0.4.2/heapdump.20250922.075954.20709762.0002.phd'
  in response to an event JVMDUMP010I Heap dump written to
  /opt/ace-13.0.4.2/heapdump.20250922.075954.20709762.0002.phd
  JVMDUMP032I JVM requested Java dump using
  '/opt/ace-13.0.4.2/javacore.20250922.075954.20709762.0003.txt'
  in response to an event JVMDUMP010I Java dump written to
  /opt/ace-13.0.4.2/javacore.20250922.075954.20709762.0003.txt
  JVMDUMP032I JVM requested Snap dump using
  '/opt/ace-13.0.4.2/Snap.20250922.075954.20709762.0004.trc' in
  response to an event JVMDUMP010I Snap dump written to
  /opt/ace-13.0.4.2/Snap.20250922.075954.20709762.0004.trc
  JVMDUMP013I Processed dump event "systhrow", detail
  "java/lang/OutOfMemoryError". Failed to verify installation is
  not corrupt: Exception while computing a file hash BIP15200E:
  The command ace verify install failed.
  

Local fix

• set env variable IBM_JAVA_OPTIONS
  on UNIX export
  IBM_JAVA_OPTIONS=-Xmx2048m
  on Windows set
  IBM_JAVA_OPTIONS=-Xmx2048m
  
  or set ulimit -u to unlimited before
  running the command
  

Problem summary

• ****************************************************************
  USERS AFFECTED:
  All users of App Connect Enterprise V13 using ace verify all
  command
  
  
  Platforms affected:
  AIX, WinX64, LinuxX64, LinuxZ64, LinuxPPCLE64
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  'ace verify all' command may fail with Java OutOfMemory error if
  ulimit -u option is not set to a sufficiently high value.
  

Problem conclusion

• Set 'ulimit -u' to 'unlimited' before running the
  command.
  
  Following product documentation topic has been updated
  to provide guidance on configuring ulimit values to resolve the
  OOM issue while running 'ace verify all'
  command.
  https://www.ibm.com/docs/en/app-connect/13.0.x?topic=dp
  -resolving-problems-when-you-install-app-connect-enterprise
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

Applicable component levels