JBoss EAP 7 Domain deployments – Part 4: Domain deployment with REST Management API.

In this blog series we will present several ways to deploy an application on an EAP Domain. The series consists of five parts. Each one will be a standalone article, but the series as a whole will present a range of useful topics for working with JBoss EAP.

In part one of this series, we setup a simple JBoss EAP Domain. In  part two we reviewed the EAP Management Console deployment Mechanism and deployed the helloworld-html5 EAP Quickstart on the main-server-group ( Server11 and Server21), in part three, we checked how to deployedhelloworld-html5 on secondary-server-group using the CLI Command line; in this tutorial, part four, we are going to explore another deployment option: the REST Management API. To do so, we will upload a file in the EAP content repository and then deploy it.

Management Interfaces

On the master domain controller, we set up two management interfaces: the native on port 9999, and the HTTP management interface on port 9990.

While the CLI uses the native management port, and the EAP management console and the REST API are available on the HTTP management port, all these management interfaces also share common XML configuration files: host.xml/domain.xml. They also send commands to EAP using an intermediate representation called DMR ( Dynamic Model Representation).

Everything you need to grow your career.

With your free Red Hat Developer program membership, unlock our library of cheat sheets and ebooks on next-generation application development.



DMR stands for Dynamic Model Representation, and it is a new syntax introduced with EAP 6 to denote Java objects associated with EAP Management interfaces. DMR is flatter than XML files and all the items are at the same level. Let’s check out a sample:

The domain.xml configuration section containing EAP profiles and server groups looks like this:

 <profile name="default">
 <profile name="ha">
 <profile name="full">
 <profile name="full-ha">

 <server-group name="primary-server-group" profile="full">
 <server-group name="secondary-server-group" profile="full">
 <server-group name="singleton-server-group" profile="default">

And the DMR representation of this same XML looks like this:

"profile" => {
 "default" => undefined,
 "ha" => undefined,
 "full" => undefined,
 "full-ha" => undefined
 "server-group" => {
 "primary-server-group" => undefined,
 "secondary-server-group" => undefined,
 "singleton-server-group" => undefined,

The EAP Configuration is made up of a DMR tree, and using the CLI you can navigate through the entire configuration: deployments, server-groups, subsystems and modules, hosts… you can even update the DMR tree with specific operations.

For example, to read the whole configuration:

[domain@localhost:9990 /] :read-resource
 "outcome" => "success",
 "result" => {
 "domain-organization" => undefined,
 "management-major-version" => 4,

To check the undertow subsystem configuration on ha profile:

[domain@localhost:9990 /]/profile=ha/subsystem=undertow:read-resource
 "outcome" => "success",
 "result" => {
 "default-security-domain" => "other",
 "default-server" => "default-server",
 "default-servlet-container" => "default",
 "default-virtual-host" => "default-host",
 "instance-id" => expression "${jboss.node.name}",
 "statistics-enabled" => false,
 "buffer-cache" => {"default" => undefined},
 "configuration" => {
 "filter" => undefined,
 "handler" => undefined
 "server" => {"default-server" => undefined},
 "servlet-container" => {"default" => undefined}

Generate DMR Queries with CLI gui

The  command builder in the CLI console can be used to generate queries in DMR Syntax. Start the CLI in a graphical tool by adding the –gui option:

enonowog-OSX:bin enonowog$ ./jboss-cli.sh --gui



All the management interfaces rely on JBoss DRM to read/update the configuration; the REST API is based on this feature.

The mangement API is available at, and this endpoint accepts JSON POST requests of the format:

data:operation:the operation to be performed:address:the path on which the operation should be performed

This is an array with all the path items and finally the operation parameters ( names and values).  The authentication type is DIGEST.

To check the status of server 11, for example, we use the following DMR:

 "outcome" => "success",
 "result" => "STOPPED"

With the REST API, we would do this instead:

$ curl --digest 'http://localhost:9990/management' --header "Content-type:application/json"-d '{"operation":"read-attribute", "address":["host","host1","server","Server11"],"name":"server-state","json.pretty":1}' -u admin:Admin01#
 "outcome" : "success",
 "result" : "STOPPED"

REST API  Deployment

To deploy the helloworld-html5 application on the singleton server group using the REST management API, we simply have to add the helloworld-html5-war on the server group.

This is the DRM command to complete our operation:


From this we can build API parameters, and the REST query can be deduced from DMR:


And our REST command:

$ curl --digest 'http://localhost:9990/management' --header "Content-type:application/json"-d '{"operation":"add", "address":["server-group","singleton-server-group","deployment","jboss-helloworld-html5.war"],"enabled":"true","json.pretty":1}' -u admin:Admin01#
 "outcome" : "success",
 "result" : null,
 "server-groups" : {"singleton-server-group" : {"host" : {"host2" : {"Server23" : {"response" : {
 "outcome" : "success",
 "result" : null

This command deploys the application on instance server 23, the only member of the singleton-server-group, and enables it. Remember server 23’s HTTP port is 8580

Capture d’écran 2016-07-20 à 13.58.40

The application is now deployed on the five servers, and this concludes our chapter on deployment. We now know how the different deployment options can be used, depending on our projects requirements.

The REST API is interesting if we have a continuous integration tools like Jenkins on some WebHooks to trigger deployments after the builds, but DMR is clearly easier for scripting and the command line.




Join the Red Hat Developer Program (it’s free) and get access to related cheat sheets, books, and product downloads.