Node memory utilization exceeds the configured throttle memory utilization threshold

Node memory utilization exceeds the configured throttle memory utilization threshold

book

Article ID: KB0070826

calendar_today

Updated On:

Products Versions
TIBCO Streaming All versions

Description

ERROR:
===
Unable to load configuration "configuration_path" because node memory utilization (percent_value) exceeds the configured throttle memory utilization threshold.
===

The error is associated with the configuration of the node's Shared Memory. The default configuration values are set as follows: 'memorySizeBytes' is configured at 512MB, and 'thresholdPercentage' is set to 50. The error message suggests that during certain startup events, there is a momentary utilization of more than 50% of the allocated 512MB. In essence, the system experiences a brief spike in memory usage that triggers this error condition.

Issue/Introduction

Steps to resolve the ERROR: Unable to load configuration because node memory utilization exceeds the configured throttle memory utilization threshold.

Environment

Windows and Linux environments

Resolution

To resolve this error, you can specify a higher Shared Memory value in megabytes. As an example, you can use the following command:
 
epadmin install node --nodename=A.X --application=app.zip --memorysize=1024


Additionally, these values can be adjusted in the ApplicationDefinition HOCON and referenced per node using the NodeDeploy HOCON. Detailed documentation on this can be found in the following sections:
- TIBCO Streaming > Configuration Guide > Runtime Configuration Types 
  > Runtime Application Configuration
  > Runtime Node Configuration

The configuration process involves creating a named nodeTypes definition and then referencing it for a specific node in the node's nodeType declaration.

Additional Information

https://docs.tibco.com/pub/str/11.0.0/doc/html/hocon/hocon-dtm-application.html
https://docs.tibco.com/pub/str/11.0.0/doc/html/hocon/hocon-dtm-nodedeploy.html