Chapter 8. Management of 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. On the dashboard landing page, click NFS.
6. Select Create.

7. 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 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. On the dashboard, click NFS.
2. Click the row that needs to be edited.
3. From the Edit drop-down menu, click Edit.

4. In the Edit NFS export window, edit the required parameters and click Edit NFS export.

   

Procedure

1. On the dashboard, click NFS.
2. Click the row that needs to be delete.
3. From the Edit drop-down menu, click Delete.

4. In the Delete NFS export dialog box, check Yes, I am sure and click Delete NFS export.

   

Procedure

1. On the dashboard, click Cluster.
2. From the Cluster drop-down menu, click Services.
3. Click + Create.
4. In the Create Service window, select ingress service.

5. Select the required backend service, edit the required parameters, and click Create Service to upgrade.

   Figure 8.2. Create Service window