ocf_heartbeat_nfsserver (7) - Linux Manuals

ocf_heartbeat_nfsserver: Manages an NFS server

NAME

ocf_heartbeat_nfsserver - Manages an NFS server

SYNOPSIS

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

DESCRIPTION

Nfsserver helps 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)

nfsd_args

Specifies what arguments to pass to the nfs daemon on startup. View the rpc.nfsd man page for information on what arguments are available. Note that setting this value will override all settings placed in the local /etc/sysconfig/nfs file.

(optional, string, no default)

lockd_udp_port

The udp port lockd should listen on. Note that setting this value will override all settings placed in the local /etc/sysconfig/nfs file.

(optional, integer, no default)

lockd_tcp_port

The tcp port lockd should listen on. Note that setting this value will override all settings placed in the local /etc/sysconfig/nfs file.

(optional, integer, no default)

statd_outgoing_port

The source port number sm-notify uses when sending reboot notifications. Note that setting this value will override all settings placed in the local /etc/sysconfig/nfs file.

(optional, integer, no default)

statd_port

The port number used for RPC listener sockets. Note that setting this value will override all settings placed in the local /etc/sysconfig/nfs file.

(optional, integer, no default)

mountd_port

The port number used for rpc.mountd listener sockets. Note that setting this value will override all settings placed in the local /etc/sysconfig/nfs file.

(optional, integer, no default)

rquotad_port

The port number used for rpc.rquotad. Note that setting this value will override all settings placed in the local /etc/sysconfig/nfs file.

(optional, integer, 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" 

AUTHOR

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