Enabling the NFS feature

To use the NFS feature, it needs to be enabled in the cluster.

Before you begin

Ensure you have the following:
  • Fusion Data Foundation is installed and running in the openshift-storage namespace.
  • The Fusion Data Foundation installation includes a CephFilesystem.

Procedure

  • Run the following command to enable the NFS feature:
    oc --namespace openshift-storage patch storageclusters.ocs.openshift.io ocs-storagecluster --type merge --patch '{"spec": {"nfs":{"enable": true}}}'
  • Specify a custom NFS Ganesha server for NFS StorageClasses.

    You can optionally set externalEndpoint in StorageCluster.spec.nfs to define the externally resolvable IP address or DNS name of the NFS Ganesha server to be used by NFS StorageClass.

    Note: When configured, internal clients will also use this address instead of the default NFS service name.
    oc --namespace openshift-storage patch storageclusters.ocs.openshift.io ocs-storagecluster \
      --type=merge \
      --patch '{"spec":{"nfs":{"externalEndpoint":"<VALUE>"}}}'

What to do next

NFS installation and configuration is complete when the following conditions are met:
  • The CephNFS resource named ocs-storagecluster-cephnfs has a status of Ready.
  • Check all csi-nfsplugin-* pods are running:
    oc -n openshift-storage describe cephnfs ocs-storagecluster-cephnfs
    oc -n openshift-storage get pod | grep csi-nfsplugin
    Output has multiple pods. For example:
    csi-nfsplugin-47qwq                                          2/2     Running  0  10s
    csi-nfsplugin-77947                                          2/2     Running  0  10s
    csi-nfsplugin-ct2pm                                          2/2     Running  0  10s
    csi-nfsplugin-provisioner-f85b75fbb-2rm2w                    2/2     Running  0  10s
    csi-nfsplugin-provisioner-f85b75fbb-8nj5h                    2/2     Running  0  10s