ds-maxheaplow

Specify soft and hard thresholds for heap memory use

Description

PROPERTY	VALUE
Entry DN	`cn=config,cn=ldbm database,cn=plugins,cn=config`
Valid Range	Range depends on the deployment. The value is checked against the run-time values.
Default Value	Not set by default.
Syntax	Integer

These attributes specify threshold values for dynamic memory footprint. When the memory threshold is reached, Directory Server attempts to free memory from the entry caches, and limit memory use.

When ds-maxheaplow is reached, Directory Server attempts to free memory concurrently with other operations.
When ds-maxheaphigh is reached, Directory Server prevents operations on the cache while memory is freed.

These attributes safeguard against sudden increases of memory footprint due to changes in allocation patterns. As such, the memory thresholds should be higher than the sum of all entry caches, plus the memory footprint at startup.

ds-maxheaphigh and ds-maxheaplow must be configured in conjunction with each other, as follows.

If ds-maxheaphigh is zero or is not set, ds-maxheaplow is ignored.
If ds-maxheaphigh is set, its value must be at least one gigabyte.
If ds-maxheaphigh is set, the value of ds-maxheaplow must be less than that of ds-maxheaphigh.
If ds-maxheaphigh is set to a value other than zero, ds-maxheaplow is automatically set by default to 7/8 of the value of ds-maxheaphigh.
If ds-maxheaphigh and ds-maxheaplow are both set to a value other than zero, ds-maxheaplow must be greater than or equal to (ds-maxheaphigh + minheap)/2, where minheap is the twice of the memory required during startup. If this condition is not met, ds-maxheaplow is automatically set by default to 7/8 of the value of ds-maxheaphigh.

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

Attributes

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWdsee7
Stability Level	Obsolete: Scheduled for removal after this release