Open topic with navigation

# EngineManagement

Take child servers online and offline. With the `EngineManagement` action, you can dynamically (without restarting the HPE DAH) bring child IDOL servers online or take them offline. You can also check the status of a child server, and manage primary servers.

If you mark a child server as offline, the HPE DAH sends no requests (even polling requests) to it, until you bring it back online again.

Note: This is an administrative action that can be sent only from HPE DAH AdminClients (which are set in the HPE DAH configuration file `[Server]` section).

## Example

    http://Hobbes:25000/action=EngineManagement&EngineAction=PowerDown&EngineID=2,4

This action uses port `25000` to take offline the child IDOL servers with IDs `2` and `4` of the HPE DAH on the host `Hobbes`.

## Parameter

Parameter | Description | Required
--- | --- | ---
EngineAction | The action to take on the specified child servers. | yes
EngineHost | The host of the new server when `EngineAction=EngineAdd`. | see Comments
EngineID | The child servers to perform the specified action on. | see Comments
EngineName | Specifies one or more aliases of child IDOL servers to mark as online or offline. |
EnginePort | The port of the new server when `EngineAction=EngineAdd`. | see Comments
EngineWeight | The new weight of a child server. | see Comments
PrimaryEngines | The IDs of the primary servers in child server groups when `EngineAction=SetPrimaryEngines`. |

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.

## Comments

- The EngineID parameter is required if the EngineAction parameter has the values `PowerUp`, `PowerDown`, or `ChangeWeight`.
- EngineName is only valid when UseEngineAlias is set to `TRUE`, in which case, either EngineID or EngineName can be used.
- EngineWeight is only valid when EngineAction is set to `ChangeWeight` and an EngineID is specified.
- EngineHost and EnginePort are only valid when EngineAction is set to `ChangeWeight`.

© 2016 Hewlett Packard Enterprise Development LP | Send documentation feedback to HPE Close Send Documentation Feedback To open the configured email client on this computer, open an email window. Otherwise, copy the information below to a web mail client, and send this email to AutonomyTPFeedback@hpe.com. We appreciate your feedback! Product: Topic Title: Help Topic: Feedback:

_HP_HTML5_bannerTitle.htm