IT46223: MEMORY LEAK FOR NODE OWNED INTEGRATION SERVERS WITH FLOW STATS, RESOURCE STATS, OR ADMIN LOG ENABLED ON 12.0.12.0 OR ABOVE

APAR status

• Closed as program error.

Error description

• A node-owned integration server will leak native memory every
  time a flow statistics message, resource statistics message, or
  admin log notification message is publish.
  

Local fix

• For node-owned integration servers, we recommend  disabling flow
  statistics, resource statistics, administration logging. This
  can be achieved using the following changes to the
  `server.conf.yaml` file:
  
  Statistics:
    Snapshot:
      publicationOn: 'inactive'
    Archive:
      archivalOn: 'inactive'
    Resource:
      reportingOn: false
  Events:
    OperationalEvents:
      MQ:
        enabled: false
      MQTT:
        enabled: false
    AdminEvents: # Administration events - AdminLog
      MQ:
        enabled: false
      MQTT:
        enabled: false
  AdminLog:
    enabled: false
  
  
  For independent integration servers that are either unoptimised,
  or are optimised but still have Node.js enabled for other
  features, we recommend that that either the same changes as
  given above for node-owned integration servers are made, or that
  the `RestAdminListener.port` property is changed to a non-zero
  value enabling the administrative API/web user interface.
  

Problem summary

• ****************************************************************
  USERS AFFECTED:
  All users of IBM App Connect Enterprise 12.0.12.0 or above and
  11.0.0.25 - 11.0.0.26
  
  
  Platforms affected:
  MultiPlatform
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  IBM App Connect Enterprise 12.0.12.0 introduced internal changes
  to allow IBM's proprietary JavaScript modules used by ACE to be
  migrated to ECMAScript modules, so that we may continue to
  provide security updates in a timely manner.
  
  As part of these changes, an internal JavaScript module that
  implements part of the administrative REST API no longer gets
  loaded in cases where it is not needed. Specifically these cases
  are:
  
  * Node-owned integration servers, i.e. `DataFlowEngine`
  processes
  * Independent integration servers, i.e. `IntegrationServer`
  processes, where the `RestAdminListener.port` property is zero,
  but Node.js has not been disabled due to server optimisation.
  
  To enable flow statistics, resource statistics, and
  administration log messages to appear in the web user interface,
  a JSON message is passed through to this internal JavaScript
  module. This JSON message is backed by unmanaged native memory,
  not memory owned by the JavaScript garbage collector. The
  internal JavaScript module is responsible for freeing this
  unmanaged memory when it has finished with it.
  
  In ACE 12.0.12.0 or later under the scenarios described above,
  this JSON message is still generated but the JavaScript module
  responsible for freeing it is no longer loaded. This causes
  memory to be leaked with every publication of flow statistics,
  resource statistics, and admin log events.
  

Problem conclusion

• <div><div>The JSON message that was previously being leaked will
  no longer be generated if the corresponding internal JavaScript
  module is not loaded
  
  Go to the APAR entry in ACE v12 Release Notes
  https://www.ibm.com/support/pages/node/6457259 to download
  available fixes for v12.0.
  
  Go the the APAR entry in ACE v11 Release Notes
  https://www.ibm.com/support/pages/node/619045 to download
  available fixes for v11.0.
  
  A tech note has been published,
  https://www.ibm.com/support/pages/node/7155286, detailing a
  related increase in baseline VSZ usage for ACE 12.0.11.0 and
  above
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  Version Maintenance Level v12.0 12.0.12.3</div></div>
  

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

• Fixed component name

  APP CONNECT ENT

• Fixed component ID

  5724J0560

Applicable component levels