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. |
| EncryptResponse | Encrypt the output. |
| 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. |