Distributed Index Handler 25.4
Distributed Index Handler Help

# DREREDISTRIBUTE

Allows you to redistribute the index when you update the number or weight of child servers.

NOTE: This index action is only available for the DIH, and has no effect if you send it directly to the Content component.

In mirror mode you can use this action to remove a Content component, but redistribution does not occur because the engines contain the same documents.

In simple distribution mode, either with or without `DistributeSendMinimal`, you can remove a child Content component or group and the DIH will automatically redistribute its documents among the remaining servers. You might want to do this if your index has reduced in size and you want to decommission a Content component. To do this, run the action and use the `RemoveGroup` parameter to specify the ID of the Content component or group to remove. The DIH does not index any more data into the specified component, and its content is exported back to the DIH for redistribution. When redistribution is complete, the Content component is removed from the DIH automatically, so you do not need to edit the configuration file.

Component removal with redistribution of content is not available with distribute by reference, distribute by batch, distribute by date, or distribution by field values.

In consistent hashing mode, all content is distributed in virtual nodes, which the DIH assigns to one or more child servers. When you run the `DREREDISTRIBUTE` index action, DIH checks whether the child server architecture has changed. If there is a change, DIH automatically exports and indexes the content in virtual nodes to redistribute your data evenly between the available child servers.

When you have configured at least one document replica in your system, you can also use `DREREDISTRIBUTE` to rebuild a child server that has become unavailable (for example because of a hardware failure). In this case, you can use the EngineManagement action to change the host and port of the child server, and then you can use `DREREDISTRIBUTE` with the RebuildEngine parameter to rebuild the child server from replicas.

For more details about consistent hashing mode, refer to the DIH Administration Guide.

DIH can process only one `DREREDISTRIBUTE` index action at the same time. If it starts to process a second `DREREDISTRIBUTE` index action before all child servers have finished redistributing the content, the second `DREREDISTRIBUTE` returns the `Unavailable` error code and does not run.

NOTE: For this index action, DIH uses the IndexUID parameter to identify the export index actions that it sends to its child servers, and the index actions to generate to index the redistributed data. If you do not specify an IndexUID, DIH generates one automatically to track the redistribution.

## Example

    http://12.3.4.56:9071/DREREDISTRIBUTE

## Optional Parameters

This action accepts the following optional parameters.

Parameter | Description
--- | ---
DAHGSSServiceName | The GSSAPI service name of your DAH.
DAHHost | The host name or IP address of your DAH.
DAHPort | The ACI port of your DAH.
DAHSSLSectionName | The name of a section in the DIH configuration file that contains the SSL settings required to communicate with your DAH.
RebuildEngine | The IDs of child servers that you want to rebuild from replicas.
RemoveGroup | The ID of the child Content engine or group to remove.

This index action accepts the following standard index action parameters.

Parameter | Description
--- | ---
IgnoreMaxPendingItems | Whether to ignore the IndexQueueMaxPendingItems limit for this index action.
IndexUID | An identification code for any document tracking events.
NoArchive | Turn off configured archiving for the index action.
Priority | The priority for the index job.

Copyright 2025 Open Text
Version 25.4 | Last updated October 2025

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 25.4

Topic Title: DREREDISTRIBUTE