ocf_heartbeat_sfex(7)

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

NAME

6       ocf_heartbeat_sfex - Manages exclusive access to shared storage using
7       Shared Disk File EXclusiveness (SF-EX)
8

SYNOPSIS

10       sfex [start | stop | monitor | meta-data | validate-all]
11

DESCRIPTION

13       Resource script for SF-EX. It manages a shared storage medium
14       exclusively .
15

SUPPORTED PARAMETERS

17       device
18           Block device path that stores exclusive control data.  (required,
19           string, no default)
20
21       index
22           Location in block device where exclusive control data is stored. 1
23           or more is specified. Default is 1.  (optional, integer, default 1)
24
25       collision_timeout
26           Waiting time when a collision of lock acquisition is detected.
27           Default is 1 second.  (optional, integer, default 1)
28
29       monitor_interval
30           Monitor interval(sec). Default is 10 seconds (optional, integer,
31           default 10)
32
33       lock_timeout
34           Valid term of lock(sec). Default is 100 seconds. The lock_timeout
35           is calculated by the following formula. .sp lock_timeout =
36           monitor_interval + "The expiration time of the lock" .sp We suggest
37           90 seconds as a default value of the "The expiration time of the
38           lock", but you should change it in consideration of access delay to
39           the shared disk and the switch time of the multipath driver. .sp
40           The lock timeout have an impact on start action timeout because
41           start action timeout value is calculated by the following formula.
42           .sp start timeout = collision_timeout + lock_timeout + "safety
43           margin" .sp The "safety margin" is decided within the range of
44           about 10-20 seconds(It depends on your system requirement).
45           (optional, integer, default 100)
46

SUPPORTED ACTIONS

48       This resource agent supports the following actions (operations):
49
50       start
51           Starts the resource. Suggested minimum timeout: 120s.
52
53       stop
54           Stops the resource. Suggested minimum timeout: 20s.
55
56       monitor
57           Performs a detailed status check. Suggested minimum timeout: 10s.
58           Suggested interval: 10s.
59
60       meta-data
61           Retrieves resource agent metadata (internal use only). Suggested
62           minimum timeout: 5s.
63
64       validate-all
65           Performs a validation of the resource configuration. Suggested
66           minimum timeout: 5s.
67

EXAMPLE

69       The following is an example configuration for a sfex resource using the
70       crm(8) shell:
71
72           primitive p_sfex ocf:heartbeat:sfex \
73             params \
74               device=string \
75             op monitor depth="0" timeout="10s" interval="10s"
76

AUTHOR

81       Linux-HA contributors (see the resource agent source for information
82       about individual authors)
83
84
85
86resource-agents 3.9.2             07/08/2011             OCF_HEARTBEAT_SFEX(7)