Distributed Index Handler 26.2
Distributed Index Handler Help

# DistributeByFields

Set `DistributeByFields` to `True` to index data based on the value of a specified field in the documents being indexed or in which the field is replaced.

This option is similar to reference-based indexing, except that you configure the fields to extract from the document to determine which child server to send the document to. This option applies to DREADD, DREADDDATA and DREREPLACE index actions. You configure the field to use with the DistributeByFieldsCSVs configuration parameter.

If enabled, the DIH is restricted so that you cannot alter the number of child servers.

When `DistributeByFields` is set to `True`, DIH consistently distributes documents according to the field. If a child server goes down, it queues the documents for that child server, and indexes them when the server becomes available. Unlike simple non-mirror mode, it does not redistribute the documents to available servers.

NOTE: You can use this distribution mode only when MirrorMode is set to `False`. DIH will not start if you attempt to configure this distribution mode when MirrorMode is set to `True`.

Type: | Boolean
Default: | False
Required: | No
Configuration Section: | Server
Example: | `DistributeByFields=True`
See Also: | BalanceDistributeByFields DistributeByFieldsCSVs DistributeByFieldsValues MirrorMode

Copyright 2026 Open Text
Version 26.2 | Last updated April 2026

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to MFI-swpdl.idoldocsfeedback@opentext.com.

We appreciate your feedback!

Product: Knowledge Discovery Distributed Index Handler 26.2

Topic Title: DistributeByFields