The host and port to use to match information in asynchronous action tokens to this child server. This parameter applies only when Distributed Action Handler is in mirror-mode and distributing asynchronous actions to child servers (when AsynchronousCommands is set).

When you send the QueueInfo action to the Distributed Action Handler with a token, Distributed Action Handler uses the host and port information in the token to forward the action to the correct child server. By default, Distributed Action Handler contacts its child servers at startup to request this host and port information. If it cannot retrieve this information from its children, it uses the values configured in HostPortAlias.

In this case, Distributed Action Handler uses the HostPortAlias configuration parameter to match the asynchronous action token to the child server configuration. For example, this configuration allows Distributed Action Handler to apply SSL settings.

The host must exactly match the host information that the asynchronous action token returns. To check this value, set the Distributed Action Handler action log stream LogLevel to FULL. The Distributed Action Handler then logs the following message for each child server:

Checking alias for engine host(Host) and port(Port).

Use these values in the HostPortAlias.

If these values match the Host and Port parameter, you can set UseDefaultHostPortAlias to true in the [Server] section to use this information as the HostPortAlias. If you set UseDefaultHostPortAlias to false, and do not set HostPortAlias for child servers, Distributed Action Handler does not use any value.

If you create a server group by specifying a comma-separated list of host names in the Host parameter, you must specify a value in the HostPortAlias parameter for each mirrored child server.

Type: String
Required: No
Configuration Section: IDOLServerN or DistributedEngineN or DAHEngineN
Example: HostPortAlias=
See Also: