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, default "root")

       statusurl
	   URL for state confirmation.

	   (optional, string, no default)

       max_stop_time
	   Number of seconds to wait during a stop before drastic measures (force kill) are used on the tomcat process. This number MUST be less
	   than your cluster stop timeout for the resource. The default value is five seconds before the timeout value of stop operation. When it
	   is over this value, it stops a process in kill commands. This parameter is only effective on Tomcat 6 or later.

	   (optional, integer, 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.

	   (required, string, no default)

       catalina_base
	   Instance directory of Tomcat

	   (unique, optional, string, no default)

       catalina_out
	   Log file name of Tomcat

	   (unique, optional, string, no default)

       catalina_pid
	   A PID file name for Tomcat.

	   (unique, optional, string, no default)

       tomcat_start_script
	   Absolute path to the custom tomcat start script to use.

	   (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_tmpdir
	   Temporary directory of Tomcat

	   (unique, optional, string, no default)

       catalina_rotate_log
	   Rotate catalina.out flag.

	   (optional, boolean, default NO)

       catalina_rotatetime
	   catalina.out rotation interval (seconds).

	   (optional, integer, no default)

       java_endorsed_dirs
	   Java_endorsed_dirs of tomcat

	   (unique, optional, string, no default)

       logging_config
	   Logging_config of tomcat

	   (unique, optional, string, no default)

       logging_manager
	   Logging_manager of tomcat

	   (unique, optional, string, 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 					    06/09/2014						   OCF_HEARTBEAT_TOMCAT(7)