Document URL: https://access.redhat.com/documentation/en-US/Red_Hat_Storage/3.1/html-single/Administration_Guide/index.html Section Number and Name: 7.3.3. NFS Ganesha Describe the issue: This bug is to track changes required for NFS-ganesha section in RHGS 3.2.0 release for eg., like: * Having a separate section for NFS-Ganesha * Document gDeploy support etc. Suggestions for improvement: Additional information:
Few of the corrections/additions needed are : 1) Either have separate sections for gluster-NFS and NFS-Ganesha (or) split 7.2. NFS into two major sections - gluster/NFS and NFS-Ganesha 2) In the section "7.2.4. NFS-Ganesha" 2a) 7.2.4.4.1. Prerequisites to run NFS-Ganesha: Few steps shall change with the shared_volume support being added for NFS-Ganesha config 2b) A new sub-section needs to be added on how to configure NFS-Ganesha using gDeploy 2c) Maybe re-arrangement of the existing sections (if needed).
Following changes will be required in 3.2: >>>>> "7.2.4.5. Modifying the HA cluster using the ganesha-ha.sh script" section: In add node, delete node and modify export section, the respective commands will be changed and /etc/ganesha will be replaced with complete shared volume path. >>>>> "7.2.4.3. Highly Available Active-Active NFS-Ganesha" section In "1. Creating the ganesha-ha.conf file" below lines must be removed from example # The gluster server from which to mount the shared data volume. HA_VOL_SERVER="server1" >>>>> In the start of section "7.2.4. NFS-Ganesha" Current line says "Red Hat Gluster Storage is supported with the community’s V2.3.1 stable release of NFS-Ganesha." which should be changed to: "Red Hat Gluster Storage is supported with the community’s V2.4 stable release of NFS-Ganesha." >>>>> In 7.2.4.4.1. Prerequisites to run NFS-Ganesha After shared volume prerequisite: Mention 2 new points: 1) Create a directory named "nfs-ganesha" under /var/run/gluster/shared_storage 2) Copy ganesha.conf and ganesha-ha.conf from /etc/ganesha to /var/run/gluster/shared_storage/nfs-ganesha >>>>> In "7.2.4.2. Supported Features of NFS-Ganesha" under "Dynamic Export of Volumes" remove the note
Hi Shashank, For the first bullet in comment 4, should /etc/ganesha be changed to /var/run/gluster/shared_storage/nfs-ganesha? Apart from the first bullet, I have incorporated all the other changes mentioned. Following is the updated link: http://ccs-jenkins.gsslab.brq.redhat.com:8080/job/doc-Red_Hat_Gluster_Storage-3.2-Administration_Guide-branch-master/lastSuccessfulBuild/artifact/tmp/en-US/html-single/index.html#sect-NFS_Ganesha Let me know if you have any further review comments. Thanks wrt comment 2 provided by Soumya: The rearranging of the sections is in progress and documenting how to configure NFS-Ganesha using gdeploy is taken care of in bug 1365761.
Yes Bhavna, for bullet 1: /etc/ganesha should be replaced with /var/run/gluster/shared_storage/nfs-ganesha. And rest of the changes looks good.
Updated the doc based on comment 6. http://ccs-jenkins.gsslab.brq.redhat.com:8080/job/doc-Red_Hat_Gluster_Storage-3.2-Administration_Guide-branch-bz-1348820-Updates-needed-for-NFS-Ganesha-section/lastSuccessfulBuild/artifact/tmp/en-US/html-single/index.html#sect-NFS_Ganesha
*** Bug 1365759 has been marked as a duplicate of this bug. ***
>>>>> In "7.2.4.2. Supported Features of NFS-Ganesha" under "Dynamic Export of Volumes" the note has to be added again. >>>>> In the start of section "7.2.4. NFS-Ganesha" Current line says "Red Hat Gluster Storage is supported with the community’s V2.3.1 stable release of NFS-Ganesha." which should be changed to: "Red Hat Gluster Storage is supported with the community’s V2.4.1 stable release of NFS-Ganesha." Please update the doc with above changes.
Hi Surabhi, I have made the additional changes as suggested in comment 9. http://ccs-jenkins.gsslab.brq.redhat.com:8080/job/doc-Red_Hat_Gluster_Storage-3.2-Administration_Guide-branch-master/lastSuccessfulBuild/artifact/tmp/en-US/html-single/index.html#sect-NFS_Ganesha
Verified the content. Doc updates for ganesha section looks good. Marking the BZ verified.
RHGS 3.2.0 GA completed on 23 March 2017