ocf_heartbeat_tomcat(7)

1OCF_HEARTBEAT_TOMCAT(7)       OCF resource agents      OCF_HEARTBEAT_TOMCAT(7)
2
3
4

NAME

6       ocf_heartbeat_tomcat - Manages a Tomcat servlet environment instance
7

SYNOPSIS

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

DESCRIPTION

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

SUPPORTED PARAMETERS

16       tomcat_name
17           The name of the resource, added as a Java parameter in JAVA_OPTS:
18           -Dname=<tomcat_name> to Tomcat process on start. Used to ensure
19           process is still running and must be unique.  (unique, optional,
20           string, no default)
21
22       script_log
23           Log file, used during start and stop operations.  (unique,
24           optional, string, no default)
25
26       tomcat_stop_timeout
27           Time-out for stop operation. DEPRECATED (optional, integer, no
28           default)
29
30       tomcat_suspend_trialcount
31           Maximum number of times to retry stop operation before suspending
32           and killing Tomcat. DEPRECATED. Does not retry.  (optional,
33           integer, no default)
34
35       tomcat_user
36           The user who starts Tomcat.  (optional, string, no default)
37
38       statusurl
39           URL for state confirmation.  (optional, string, no default)
40
41       java_home
42           Home directory of Java.  (required, string, no default)
43
44       java_opts
45           Java JVM options used on start and stop.  (optional, string, no
46           default)
47
48       catalina_home
49           Home directory of Tomcat.  (unique, required, string, no default)
50
51       catalina_base
52           Instance directory of Tomcat (unique, optional, string, no default)
53
54       catalina_pid
55           A PID file name for Tomcat.  (unique, optional, string, no default)
56
57       tomcat_start_opts
58           Tomcat start options.  (optional, string, no default)
59
60       catalina_opts
61           Catalina options, for the start operation only.  (optional, string,
62           no default)
63
64       catalina_rotate_log
65           Rotate catalina.out flag.  (optional, string, no default)
66
67       catalina_rotatetime
68           catalina.out rotation interval (seconds).  (optional, integer, no
69           default)
70

SUPPORTED ACTIONS

72       This resource agent supports the following actions (operations):
73
74       start
75           Starts the resource. Suggested minimum timeout: 60s.
76
77       stop
78           Stops the resource. Suggested minimum timeout: 120s.
79
80       status
81           Performs a status check. Suggested minimum timeout: 60.
82
83       monitor
84           Performs a detailed status check. Suggested minimum timeout: 30s.
85           Suggested interval: 10s.
86
87       meta-data
88           Retrieves resource agent metadata (internal use only). Suggested
89           minimum timeout: 5s.
90
91       validate-all
92           Performs a validation of the resource configuration. Suggested
93           minimum timeout: 5.
94

EXAMPLE

96       The following is an example configuration for a tomcat resource using
97       the crm(8) shell:
98
99           primitive p_tomcat ocf:heartbeat:tomcat \
100             params \
101               java_home=string \
102               catalina_home=string \
103             op monitor depth="0" timeout="30s" interval="10s"
104

AUTHOR

109       Linux-HA contributors (see the resource agent source for information
110       about individual authors)
111
112
113
114resource-agents 3.9.2             07/08/2011           OCF_HEARTBEAT_TOMCAT(7)