|
NAMEocf_heartbeat_nfsserver - Manages an NFS serverSYNOPSISnfsserver [start | stop | monitor | meta-data | validate-all] DESCRIPTIONNfsserver 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 PARAMETERSnfs_init_scriptThe 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/nfsserver, 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_server_scope RFC8881, 8.4.2.1 State Reclaim:
If the server scope is different, the client should not attempt to reclaim locks. In this situation, no lock reclaim is possible. Any attempt to re-obtain the locks with non-reclaim operations is problematic since there is no guarantee that the existing filehandles will be recognized by the new server, or that if recognized, they denote the same objects. It is best to treat the locks as having been revoked by the reconfiguration event. For lock reclaim to even be attempted, we have to define and set the same server scope for NFSD on all cluster nodes in the NFS failover cluster. This agent won't "guess" a suitable server scope name for you, you need to explicitly specify this. But without it, NFSv4 lock reclaim after failover won't work properly. Suggested value: the failover "service IP". (optional, string, 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 ACTIONSThis resource agent supports the following actions (operations):start Starts the resource. Suggested minimum timeout:
40s.
stop Stops the resource. Suggested minimum timeout: 20s.
monitor Performs a detailed status check. Suggested minimum
timeout: 20s. Suggested interval: 10s.
meta-data Retrieves resource agent metadata (internal use only).
Suggested minimum timeout: 5s.
validate-all Performs a validation of the resource configuration.
Suggested minimum timeout: 30s.
EXAMPLE CRM SHELLThe 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="10s" EXAMPLE PCSThe following is an example configuration for a nfsserver resource using pcs(8)pcs resource create p_nfsserver ocf:heartbeat:nfsserver \ op monitor OCF_CHECK_LEVEL="0" timeout="20s" interval="10s" SEE ALSOhttp://clusterlabs.org/AUTHORClusterLabs contributors (see the resource agent source for information about individual authors)
Visit the GSP FreeBSD Man Page Interface. |