Distributed Action Handler 25.4
Distributed Action Handler Help

# 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

Copyright 2025 Open Text
Version 25.4 | Last updated October 2025

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to MFI-swpdl.idoldocsfeedback@opentext.com.

We appreciate your feedback!

Product: Knowledge Discovery Distributed Action Handler 25.4

Topic Title: EngineAction