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:

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.