Chapter 4. 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.
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.
Where did the comment section go?
Red Hat's documentation publication system recently went through an upgrade to enable speedier, more mobile-friendly content. We decided to re-evaluate our commenting platform to ensure that it meets your expectations and serves as an optimal feedback mechanism. During this redesign, we invite your input on providing feedback on Red Hat documentation via the discussion platform.