Bug 1348820

Summary: [Doc RFE] Updates needed for NFS-Ganesha section in 3.2.0
Product: [Red Hat Storage] Red Hat Gluster Storage Reporter: Soumya Koduri <skoduri>
Component: doc-Administration_GuideAssignee: Bhavana <bmohanra>
doc-Administration_Guide sub component: Default QA Contact: surabhi <sbhaloth>
Status: CLOSED CURRENTRELEASE Docs Contact:
Severity: medium    
Priority: unspecified CC: asriram, asrivast, bmohanra, jthottan, kkeithle, mhideo, mzywusko, ndevos, nlevinki, rcyriac, rhinduja, rhs-bugs, rwheeler, storage-doc
Version: unspecifiedKeywords: FutureFeature
Target Milestone: ---   
Target Release: RHGS 3.2.0   
Hardware: All   
OS: All   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2017-03-24 10:18:48 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Bug Depends On: 1374150, 1374605    
Bug Blocks: 135159, 1351546, 1351549    

Description Soumya Koduri 2016-06-22 07:32:02 UTC
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:

Comment 2 Soumya Koduri 2016-08-09 09:28:37 UTC
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).

Comment 4 Shashank Raj 2016-08-30 10:49:14 UTC
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

Comment 5 Bhavana 2016-10-25 05:53:24 UTC
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.

Comment 6 Shashank Raj 2016-10-25 08:46:42 UTC
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.

Comment 8 Anjana Suparna Sriram 2016-11-28 12:52:05 UTC
*** Bug 1365759 has been marked as a duplicate of this bug. ***

Comment 9 surabhi 2017-02-08 08:48:01 UTC
>>>>> 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.

Comment 11 surabhi 2017-02-10 07:38:23 UTC
Verified the content. Doc updates for ganesha section looks good.
Marking the BZ verified.

Comment 12 Rejy M Cyriac 2017-03-24 10:18:48 UTC
RHGS 3.2.0 GA completed on 23 March 2017

Comment 13 Rejy M Cyriac 2017-03-24 10:20:19 UTC
RHGS 3.2.0 GA completed on 23 March 2017