WildFly Domain Controller Post-Install Configuration

Internal

• WildFly Unzip Installation

Overview

This procedure is part of WildFly Unzip Installation. Once completed, return to WildFly Unzip Installation to continue the post-install procedure.

Local Domain Controller

For the domain controller, the host and the domain controller are collocated, so the host controller configuration file host.xml should specify a local domain controller:

<domain-controller>
       <local/>
</domain-controller>

This is the default configuration.

host.xml Host Name

The host.xml comes with default conventional host names. However, if building a custom environment, it's a good idea to change the host name to match the actual host name the domain controller runs on. This will make the information displayed by various console more descriptive and user friendly.

Example:

<host name="dc1" xmlns="urn:jboss:domain:1.7">
    ...
</host>

More details about the host name are available here:

host.xml host name

Management Interface Bind Address

The domain controller accept connections from the subordinated host controllers over the management interfaces defined in its host.xml.

The value of address to bind to can be externalized as jboss.bind.address.management. For more details on how to configure jboss.bind.address.management, see:

jboss.bind.address.management for domain controllers

The value can also be hardcoded in host.xml as follows:

    ...
    <interfaces>
        <interface name="management">
            <inet-address value="1.2.3.4"/>
        </interface>
        ...
    </interfaces>

One factor to consider when deciding between externalizing the value or hardcoding it is that an externalized system property defined in domain.conf is exposed to all processes (process controller, host controller, domain controller and server instance.

Management Interface Bind Address Change Effect on CLI

Changing the management bind address has a side effect the fact that the CLI cannot connect to localhost:9999 as it is configured by default. In order to work around, the new address could be specified on CLI command line (see Connect CLI to a Specific Controller) or its configuration file can be updated (see CLI Configuration - Management Interface Bind Address).

Confirmation that It Binds Correctly

$JBOSS_HOME/domain/log/host-controller.log

...
22:28:18,337 INFO  [org.jboss.as.remoting] (MSC service thread 1-5) JBAS017100: Listening on 10.155.78.202:9999
...

Security

At this point, the local administrative user should have been configured already (WildFly Unzip Installation#Security).

Subordinate host controllers use their names to authenticate against the "ManagementRealm" on the domain controller, and we'll add the corresponding "users" as we add remote host controllers. Configuring subordinate host controller security if part of the Subordinate WildFly Host Controller Post-Install Configuration procedure.