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 IDOL Server.
In mirror mode you can use this action to remove a Content engine, 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 engine 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 engine. To do this, run the action and use the RemoveGroup
parameter to specify the ID of the Content engine or group to remove. The DIH does not index any more data into the specified engine, and its content is exported back to the DIH for redistribution. When redistribution is complete, the Content engine is removed from the DIH automatically, so you do not need to edit the configuration file.
Engine 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. |