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. |