1OCF_HEARTBEAT_EXPORT(7) OCF resource agents OCF_HEARTBEAT_EXPORT(7)
2
6 ocf_heartbeat_exportfs - Manages NFS exports
7
9 exportfs [start | stop | monitor | meta-data | validate-all]
10
12 Exportfs uses the exportfs command to add/remove nfs exports. It does
13 NOT manage the nfs server daemon. It depends on Linux specific NFS
14 implementation details, so is considered not portable to other
15 platforms yet.
16
18 clientspec
19 The client specification allowing remote machines to mount the
20 directory over NFS. (required, string, no default)
21 options
23 The options to pass to exportfs for the exported directory.
24 (optional, string, no default)
25 directory
27 The directory which you wish to export using NFS. (required,
28 string, no default)
29 fsid
31 The fsid option to pass to exportfs. This can be a unique positive
32 integer, a UUID, or the special string "root" which is functionally
33 identical to numeric fsid of 0. 0 (root) identifies the export as
34 the root of an NFSv4 pseudofilesystem -- avoid this setting unless
35 you understand its special status. This value will override any
36 fsid provided via the options parameter. (unique, required,
37 string, no default)
38 unlock_on_stop
40 Relinquish NFS locks associated with this filesystem when the
41 resource stops. Enabling this parameter is highly recommended
42 unless the path exported by this exportfs resource is also exported
43 by a different resource. (optional, boolean, default 0)
44 wait_for_leasetime_on_stop
46 When stopping (unexporting), wait out the NFSv4 lease time. Only
47 after all leases have expired does the NFS kernel server relinquish
48 all server-side handles on the exported filesystem. If this
49 exportfs resource manages an export that resides on a mount point
50 designed to fail over along with the NFS export itself, then
51 enabling this parameter will ensure such failover is working
52 properly. Note that when this parameter is set, your stop timeout
53 MUST accommodate for the wait period. This parameter is safe to
54 disable if none of your NFS clients are using NFS version 4 or
55 later. (optional, boolean, default 0)
56 rmtab_backup
58 Back up those entries from the NFS rmtab that apply to the exported
59 directory, to the specified backup file. The filename is
60 interpreted as relative to the exported directory. This backup is
61 required if clients are connecting to the export via NFSv3 over
62 TCP. Note that a configured monitor operation is required for this
63 functionality. .sp To disable rmtab backups, set this parameter to
64 the special string "none". (optional, string, default .rmtab)
65
67 This resource agent supports the following actions (operations):
68 start
70 Starts the resource. Suggested minimum timeout: 40.
71 stop
73 Stops the resource. Suggested minimum timeout: 10.
74 monitor
76 Performs a detailed status check. Suggested minimum timeout: 20.
77 Suggested interval: 10.
78 meta-data
80 Retrieves resource agent metadata (internal use only). Suggested
81 minimum timeout: 5.
82 validate-all
84 Performs a validation of the resource configuration. Suggested
85 minimum timeout: 30.
86
88 The following is an example configuration for a exportfs resource using
89 the crm(8) shell:
90 primitive p_exportfs ocf:heartbeat:exportfs \
92 params \
93 clientspec=string \
94 directory=string \
95 fsid=string \
96 op monitor depth="0" timeout="20" interval="10"
97
99 http://www.linux-ha.org/wiki/exportfs_(resource_agent)
100
102 Linux-HA contributors (see the resource agent source for information
103 about individual authors)
104resource-agents 3.9.2 07/08/2011 OCF_HEARTBEAT_EXPORT(7)