Distributed Index Handler 26.1
Distributed Index Handler Help

# EngineManagement

Allows you to dynamically edit the status of child servers (without restarting the Distributed Index Handler).

DIH updates the configuration file when you add, update, or remove a child server.

You must specify the action to perform by setting EngineAction. Depending on the value of EngineAction, you might need to set additional parameters:

- When you set EngineAction to `Edit`, you must also set ID.
- When you set EngineAction to `Remove`, you must set one of ID or Group.
- When you set EngineAction to `Add`,. you must also set Host and Port.

## Examples

    http://localhost:9070/action=EngineManagement&EngineAction=Edit&Id=1&Disabled=true

This action turns off the child server with ID `1`.

## Required Parameters

The following action parameters are required.

Parameter | Description
--- | ---
EngineAction | The action to take on the specified servers.

Depending on the value of EngineAction, you might need to set one or more of the following parameters.

Parameter | Description
--- | ---
Group | The group ID of the mirror group to perform the specified action on.
Host | The host of the child server.
ID | The servers to perform the specified action on.
Port | The port of the child server.

## Optional Parameters

This action accepts the following optional parameters.

Parameter | Description
--- | ---
Disabled | Marks the specified child server as online or offline.
GSSServiceName | The GSSAPI service name of the new child server.
Polling | Change whether DIH polls jobs for this child server.
ServiceSSLConfig | The SSL configuration to use for the service port of the new child server.
SSLConfig | The SSL configuration to use for the ACI port of the new child server.
UpdateOnly | Change the status of a server to UpdateOnly.
Weight | Change the weight of a child server.

This action accepts the following standard ACI action parameters.

Parameter | Description
--- | ---
ActionID | A string to use to identify an ACI action.
FileName | The file to write output to.
ForceTemplateRefresh | Forces the server to load the template from disk.
Output | Writes output to a file.
ResponseFormat | The format of the action output.
Template | The template to use for the action output.
TemplateParamCSVs | A list of variables to use for the specified template.

Copyright 2025 Open Text
Version 26.1 | Last updated January 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.1

Topic Title: EngineManagement