KB-1134 "jboss.jmx.remoting-connector-ref is missing [jboss.remoting.endpoint.management]" error thrown during JBoss startup

Symptoms

Right before the end of a JBoss startup, the following error is printed in the application server log:

ERROR [org.jboss.as.controller.management-operation] (Controller Boot Thread) JBAS014612: Operation ("add") failed - address: ([
    ("subsystem" => "jmx"),
    ("remoting-connector" => "jmx")
]) - failure description: {"JBAS014771: Services with missing/unavailable dependencies" => ["jboss.jmx.remoting-connector-ref is missing [jboss.remoting.endpoint.management]"]}

This is seen before the INFO [org.jboss.as.server] (ServerService Thread Pool -- 29) JBAS015859: Deployed "appian-ds.xml" (runtime-name : "appian-ds.xml") line.

Cause

No management interfaces were configured in standalone.xml prior to starting JBoss. This is typically the result of making modifications to the out-of-the-box standalone.xml file. Making any modifications to any JBoss files that are not documented by Appian are unsupported by Appian.

Action

1. Edit standalone.xml located in <JBOSS_HOME>/standalone/configuration.
2. Add the following lines after the <audit-log> element:
   

   <management-interfaces>
   <native-interface security-realm="ManagementRealm">
       <socket-binding native="management-native"/>
   </native-interface>
   <http-interface security-realm="ManagementRealm">
        <socket-binding http="management-http"/>
   </http-interface>
   </management-interfaces>

3. Add the following lines inside the <socket-binding-group> element:
   

   <socket-binding name="management-native" interface="management" port="${jboss.management.native.port:9999}"/>
   <socket-binding name="management-http" interface="management" port="${jboss.management.http.port:9990}"/>
   <socket-binding name="management-https" interface="management" port="${jboss.management.https.port:9443}"/>

4. Save the file.
5. Set the appropriate marker files and restart JBoss.

Affected Versions

This article applies to all versions of Appian using JBoss EAP as an application server.