To run a group of servers as a managed domain you need to configure both the domain controller and each host that joins the domain. The following steps focus on the the network configuration for the domain and host controller components.
The domain controller is the central government for a managed domain. A domain controller configuration requires two steps:
- A host needs to be configured to act as the Domain Controller for the whole domain
- The host most expose an addressable management interface binding for the managed hosts to communicate with it
Configuring a host to act as the Domain Controller is done through the domain-controller declaration in host.xml. If it includes the <local/> element, then this host will become the domain controller:
A host acting as the Domain Controller must expose a native (i.e. non-HTTP) management interface on an address accessible to the other hosts in the domain. Also exposing an HTTP management interface is not required, but is recommended as it allows the Administration Console to work:
The interface attributes above refer to a named interface declaration later in the host.xml file. This interface declaration will be used to resolve a corresponding network interface.
Please consult the chapter "Interface Configuration" for a more detailed explanation on how to configure network interfaces.
Once the domain controller is configured correctly you can proceed with any host that should join the domain. The host controller configuration requires three steps:
- The logical host name (within the domain) needs to be distinct
- The host controller needs to be addressable by the domain controller (interface binding)
- The host controller needs to know the domain controller IP address
Provide a distinct, logical name for the host. In the following example we simply name it "staging":
Tell the host to expose a native (i.e. non-HTTP) management interface on an address accessible to the host that is acting as the Domain Controller. Exposing an HTTP management interface is not required, and is only necessary if the user has developed some custom HTTP-based management clients and wishes to use them to administer the host:
Assign an addressable IP address to the host controller itself. The address must be reachable by the Domain Controller:
Tell it how to find the domain controller so it can register itself with the domain: