Quick ways to check the application status from shell with JBoss

The simplest way to check the status of an application running on JBoss / WildFly is to use the CLI tool and the deployment-info command.

Here’s an example: supposing you have deployed the helloworld.war application, launch the CLI and connect to the server:

$ bin/jboss-cli.sh -c

Then, check the status of the helloworld.war application:

[standalone@localhost:9990 /] deployment-info --name=helloworld.war
NAME           RUNTIME-NAME   PERSISTENT ENABLED STATUS 
helloworld.war helloworld.war true       true    OK 

There can be three possible states:

  1. OK: indicates that the deploy is up and running.
  2. FAILED: indicates a dependency is missing or a service could not start.
  3. STOPPED: indicates that the deployment was not enabled or was manually stopped.

Checking application status from the Web console

Another option is to use the Web Console to check the application’s status. Create a management user and connect to the Web Console ( See the following tutorial to learn more: How to manage JBoss / WildFly remotely

Once connected to the Console, head to the Deployments tab and choose the application you want to check:

check application status jboss

As you can see, the same Status code are reported in the Web console

JBoss AS 5

If you are still running JBoss AS 5, you can use the twiddle commandline tool instead.

This is a two process step: at first you need to retrieve the deployment-id associated with your application:

twiddle -s localhost:1099 query jboss.web.deployment:*

jboss.web.deployment:war=invoker.war,id=1188245482
jboss.web.deployment:war=jbossmq-httpil.war,id=818328454
jboss.web.deployment:war=jmx-console.war,id=-742061087
jboss.web.deployment:war=jboss-seam-registration.war,id=209639553
jboss.web.deployment:war=jbossws-context.war,id=270573684
jboss.web.deployment:war=jboss-profiler.war,id=1640316612
jboss.web.deployment:war=jboss-seam-messages.war,id=-632397857
jboss.web.deployment:war=ROOT.war,id=1273039891
jboss.web.deployment:war=jboss-seam-numberguess.war,id=-1863357686
jboss.web.deployment:war=Gap.war,id=-1263613270
jboss.web.deployment:war=web-console.war,id=2121270277

Now feed this id to twiddle issuing a get request :

twiddle -s localhost:1099 get –noprefix “jboss.web.deployment:war=Gap.war,id=-1263613270” StateString

Started

Notice that Unix users can use the magic “expansion” facility to get this just in one step:

./twiddle.sh -s 127.0.0.1:1099 get –noprefix `./twiddle.sh -s 127.0.0.1:1099 query jboss.web.deployment:* | grep war_name` StateString