blob: da23d6f63a919a0d9eb5ad9241ca7f42adb7daa5 [file] [log] [blame]
Notes about systemd unit files for nfs-utils.
The unit files provided here should be sufficient for systemd
to manage all daemons and related services provides by nfs-utils.
They do *not* include any unit files for separate services such as
rpc.rquotad (in the 'quota' package) or rpcbind.
There are 4 units that can be 'enabled' or 'disabled' by systemctl, or
by a suitable 'preset' setting:
If enabled, nfs service is started together with dependencies
such as mountd, statd, rpc.idmapd
This is a "service" file rather than a "target" (which is the
normal grouping construct) so that
systemctl start nfs-server
can work (if no type is given, ".service" is assumed).
If enabled, daemons needed for an nfs client are enabled.
This does *not* include rpc.statd. The rpc-statd.service unit
is started by /usr/sbin/start-statd which mount.nfs will run
if statd is needed.
If enabled, then blkmapd will be run when is
Another special unit is "nfs-utils.service". This doesn't really do
anything, but exists so that other units may declare themselves as
"PartOf" nfs-utils.service.
The effect of this is that
systemctl restart nfs-utils
will restart all nfs-utils daemons as maybe be required during
software update. It isn't possible to make
systemctl try-restart nfs-server
do this as some daemon are included in both, and rpc.statd would
not be restarted if nfs-server were not active (as nfs-client doesn't
Want it - it is started by mount.nfs running start-statd).
It is possible that we should have an which can
selectively enable statd being stared by -server and sm-notify
being started by -server or -client. That way it could be disabled
completely on V4-only configurations. Currently statd is always
started on the server and sm-notify is always run if server or
client is enabled.
Stopping nfs-server will also stop rpc.mountd, and rpc.svcgssd.
It cannot stop rpc.statd or rpc.gssd as they may be in use by the
client and systemd cannot specify is two-pronged reverse dependency.
(i.e. stop this unit if none of these units are running)
Distro specific configuration can be included in /etc/nfs.conf, or
by providing drop-in files which replace the ExecStart line for a given
service, and possibly add an EnvironmentFile line.
For example, if systemd/system/nfs-mountd.service.d/local.conf
ExecStart=/usr/sbin/rpc.mountd $RPCMOUNTDOPTS
then the setting of RPCMOUNTDOPTS in /etc/sysconfig/nfs would be
passed to rpc.mountd.
rpc.gssd and rpc.svcgssd are assumed to be needed if /etc/krb5.keytab
is present.
If a site needs this file present but does not want the gss daemons
running, it should create