Chapter 5. Using the Management CLI with a Managed Domain

You can use the management CLI to configure and manage both standalone servers and managed domains. The JBoss EAP documentation usually shows examples of management CLI commands for a standalone server configuration. If you are running a managed domain instead, you often need to adjust the command. The following sections describe how to change standalone server management CLI commands for a managed domain configuration.

Specify the Profile for Subsystem Configuration

The management CLI commands for standalone server subsystem configuration begin with /subsystem=SUBSYSTEM_NAME. For managed domain subsystem configuration, you must specify which profile’s subsystem to configure by starting the command with /profile=PROFILE_NAME/subsystem=SUBSYSTEM_NAME.

Example: Read the Logging Subsystem Configuration (Standalone Server)

/subsystem=logging:read-resource

This example shows how to read the configuration of the logging subsystem for a standalone server.

Example: Read the Logging Subsystem Configuration (Managed Domain)

/profile=default/subsystem=logging:read-resource

This example shows how to read the configuration of the logging subsystem for a the default profile in a managed domain.

Specify the Host for Core Management and Runtime Commands

Some core management and runtime commands for a managed domain require you to specify the host that the command applies to by starting the command with /host=HOST_NAME.

Example: Enable Audit Logging (Standalone Server)

/core-service=management/access=audit/logger=audit-log:write-attribute(name=enabled,value=true)

This example shows how to enable audit logging for a standalone server.

Example: Enable Audit Logging (Managed Domain)

/host=master/core-service=management/access=audit/logger=audit-log:write-attribute(name=enabled,value=true)

This example shows how to enable audit logging for the master host in a managed domain.

Note

Some commands require the host as an argument, for example, reload --host=HOST_NAME. If you do not specify a host for these commands, an error message notifies you that the --host argument is required.

Specify the Server for Core Management and Runtime Commands

Some core management and runtime commands for a managed domain require you to specify the host and server that the command applies to by starting the command with /host=HOST_NAME/server=SERVER_NAME.

Example: Display Runtime Metrics for a Deployment (Standalone Server)

/deployment=test-application.war/subsystem=undertow:read-attribute(name=active-sessions)

This example shows how to display runtime metrics for a standalone server deployment.

Example: Display Runtime Metrics for a Deployment (Managed Domain)

/host=master/server=server-one/deployment=test-application.war/subsystem=undertow:read-attribute(name=active-sessions)

This example shows how to display runtime metrics for a managed domain deployment that is deployed to the server-one server on the master host.