Aliasing hosts with host-id

In each host definition, you can create a unique alias called host-id that may be used to refer to the specified host and port. (The host-name and port do not need to be unique.)

For example, say you defined host1 as follows:

<host host-id="host1" host-name="localhost" port="8888" />

Later, when defining components, you could simply refer to that host-id when specifying the host for a given component.

<dgidx name="dgidx-0" host-id="host1">

Aliasing hosts in this way has two benefits:

• It allows you to switch staging and production machines easily, by changing the name and port associated with a host-id alias.
• It makes it possible to reference a single physical host through different host-id aliases.