Distribute the QueueInfo Action
After you configure asynchronous actions, you can use the QueueInfo
action to check the status of the action queue or a specific action, and manage the action queue.
To check a specific action, send the QueueInfo
action with the asynchronous action token returned by the child server. DAH uses the host and port information in the token to send the action to the correct child server.
By default, DAH retrieves this information from the child servers at startup to match the value in the token to its child server configuration.
If DAH cannot retrieve this information, it uses the HostPortAlias configuration parameter to apply the child server configuration options to the QueueInfo
action. DAH matches the HostPortAlias information to the child server configuration. For example, using the HostPortAlias configuration allows DAH to apply the appropriate SSL settings for the child server.
Find the Alias for a Child Server
If DAH cannot retrieve host and port information from its child servers for any reason, it uses the configured value of HostPortAlias to match tokens to its child servers.
The host and port that you specify for a child server in the HostPortAlias parameter must exactly match the host and port information in the asynchronous action tokens. This value does not necessarily match the Host and Port configuration parameters. For example, you might set Host to the computer name, and the token might return an IP address.
-
Open the DAH configuration file in a text editor.
-
In the
[Logging]
section, set LogLevel toFull
. -
Save and close the configuration file.
-
Restart the DAH for your changes to take effect.
-
After the DAH has started, send a
QueueInfo
action to the DAH. Set theToken
parameter to an action token for the child server for which you want to find the alias. For example:action=QueueInfo&Token=FOO-123&QueueAction=getstatus
-
Open the action log. In a default unified configuration, this file is located in the following directory:
installdir/IDOL/logs
-
Find the log message of the following type:
Checking alias for engine host(Host) and port(Port).
This
Host
andPort
value is the value that you must use in the HostPortAlias configuration parameter.
Use HostPortAlias
You can apply a host and port alias:
-
individually for each child server by using the HostPortAlias configuration parameter.
-
for all child servers by using the UseDefaultHostPortAlias configuration parameter.
In this case, if DAH cannot retrieve the child server host and port from the child servers, it matches the host and port information in the ansynchronous action tokens to the Host and Port parameters for each child server. You can use this option if the configured values exactly match the values in the asynchronous action token.
-
Open the DAH configuration file in a text editor.
-
Find the
[IDOLServerN]
or[DAHEngineN]
configuration sections. -
Set the HostPortAlias parameter to the host and port for the child server; separate the values with a colon. The host must exactly match the host and port in the asynchronous action token.
-
Save and close the configuration file.
-
Restart the DAH for your changes to take effect.
-
Open the DAH configuration file in a text editor.
-
In the
[Server]
section, set the UseDefaultHostPortAlias configuration parameter toTrue
. -
Save and close the configuration file.
-
Restart the DAH for your changes to take effect.