The Entry Counter Placement Algorithm is a placement algorithm that selects the backend set with the minimum number of entries or the smallest database size in order to achieve equal distribution as much as possible.
↓Parent Component
↓Properties
↓dsconfig Usage
The Entry Counter Placement Algorithm component inherits from the Placement Algorithm
The properties supported by this managed object are as follows:
| Basic Properties: | Advanced Properties: |
|---|---|
| ↓ description | ↓ prefer-lowest-value |
| ↓ enabled | ↓ monitored-entry |
| ↓ placement-criteria | ↓ monitored-attribute |
| ↓ poll-interval |
| Description | A description for this Placement Algorithm |
| Default Value | None |
| Allowed Values | A string |
| Multi-Valued | No |
| Required | No |
| Admin Action Required | None. Modification requires no further action |
| Description | Indicates whether this placement algorithm is enabled for use in the server. |
| Default Value | None |
| Allowed Values | true false |
| Multi-Valued | No |
| Required | Yes |
| Admin Action Required | None. Modification requires no further action |
| Description | The criteria for selecting the appropriate backend set. These pre-defined criterias are only applicable to the UnboundID Directory Server instances. If the backend sets are not UnboundID Directory Server instances, then the value should be set to custom, and the monitor-entry and monitor-attribute properties should be specified. |
| Default Value | entry-count |
| Allowed Values | backend-size - Indicates that the smallest backend in size will be preferred by the algorithm. entry-count - Indicates that the backend with the least number of entries will be preferred by the algorithm. custom - Indicates that a backend set will be selected based on the value of an attribute specified by the monitor-entry and monitor-attribute properties. |
| Multi-Valued | No |
| Required | No |
| Admin Action Required | None. Modification requires no further action |
| Description | The placement algorithm will poll each backend set once every polling interval to update the information about the backend sets. Between polls, the algorithm keeps track where entries are placed and routes the request accordingly. |
| Default Value | 1m |
| Allowed Values | A duration. Lower limit is 0 seconds. |
| Multi-Valued | No |
| Required | No |
| Admin Action Required | None. Modification requires no further action |
prefer-lowest-value (Advanced Property)
| Description | If true, the backend set that returns the lowest value will become the candidate for placing the next entry. Otherwise, the backend set with the highest value will be selected. |
| Default Value | true |
| Allowed Values | true false |
| Multi-Valued | No |
| Required | No |
| Admin Action Required | None. Modification requires no further action |
monitored-entry (Advanced Property)
| Description | If defined, the placement algorithm will monitor this entry from each backend set. |
| Default Value | None |
| Allowed Values | A valid DN. |
| Multi-Valued | No |
| Required | No |
| Admin Action Required | None. Modification requires no further action |
monitored-attribute (Advanced Property)
| Description | If defined, the placement algorithm will monitor this attribute from the monitored entry from each backend set. The attribute must have numerical value. |
| Default Value | None |
| Allowed Values | A string |
| Multi-Valued | No |
| Required | No |
| Admin Action Required | None. Modification requires no further action |
To list the configured Placement Algorithms:
dsconfig list-placement-algorithms
[--property {propertyName}] ...
To view the configuration for an existing Placement Algorithm:
dsconfig get-placement-algorithm-prop
--algorithm-name {name}
--processor-name {name}
[--tab-delimited]
[--script-friendly]
[--property {propertyName}] ...
To update the configuration for an existing Placement Algorithm:
dsconfig set-placement-algorithm-prop
--algorithm-name {name}
--processor-name {name}
(--set|--add|--remove) {propertyName}:{propertyValue}
[(--set|--add|--remove) {propertyName}:{propertyValue}] ...
To create a new Entry Counter Placement Algorithm:
dsconfig create-placement-algorithm
--algorithm-name {name}
--processor-name {name}
--type entry-counter
--set enabled:{propertyValue}
[--set {propertyName}:{propertyValue}] ...
To delete an existing Placement Algorithm:
dsconfig delete-placement-algorithm
--algorithm-name {name}
--processor-name {name}