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. (optional, string, no default)

script_log

Log file, used during start and stop operations. (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. (required, string, no default)

catalina_base

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

catalina_pid

A PID file name for Tomcat. (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 example_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)