WildFly CLI Concepts
Internal
TODO
Continue processing https://developer.jboss.org/wiki/CommandLineInterface, https://developer.jboss.org/wiki/JBossAS7Command-lineOperationRequestFormat, https://developer.jboss.org/wiki/CLICompoundValueFormat
Overview
The management CLI is a command line administration tool that manages WildFly nodes running in both standalone and domain mode. The tool exercises the native management API of the application server. The CLI client works with a managed domain or a standalone instance, allowing the user to control either the domain controller or the standalone server and execute management operations through a de-typed (string-driven) management model.
The Management CLI may be used to start and stop servers, deploy and undeploy applications, configure system settings and perform other administrative tasks. Operations can be performed in batch mode, allowing multiple tasks to be executed as a group. For servers running in domain mode, the CLI connects to the domain controller and can be used to manage the entire domain.
The Management CLI can perform all tasks the web-based management console can perform, as well as many other lower level operations that are not available to the web-based administration tool.
CLI and Management Interfaces
CLI clients connect to the managed WildFly instances over management interfaces. There are two types of management interfaces: native and http. For more details on management interfaces see:
Management Model Node
A management model node can be thought of as an XML element in the standalone instance or domain's configuration files.
CLI interacts with nodes via operations. The list of operations available for interaction with a node can be obtained at any time by navigating to that node and executing :read-operation-names. For more details see:
Command and Operations
The CLI interacts with the target controller by reading the user's commands and issuing operations.
Commands
Commands correspond to higher-level interactions with the controller. They are supposed to have user-friendlier syntax, but ultimately they translate into operations, or even composite operation requests. The list of available commands can be obtained with:
help --commands
To get more details about a specific command:
<command-name> --help
Some commands require an established connection to the controller (standalone or domain). Other commands may depend on the availability of specific subsystems (e.g. if the messaging subsystem is not available, messaging-related commands will not be listed).
For a list of commands, go to WildFly CLI Commands.
Operations
Operations are the finest-possible grained interaction mode with the controller: if it can't be done with an operation, it can't be done in any other way.
In general operations apply to a management model node, which is specified as an address (path) to that operation. In this respect, operations are interactions with management nodes:
/<address>:<operation-name>[(parameter-name-1=parameter-value-1,...)]
The generic format of an address is:
/node-type=node-name[/node-type=node-name/...]
where:
node-type is the resource node type. Usually, it maps to an element name in the configuration XML (standalone.xml, domain.xml and host.xml).
node-name is the resource node name. It maps to the "name" attribute of the element in the configuration XML.
Example:
/core-service=platform-mbean/type=threading:dump-all-threads(locked-monitors=true,locked-synchronizers=true)
The current node path is used as the address for operation requests that do not contain the address part. If an operation request does include the address, the included address is considered relative to the current node path. The current node path may end on a node-type. In that case, to execute an operation specifying a node-name would be sufficient, such as logging:read-resource.
Operations Available for a Certain Node
:read-operation-names
Navigate to the node and:
[domain@172.31.17.207:9999 subsystem=jgroups] :read-operation-names
Or specify the full path:
/profile=ha/subsystem=jgroups:read-operation-names
Example:
"add",
"read-attribute",
"read-children-names",
"read-children-resources",
"read-children-types",
"read-operation-description",
"read-operation-names",
"read-resource",
"read-resource-description",
"remove",
"undefine-attribute",
"whoami",
"write-attribute"
:read-operation-description
More details for a specific operation can be obtained with:
/profile=ha/subsystem=jgroups:read-operation-description(name=write-attribute)
Common Operations
CLI Archive
A cli archive is a zip archive containing script(s) as well as artifacts or applications to deploy. To be recognized as a cli archive, the extension of the archive file should be '.cli'. This is how they are used.