Show TOC

Configuring the Memory ThresholdLocate this document in the navigation structure

Prerequisites

The disasterbrakes property of Galaxy Core Service must be set to true so that you can configure the memory threshold.

To set the property to true, in SAP NetWeaver Administrator navigate to Start of the navigation path Configuration Next navigation step Infrastructure Next navigation step Java System Properties End of the navigation path, open the Services tab and select the Galaxy Core Service.

Context

It is possible that some business process models have errors and can therefore cause server crashes due to out-of-memory problems. The reasons for this can be endless loops, endless recursive invocations of subprocesses, or the creation of large numbers of tokens for parallel splits. Restarting the engine will not help you to get the BPM engine running again. To prevent the BPM system from such disaster situations, configure the threshold values for the number of process instances and tokens that the system can create. You can perform the configuration either for the entire BPM system or for specific process definitions.

The memory threshold mechanism works completely separately on every server node in the cluster. Configured threshold values are monitored and reported only for processes loaded in the memory of the server node you are connected to.

You can configure two types of thresholds: Warning and error thresholds. Process instances that exceed the error threshold are suspended and further instantiations are denied. These actions are logged in the Business Log and the AS Java Log.

Procedure

  1. Click View / Configure .

    The system displays:

    • Number of process instances currently running on the server

    • Number of process instances that are in error state as a result of their number of tokens exceeding the error threshold

  2. To configure the threshold values, choose the Configuration tab page and proceed as follows:

    1. To configure the threshold values for process definitions:

      1. In the Number of process instances per definition field, enter the number of process instances that must be running for each process definition.

      2. In the Number of token per process instance field, enter the number of tokens that must be running for each process instance.

      3. If you want to specify threshold values specific to a process definition:

        1. Choose Add .

        2. Select the required process definition.

        3. Choose Select

        4. Enter the threshold values for process instances and tokens.

        5. Save the changes.

    2. To configure the threshold values at the BPM system level:

      1. Choose Edit .

      2. Enter the required values in the Total number of process instances field.

      3. Save the changes.