catalina

OCF_HEARTBEAT_TOMCAT(7) 					OCF resource agents					   OCF_HEARTBEAT_TOMCAT(7)

NAME

       ocf_heartbeat_tomcat - Manages a Tomcat servlet environment instance

SYNOPSIS

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

DESCRIPTION

       Resource script for Tomcat. It manages a Tomcat instance as a cluster resource.

SUPPORTED PARAMETERS

       tomcat_name
	   The name of the resource, added as a Java parameter in JAVA_OPTS: -Dname=<tomcat_name> to Tomcat process on start. Used to ensure
	   process is still running and must be unique.  (unique, optional, string, no default)

       script_log
	   Log file, used during start and stop operations.  (unique, optional, string, no default)

       tomcat_stop_timeout
	   Time-out for stop operation. DEPRECATED (optional, integer, no default)

       tomcat_suspend_trialcount
	   Maximum number of times to retry stop operation before suspending and killing Tomcat. DEPRECATED. Does not retry.  (optional, integer,
	   no default)

       tomcat_user
	   The user who starts Tomcat.	(optional, string, no default)

       statusurl
	   URL for state confirmation.	(optional, string, no default)

       java_home
	   Home directory of Java.  (required, string, no default)

       java_opts
	   Java JVM options used on start and stop.  (optional, string, no default)

       catalina_home
	   Home directory of Tomcat.  (unique, required, string, no default)

       catalina_base
	   Instance directory of Tomcat (unique, optional, string, no default)

       catalina_pid
	   A PID file name for Tomcat.	(unique, optional, string, no default)

       tomcat_start_opts
	   Tomcat start options.  (optional, string, no default)

       catalina_opts
	   Catalina options, for the start operation only.  (optional, string, no default)

       catalina_rotate_log
	   Rotate catalina.out flag.  (optional, string, no default)

       catalina_rotatetime
	   catalina.out rotation interval (seconds).  (optional, integer, no default)

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: 60.

       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 tomcat resource using the crm(8) shell:

	   primitive p_tomcat ocf:heartbeat:tomcat 
	     params 
	       java_home=string 
	       catalina_home=string 
	     op monitor depth="0" timeout="30s" interval="10s"

SEE ALSO

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

AUTHOR

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

resource-agents UNKNOWN 					    03/09/2014						   OCF_HEARTBEAT_TOMCAT(7)