NAME

       ocf_heartbeat_nfsserver - Manages an NFS server

SYNOPSIS

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

DESCRIPTION

       Nfsserver helps one to manage the Linux nfs server as a failover-able resource in Linux-HA. It depends on
       Linux specific NFS implementation details, so is considered not portable to other platforms yet.

SUPPORTED PARAMETERS

       nfs_init_script
           The default init script shipped with the Linux distro. The nfsserver resource agent offloads the
           start/stop/monitor work to the init script because the procedure to start/stop/monitor nfsserver
           varies on different Linux distro. In the event that this option is not set, this agent will attempt
           to use an init script at this location, /etc/init.d/nfs, or detect a systemd unit-file to use in the
           event that no init script is detected.

           (optional, string, default "auto detected")

       nfs_no_notify
           Do not send reboot notifications to NFSv3 clients during server startup.

           (optional, boolean, default false)

       nfs_notify_foreground
           Keeps the sm-notify attached to its controlling terminal and running in the foreground.

           (optional, boolean, default false)

       nfs_smnotify_retry_time
           Specifies the length of sm-notify retry time, in minutes, to continue retrying notifications to
           unresponsive hosts. If this option is not specified, sm-notify attempts to send notifications for 15
           minutes. Specifying a value of 0 causes sm-notify to continue sending notifications to unresponsive
           peers until it is manually killed.

           (optional, integer, no default)

       nfs_ip
           Comma separated list of floating IP addresses used to access the nfs service

           (optional, string, no default)

       nfs_shared_infodir
           The nfsserver resource agent will save nfs related information in this specific directory. And this
           directory must be able to fail-over before nfsserver itself.

           (optional, string, no default)

       rpcpipefs_dir
           The mount point for the sunrpc file system. Default is /var/lib/nfs/rpc_pipefs. This script will
           mount (bind) nfs_shared_infodir on /var/lib/nfs/ (cannot be changed), and this script will mount the
           sunrpc file system on /var/lib/nfs/rpc_pipefs (default, can be changed by this parameter). If you
           want to move only rpc_pipefs/ (e.g. to keep rpc_pipefs/ local) from default, please set this value.

           (optional, string, default "/var/lib/nfs/rpc_pipefs")

SUPPORTED ACTIONS

       This resource agent supports the following actions (operations):

       start
           Starts the resource. Suggested minimum timeout: 40.

       stop
           Stops the resource. Suggested minimum timeout: 20s.

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

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

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

EXAMPLE CRM SHELL

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

           primitive p_nfsserver ocf:heartbeat:nfsserver \
             op monitor depth="0" timeout="20s" interval="10"

EXAMPLE PCS

       The following is an example configuration for a nfsserver resource using pcs(8)

           pcs resource create p_nfsserver ocf:heartbeat:nfsserver \
             op monitor depth="0" timeout="20s" interval="10"

SEE ALSO

       http://www.linux-ha.org/wiki/nfsserver_(resource_agent)

AUTHOR

       Linux-HA contributors (see the resource agent source for information about individual authors)

resource-agents 3.9.7-1ubuntu1                     05/08/2019                            OCF_HEARTBEAT_NFSSER(7)