EngineAction

Specify one of the following values:

  • ShowStatus. Return the status of all child servers (online, offline, or down). EngineID is ignored in this case. Online indicates that the server is running, and DAH is sending actions to it. Offline indicates that the DAH is not sending actions to the child server, but it might or might not be running. Down indicates that the server is not running, or that DAH cannot connect to it. When DistributionMethod is set to 0 (failover), the action also returns the ID of the primary server.

  • PowerUp. Brings the EngineID child servers online.

  • PowerDown. Takes the EngineID child servers offline.

  • ChangeWeight. Dynamically changes the weight assigned through the Weight configuration parameter to the EngineID child servers. You must set the new weight by setting EngineWeight.

  • EngineAdd. Add a child server. If you use this value, you must also set EngineHost and EnginePort. You can set the EngineName parameter if UseEngineAlias is enabled, although it is not required.

  • EngineEdit. Edits a child server. If you use this value, you must also set EngineID (or EngineName if UseEngineAlias is enabled), and at least one of EngineHost or EnginePort to edit the host and/or port of the engine.

  • SetPrimaryEngine. Sets a child server as the primary server that DAH sends actions to. This action is available only when DistributionMethod is set to 0 (failover).

    In mirror mode, specify the new primary server by setting EngineID or EngineName. In non-mirror mode, when you have child server groups, you can set a primary server for each server group by setting PrimaryEngines.

  • Ping. Manually ping the EngineID child server. The effect of the manual ping is the same as automatic ping, and updates the status of the child server.

Actions: EngineManagement
Type: String
Default:  
Example: EngineAction=PowerDown
See Also: EngineHost
EngineName
EnginePort
PingPeriodInSec configuration parameter
Weight configuration parameter