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:
- OK: indicates that the deploy is up and running.
- FAILED: indicates a dependency is missing or a service could not start.
- 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:
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