This document is for a development version of Ceph.
CephFS namespaces can be exported over NFS protocol using the NFS-Ganesha NFS server.
Ceph file system
nfs-ganesha-cephpackages on NFS server host machine.
NFS-Ganesha server host connected to the Ceph public network
Ceph packages should preferably be latest stable luminous or a higher version and NFS-Ganesha packages must be v2.5 stable or higher versions.
Configuring NFS-Ganesha to export CephFS¶
NFS-Ganesha provides a File System Abstraction Layer (FSAL) to plug in different storage backends. FSAL_CEPH is the plugin FSAL for CephFS. For each NFS-Ganesha export, FSAL_CEPH uses a libcephfs client to mount the CephFS path that NFS-Ganesha exports.
Setting up NFS-Ganesha with CephFS, involves setting up NFS-Ganesha’s and Ceph’s configuration file and CephX access credentials for the Ceph clients created by NFS-Ganesha to access CephFS.
Here’s a sample ganesha.conf configured with FSAL_CEPH. It is suitable for a standalone NFS-Ganesha server, or an active/passive configuration of NFS-Ganesha servers, to be managed by some sort of clustering software (e.g., Pacemaker). Important details about the options are added as comments in the sample conf. There are options to do the following:
minimize Ganesha caching wherever possible since the libcephfs clients (of FSAL_CEPH) also cache aggressively
read from Ganesha config files stored in RADOS objects
store client recovery data in RADOS OMAP key-value interface
mandate NFSv4.1+ access
enable read delegations (need at least v13.0.1
libcephfs2package and v2.6.0 stable
Configuration for libcephfs clients¶
ceph.conf for libcephfs clients includes a
[client] section with
mon_host option set to let the clients connect to the Ceph cluster’s
monitors, usually generated via
ceph config generate-minimal-conf.
[client] mon host = [v2:192.168.1.7:3300,v1:192.168.1.7:6789], [v2:192.168.1.8:3300,v1:192.168.1.8:6789], [v2:192.168.1.9:3300,v1:192.168.1.9:6789]
Mount using NFSv4 clients¶
It is preferred to mount the NFS-Ganesha exports using NFSv4.1+ protocols to get the benefit of sessions.
Conventions for mounting NFS resources are platform-specific. The following conventions work on Linux and some Unix platforms:
mount -t nfs -o nfsvers=4.1,proto=tcp <ganesha-host-name>:<ganesha-pseudo-path> <mount-point>
Per running ganesha daemon, FSAL_CEPH can only export one Ceph file system although multiple directories in a Ceph file system may be exported.