heap-high-threshold-size

DS server instance configuration (SER) property heap-high-threshold-size

Description

The behavior of a Directory Server instance is configured according to server properties such as heap-high-threshold-size.

Characteristic	Value
Syntax	`MEMORY_SIZE \| undefined`
Default Value	`undefined`
Is readable	Yes
Is modifiable	Yes
Is multi-valued	No

In the preceding table, syntax values shown in lower case or partly in lower case are literal values. Those shown in upper case are syntax types, as described in server(5DSCONF).

This property specifies a threshold value for the dynamic memory footprint. When the threshold memory is reached, Directory Server attempts to free memory from the entry caches, and to limit memory use.

When heap-low-threshold-size is reached, Directory Server attempts to free memory concurrently with other operations.
When heap-high-threshold-size is reached, Directory Server prevents operations on the cache while memory is freed.

heap-high-threshold-size and heap-low-threshold-size must be configured in conjunction with each other, as follows.

If heap-high-threshold-size is set to undefined or is not set, heap-low-threshold-size is ignored.
If heap-high-threshold-size is set, its value must be at least one gigabyte.
If heap-high-threshold-size is set, the value of heap-low-threshold-size must be less than that of heap-high-threshold-size. If not, heap-low-threshold-size is automatically set by default to 7/8 of the value of heap-high-threshold-size.
If heap-high-threshold-size is set to a value other than undefined, heap-low-threshold-size is automatically set by default to 7/8 of the value of heap-high-threshold-size.
If heap-high-threshold-size and heap-low-threshold-size are both set to a value other than undefined, heap-low-threshold-size must be greater than or equal to (heap-high-threshold-size + minheap)/2, where minheap is the amount of heap memory used by the server at startup. If this condition is not met, heap-low-threshold-size is automatically set by default to 7/8 of the value of heap-high-threshold-size.

The number of times the memory thresholds have been exceeded can be monitored by using the heapmaxhighhits and heapmaxlowhits attributes on cn=monitor.

Attributes

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWdsee7
Stability Level	Evolving