Bug 1348820 - [Doc RFE] Updates needed for NFS-Ganesha section in 3.2.0
Summary: [Doc RFE] Updates needed for NFS-Ganesha section in 3.2.0
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Gluster Storage
Classification: Red Hat Storage
Component: doc-Administration_Guide
Version: unspecified
Hardware: All
OS: All
unspecified
medium
Target Milestone: ---
: RHGS 3.2.0
Assignee: Bhavana
QA Contact: surabhi
URL:
Whiteboard:
: 1365759 (view as bug list)
Depends On: 1374150 1374605
Blocks: 135159 1351546 1351549
TreeView+ depends on / blocked
 
Reported: 2016-06-22 07:32 UTC by Soumya Koduri
Modified: 2017-03-24 10:20 UTC (History)
14 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2017-03-24 10:18:48 UTC
Embargoed:


Attachments (Terms of Use)

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


Note You need to log in before you can comment on or make changes to this bug.