1OCF_HEARTBEAT_NFSSER(7)       OCF resource agents      OCF_HEARTBEAT_NFSSER(7)
2
3
4

NAME

6       ocf_heartbeat_nfsserver - Manages an NFS server
7

SYNOPSIS

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

DESCRIPTION

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

SUPPORTED PARAMETERS

17       nfs_init_script
18           The default init script shipped with the Linux distro. The
19           nfsserver resource agent offloads the start/stop/monitor work to
20           the init script because the procedure to start/stop/monitor
21           nfsserver varies on different Linux distro. In the event that this
22           option is not set, this agent will attempt to use an init script at
23           this location, /etc/init.d/nfsserver, or detect a systemd unit-file
24           to use in the event that no init script is detected.
25
26           (optional, string, default "auto detected")
27
28       nfs_no_notify
29           Do not send reboot notifications to NFSv3 clients during server
30           startup.
31
32           (optional, boolean, default false)
33
34       nfs_notify_foreground
35           Keeps the sm-notify attached to its controlling terminal and
36           running in the foreground.
37
38           (optional, boolean, default false)
39
40       nfs_smnotify_retry_time
41           Specifies the length of sm-notify retry time, in minutes, to
42           continue retrying notifications to unresponsive hosts. If this
43           option is not specified, sm-notify attempts to send notifications
44           for 15 minutes. Specifying a value of 0 causes sm-notify to
45           continue sending notifications to unresponsive peers until it is
46           manually killed.
47
48           (optional, integer, no default)
49
50       nfs_ip
51           Comma separated list of floating IP addresses used to access the
52           nfs service
53
54           (optional, string, no default)
55
56       nfs_shared_infodir
57           The nfsserver resource agent will save nfs related information in
58           this specific directory. And this directory must be able to
59           fail-over before nfsserver itself.
60
61           (optional, string, no default)
62
63       rpcpipefs_dir
64           The mount point for the sunrpc file system. Default is
65           /var/lib/nfs/rpc_pipefs. This script will mount (bind)
66           nfs_shared_infodir on /var/lib/nfs/ (cannot be changed), and this
67           script will mount the sunrpc file system on /var/lib/nfs/rpc_pipefs
68           (default, can be changed by this parameter). If you want to move
69           only rpc_pipefs/ (e.g. to keep rpc_pipefs/ local) from default,
70           please set this value.
71
72           (optional, string, default "/var/lib/nfs/rpc_pipefs")
73
74       nfsd_args
75           Specifies what arguments to pass to the nfs daemon on startup. View
76           the rpc.nfsd man page for information on what arguments are
77           available. Note that setting this value will override all settings
78           placed in the local /etc/sysconfig/nfs file.
79
80           (optional, string, no default)
81
82       lockd_udp_port
83           The udp port lockd should listen on. Note that setting this value
84           will override all settings placed in the local /etc/sysconfig/nfs
85           file.
86
87           (optional, integer, no default)
88
89       lockd_tcp_port
90           The tcp port lockd should listen on. Note that setting this value
91           will override all settings placed in the local /etc/sysconfig/nfs
92           file.
93
94           (optional, integer, no default)
95
96       statd_outgoing_port
97           The source port number sm-notify uses when sending reboot
98           notifications. Note that setting this value will override all
99           settings placed in the local /etc/sysconfig/nfs file.
100
101           (optional, integer, no default)
102
103       statd_port
104           The port number used for RPC listener sockets. Note that setting
105           this value will override all settings placed in the local
106           /etc/sysconfig/nfs file.
107
108           (optional, integer, no default)
109
110       mountd_port
111           The port number used for rpc.mountd listener sockets. Note that
112           setting this value will override all settings placed in the local
113           /etc/sysconfig/nfs file.
114
115           (optional, integer, no default)
116
117       rquotad_port
118           The port number used for rpc.rquotad. Note that setting this value
119           will override all settings placed in the local /etc/sysconfig/nfs
120           file.
121
122           (optional, integer, no default)
123

SUPPORTED ACTIONS

125       This resource agent supports the following actions (operations):
126
127       start
128           Starts the resource. Suggested minimum timeout: 40s.
129
130       stop
131           Stops the resource. Suggested minimum timeout: 20s.
132
133       monitor
134           Performs a detailed status check. Suggested minimum timeout: 20s.
135           Suggested interval: 10s.
136
137       meta-data
138           Retrieves resource agent metadata (internal use only). Suggested
139           minimum timeout: 5s.
140
141       validate-all
142           Performs a validation of the resource configuration. Suggested
143           minimum timeout: 30s.
144

EXAMPLE CRM SHELL

146       The following is an example configuration for a nfsserver resource
147       using the crm(8) shell:
148
149           primitive p_nfsserver ocf:heartbeat:nfsserver \
150             op monitor depth="0" timeout="20s" interval="10s"
151

EXAMPLE PCS

153       The following is an example configuration for a nfsserver resource
154       using pcs(8)
155
156           pcs resource create p_nfsserver ocf:heartbeat:nfsserver \
157             op monitor depth="0" timeout="20s" interval="10s"
158

SEE ALSO

160       http://clusterlabs.org/
161

AUTHOR

163       ClusterLabs contributors (see the resource agent source for information
164       about individual authors)
165
166
167
168resource-agents UNKNOWN           10/23/2019           OCF_HEARTBEAT_NFSSER(7)
Impressum