Checking the status of a running application server

You can only execute a CLI command if the application server is running. Do not start the application server until you have finished the configuration and installation according to this manual.

After the execution of a CLI script, it can be useful to check if the server requires a reload or restart to make the changes effective. This can be achieved by using jboss-cli for a single command execution with the following command:

--command=":read-attribute(name=server-state)"

Response indicating that no reload or restart is required:

{
"outcome" => "success",
"result" => "running"
}

Response indicating that a reload or restart is required:

{
    "outcome" => "success",
    "result" => "reload-required",
    "response-headers" => {"process-state" => "reload-required"}
}

When you execute a CLI command, a response indicates if the execution was successful or failed. Within this response there can also be an indicator if a reload is required.

Success example

[standalone@127.0.0.1:10048 /] /interface=public:write-attribute(name=multicast, value=true)
{
    "outcome" => "success",
    "response-headers" => {
        "operation-requires-reload" => true,
        "process-state" => "reload-required"
    }
}

Error example

[standalone@127.0.0.1:10048 /] /interface=public:write-attribute(name=musticast, value=true)
{
    "outcome" => "failed",
    "failure-description" => "WFLYCTL0201: Unknown attribute 'musticast'",
    "rolled-back" => true
}