From 961119090cd352d585b27ad658698bbef92db39a Mon Sep 17 00:00:00 2001 From: Konrad Bucheli Date: Mon, 29 Apr 2024 14:06:35 +0200 Subject: [PATCH] document NFS server setup --- admin-guide/configuration/nfs_server.md | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/admin-guide/configuration/nfs_server.md b/admin-guide/configuration/nfs_server.md index 6ea5491e..1ec9db71 100644 --- a/admin-guide/configuration/nfs_server.md +++ b/admin-guide/configuration/nfs_server.md @@ -1,6 +1,7 @@ # NFS Server -Your node can serve as NTP server. +Your node can serve as NFS server. This guide is for RHEL8 and later. +By default RHEL8 serves NFS3 und NFS4, whereas RHEL9 and later will server only NFS4. Still NFS3 can be configured if required. To enable the NFS server, set `base::enable_nfs_server` accordingly in Hiera: ``` @@ -19,6 +20,9 @@ Then the exports go below `nfs_server::exports`: - hosts: 'sf-export-1[2-3]-100g' options: 'rw,async,no_root_squash' ``` +For each directory you want to export place its path as key. Below you can set the global options in `options` and a list of client specific access restrictions and options below `clients`. + +Possible client host definitions and options you find in [`exports(5)`](https://man7.org/linux/man-pages/man5/exports.5.html). If you wish non-standard configuration in `/etc/nfs.conf`, you may set it in Hiera with key `nfs_server::nfs_conf`: @@ -28,5 +32,6 @@ nfs_server::nfs_conf: udp: 'y' vers3: 'n' ``` +For more details see [`nfs.conf(5)`](https://man7.org/linux/man-pages/man5/nfs.conf.5.html) -If you need/want to provide Kerberos authenticated access, please speak to the Core Linux Team. +If you need/want to provide Kerberos authenticated access, please speak to the Core Linux Team as we need to add support for it to Puppet first.