Chapter 8. Managing NFS Ganesha exports on the Ceph dashboard

Procedure

1. Log into the Cephadm shell:

   Example

   [root@host01 ~]# cephadm shell

2. Create the RADOS pool, namespace, and enable rgw:

   Syntax

   ceph osd pool create POOL_NAME _
   ceph osd pool application enable POOL_NAME freeform/rgw/rbd/cephfs/nfs

   Example

   [ceph: root@host01 /]# ceph osd pool create nfs-ganesha
   [ceph: root@host01 /]# ceph osd pool application enable nfs-ganesha rgw

3. Deploy NFS-Ganesha gateway using placement specification in the command line interface:

   Syntax

   ceph orch apply nfs SERVICE_ID --placement="NUMBER_OF_DAEMONS HOST_NAME_1 HOST_NAME_2 HOST_NAME_3"

   Example

   [ceph: root@host01 /]# ceph orch apply nfs foo --placement="2 host01 host02"

   This deploys an NFS-Ganesha cluster nfsganesha with one daemon on host01 and host02.

4. Update ganesha-clusters-rados-pool-namespace parameter with the namespace and the service_ID:

   Syntax

   ceph dashboard set-ganesha-clusters-rados-pool-namespace POOL_NAME/SERVICE_ID

   Example

   [ceph: root@host01 /]# ceph dashboard set-ganesha-clusters-rados-pool-namespace nfs-ganesha/foo

5. From the dashboard navigation, go to File→NFS.
6. Click Create.

7. In the Create NFS export form, set the following parameters and click Create NFS export:

   1. Cluster - Name of the cluster.
   2. Daemons - You can select all daemons.
   3. Storage Backend - You can select Object Gateway.
   4. Object Gateway User - Select the user created. In this example, it is test_user.
   5. Path - Any directory.
   6. NFS Protocol - NFSv4 is selected by default.
   7. Pseudo - root path
   8. Access Type - The supported access types are RO, RW, and NONE.
   9. Squash
   10. Transport Protocol

   11. Clients

       

8. Verify the NFS daemon is configured:

   Example

   [ceph: root@host01 /]# ceph -s

9. As a root user, check if the NFS-service is active and running:

   Example

   [root@host01 ~]# systemctl list-units | grep nfs

10. Mount the NFS export and perform a few I/O operations.
11. Once the NFS service is up and running, in the NFS-RGW container, comment out the dir_chunk=0 parameter in etc/ganesha/ganesha.conf file. Restart the NFS-Ganesha service. This allows proper listing at the NFS mount.

Procedure

1. Log in to the cephadm shell:

   Example

   [root@host01 ~]# cephadm shell

2. Create the CephFS storage in the backend:

   Syntax

   ceph fs volume create CEPH_FILE_SYSTEM

   Example

   [ceph: root@host01 /]# ceph fs volume create cephfs

3. Enable the Ceph Manager NFS module:

   Example

   [ceph: root@host01 /]# ceph mgr module enable nfs

4. Create an NFS Ganesha cluster:

   Syntax

   ceph nfs cluster create NFS_CLUSTER_NAME "HOST_NAME_PLACEMENT_LIST"

   Example

   [ceph: root@host01 /]# ceph nfs cluster create nfs-cephfs host02
   NFS Cluster Created Successfully

5. Get the dashboard URL:

   Example

   [ceph: root@host01 /]# ceph mgr services
   {
       "dashboard": "https://10.00.00.11:8443/",
       "prometheus": "http://10.00.00.11:9283/"
   }

6. Log in to the Ceph dashboard with your credentials.
7. On the dashboard landing page, click NFS.
8. Click Create.

9. In the Create NFS export window, set the following parameters and click Create NFS export:

   1. Cluster - Name of the cluster.
   2. Daemons - You can select all daemons.
   3. Storage Backend - You can select CephFS.
   4. CephFS User ID - Select the service where the NFS cluster is created.
   5. CephFS Name - Provide a user name.
   6. CephFs Path - Any directory.
   7. NFS Protocol - NFSv4 is selected by default.
   8. Pseudo - root path
   9. Access Type - The supported access types are RO, RW, and NONE.
   10. Squash - Select the squash type.
   11. Transport Protocol - Select either the UDP or TCP protocol.

   12. Clients

       Figure 8.1. CephFS NFS export window

       

10. As a root user on the client host, create a directory and mount the NFS export:

    Syntax

    mkdir -p /mnt/nfs/
    mount -t nfs -o port=2049 HOSTNAME:EXPORT_NAME _MOUNT_DIRECTORY_

    Example

    [root@ client ~]# mkdir -p /mnt/nfs/
    [root@ client ~]# mount -t nfs -o port=2049 host02:/export1 /mnt/nfs/

Procedure

1. From the dashboard navigation, go to Object NFS.
2. Select the row that needs to be edited. and click Edit.
3. In the Edit NFS export window, edit the required parameters.

4. Complete by clicking Edit NFS export.

   A notification displays that the NFS object was updated successfully.

   

Procedure

1. From the dashboard navigation, go to File→NFS.
2. Select the row that needs to be deleted and click Delete from the action drop-down.

3. In the Delete NFS export notification, select Yes, I am sure and click Delete NFS export.