ocf_heartbeat_exportfs — Manages NFS exports


exportfs [ start | stop | monitor | meta-data | validate-all ]


Exportfs uses the exportfs command to add/remove nfs exports. It does NOT manage the nfs server daemon. It depends on Linux specific NFS implementation details, so is considered not portable to other platforms yet.

Supported Parameters


The client specification allowing remote machines to mount the directory over NFS. (required, string, no default)


The options to pass to exportfs for the exported directory. (optional, string, no default)


The directory which you wish to export using NFS. (required, string, no default)


The fsid option to pass to exportfs. This can be a unique positive integer, a UUID, or the special string "root" which is functionally identical to numeric fsid of 0. 0 (root) identifies the export as the root of an NFSv4 pseudofilesystem -- avoid this setting unless you understand its special status. This value will override any fsid provided via the options parameter. (required, string, no default)


Relinquish NFS locks associated with this filesystem when the resource stops. Enabling this parameter is highly recommended unless the path exported by this exportfs resource is also exported by a different resource. (optional, boolean, default 0)


When stopping (unexporting), wait out the NFSv4 lease time. Only after all leases have expired does the NFS kernel server relinquish all server-side handles on the exported filesystem. If this exportfs resource manages an export that resides on a mount point designed to fail over along with the NFS export itself, then enabling this parameter will ensure such failover is working properly. Note that when this parameter is set, your stop timeout MUST accommodate for the wait period. This parameter is safe to disable if none of your NFS clients are using NFS version 4 or later. (optional, boolean, default 0)

Supported Actions

This resource agent supports the following actions (operations):


Starts the resource. Suggested minimum timeout: 40.


Stops the resource. Suggested minimum timeout: 10.


Performs a detailed status check. Suggested minimum timeout: 20. Suggested interval: 10.


Retrieves resource agent metadata (internal use only). Suggested minimum timeout: 5.


Performs a validation of the resource configuration. Suggested minimum timeout: 30.


The following is an example configuration for a exportfs resource using the crm(8) shell:

primitive example_exportfs ocf:heartbeat:exportfs \
  params \
    clientspec=string \
    directory=string \
    fsid=string \
  op monitor depth="0" timeout="20" interval="10" 

See also