OCF_HEARTBEAT_JBOSS(7)						OCF resource agents					    OCF_HEARTBEAT_JBOSS(7)

NAME

       ocf_heartbeat_jboss - Manages a JBoss application server instance

SYNOPSIS

       jboss [start | stop | status | monitor | meta-data | validate-all]

DESCRIPTION

       Resource script for Jboss. It manages a Jboss instance as an HA resource.

SUPPORTED PARAMETERS

       resource_name
	   The name of the resource. Defaults to the name of the resource instance. (optional, string, default default)

       console
	   A destination of the log of jboss run and shutdown script. (optional, string, no default)

       shutdown_timeout
	   Timeout for jboss bin/shutdown.sh. We wait for this timeout to expire, then send the TERM and QUIT signals. Finally, the KILL signal is
	   used to terminate the jboss process. You should set the timeout for the stop operation to a value bigger than the sum of the timeout
	   parameters. See also kill_timeout. (optional, integer, default 5)

       kill_timeout
	   If bin/shutdown.sh doesn't stop the jboss process, then we send it TERM and QUIT signals, intermittently and once a second. After this
	   timeout expires, if the process is still live, we use the KILL signal. See also shutdown_timeout. (optional, integer, default 10)

       user
	   A user name to start a JBoss. (optional, string, default root)

       statusurl
	   URL to test in the monitor operation. (optional, string, default http://127.0.0.1:8080)

       java_home
	   Home directory of Java. Defaults to the environment variable JAVA_HOME. If it is not set, then define this parameter. (optional,
	   string, no default)

       jboss_home
	   Home directory of Jboss. (required, string, no default)

       pstring
	   With this string heartbeat matches for the right process to kill. (optional, string, default java -Dprogram.name=run.sh)

       run_opts
	   Start options to start Jboss with, defaults are from the Jboss-Doku. (optional, string, default -c default -l lpg4j)

       shutdown_opts
	   Stop options to stop Jboss with. (optional, string, default -s 127.0.0.1:1099)

SUPPORTED ACTIONS

       This resource agent supports the following actions (operations):

       start
	   Starts the resource. Suggested minimum timeout: 60s.

       stop
	   Stops the resource. Suggested minimum timeout: 120s.

       status
	   Performs a status check. Suggested minimum timeout: 30s.

       monitor
	   Performs a detailed status check. Suggested minimum timeout: 30s. Suggested interval: 10s.

       meta-data
	   Retrieves resource agent metadata (internal use only). Suggested minimum timeout: 5s.

       validate-all
	   Performs a validation of the resource configuration. Suggested minimum timeout: 5.

EXAMPLE

       The following is an example configuration for a jboss resource using the crm(8) shell:

	   primitive example_jboss ocf:heartbeat:jboss 
	     params 
	       jboss_home=string 
	     op monitor depth="0" timeout="30s" interval="10s"

SEE ALSO

       http://www.linux-ha.org/wiki/jboss_(resource_agent)

AUTHOR

       Linux-HA contributors (see the resource agent source for information about individual authors)

resource-agents 1.0.3						    07/05/2010						    OCF_HEARTBEAT_JBOSS(7)