Bug 1318119

Summary: [Doc RFE] Provide steps to setup gluster-NFS cluster using CTDB
Product: Red Hat Gluster Storage Reporter: Soumya Koduri <skoduri>
Component: doc-Administration_GuideAssignee: Bhavana <bmohanra>
doc-Administration_Guide sub component: Default QA Contact: Shashank Raj <sraj>
Status: CLOSED CURRENTRELEASE Docs Contact:
Severity: high    
Priority: unspecified CC: akhakhar, asriram, jthottan, kkeithle, mhideo, ndevos, nlevinki, olim, rcyriac, rhinduja, rhs-bugs, rtalur, rwheeler, sashinde, sbhaloth, skoduri, sraj, storage-doc
Version: rhgs-3.1Keywords: Documentation, FutureFeature, ZStream
Target Milestone: ---   
Target Release: RHGS 3.1.3   
Hardware: All   
OS: All   
Whiteboard:
Fixed In Version: Doc Type: Enhancement
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2016-06-29 14:19:50 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:
Bug Depends On:    
Bug Blocks: 1310215, 1311845    

Description Soumya Koduri 2016-03-16 06:53:49 UTC
Document URL: 
https://access.redhat.com/documentation/en-US/Red_Hat_Storage/3.1/html/Administration_Guide/sect-NFS.html

Section Number and Name: 
7.2 NFS

Describe the issue: 
We need to document steps needed to setup gluster-NFS server using CTDB.

Suggestions for improvement: 

Additional information:

Comment 3 Bhavana 2016-04-11 07:12:27 UTC
Hi Soumya,

Can you please share the steps to setup gluster-NFS server using CTDB. If the steps are documented in any kbase articles / google docs you could share too for me to begin the documentation process.

Comment 4 Soumya Koduri 2016-04-11 07:24:29 UTC
I have never done the CTDB setup before. I request Niels to provide the notes.

Comment 5 Niels de Vos 2016-04-11 08:22:47 UTC
Please see the documentation for RHGS-2.1:

  9.5. Configuring Automated IP Failover for NFS and SMB

  https://access.redhat.com/documentation/en-US/Red_Hat_Storage/2.1/html-single/Administration_Guide/index.html#sect-Configuring_Automated_IP_Failover_for_NFS_and_SMB

Comment 6 Bhavana 2016-05-11 09:04:13 UTC
Hello Niels,

The Section 9.5.2. Starting and Verifying your Configuration, has more SMB specific steps. Can you please share the steps that are more relevant to NFS?

https://access.redhat.com/documentation/en-US/Red_Hat_Storage/2.1/html-single/Administration_Guide/index.html#sect-Configuring_Automated_IP_Failover_for_NFS_and_SMB

Also, do I need to make any changes to Section 9.5.1. Setting Up CTDB, or are the same steps relevant to RHGS 3.1 too ?

Thanks,
Bhavana

Comment 7 Niels de Vos 2016-05-12 06:15:34 UTC
(In reply to Bhavana from comment #6)
> Hello Niels,
> 
> The Section 9.5.2. Starting and Verifying your Configuration, has more SMB
> specific steps. Can you please share the steps that are more relevant to NFS?
> 
> https://access.redhat.com/documentation/en-US/Red_Hat_Storage/2.1/html-
> single/Administration_Guide/index.html#sect-
> Configuring_Automated_IP_Failover_for_NFS_and_SMB
> 
> Also, do I need to make any changes to Section 9.5.1. Setting Up CTDB, or
> are the same steps relevant to RHGS 3.1 too ?

The basic CTDB configuration is the same for Samba and NFS. If those are the steps discussed with the Samba team, I don't have any objections.

Thanks!

Comment 8 Bhavana 2016-05-12 07:20:33 UTC
Hello Talur,

We are adding a section in the NFS chapter about setting up gluster-NFS cluster using CTDB.

Niels and I would want to check with you if the steps mentioned under Section 9.5.1. Setting Up CTDB (this was in the RHS 2.1 doc) are relevant now (RHGS 3.1) or are there any changes to these steps, wrt version numbers etc ?

RHS 2.1 Admin Guide: https://access.redhat.com/documentation/en-US/Red_Hat_Storage/2.1/html-single/Administration_Guide/index.html#sect-Configuring_Automated_IP_Failover_for_NFS_and_SMB

Comment 9 Raghavendra Talur 2016-05-12 07:33:52 UTC
Refering to https://access.redhat.com/documentation/en-US/Red_Hat_Storage/3.1/html/Administration_Guide/sect-SMB.html#idp11726848 

You can use section 7.3.1. Setting up CTDB for Samba as template and have a new section 7.2.1 in NFS as Setting up CTDB for NFS. Some of the changes would be

1. Replace Samba with NFS in all points.
2. Step 3 
In the /etc/samba/smb.conf file add the following line in the global section on all the nodes:
is not relevant but you should have some equivalent of it for NFS.


You might find https://ctdb.samba.org/nfs.html useful when writing NFS specific points.

Comment 10 Bhavana 2016-05-13 09:10:54 UTC
Thanks Talur!

Hi Niels,

I have added a new section 7.2.1. Setting up CTDB for NFS in the administration guide.

http://jenkinscat.gsslab.pnq.redhat.com:8080/view/Gluster/job/doc-Red_Hat_Gluster_Storage-3.1.3-Administration_Guide%20%28html-single%29/lastBuild/artifact/tmp/en-US/html-single/index.html#idm140442587255728

As talur suggested, i have removed step 3 from the procedure. Let me know if there is any alternate step for NFS.

Also, do let me know if there are any other changes required for this section.

Thanks,
Bhavana

Comment 11 Niels de Vos 2016-05-13 09:39:58 UTC
Looks good to me, I do not think there are any further changes needed. Thanks!

Comment 12 Bhavana 2016-05-16 05:58:51 UTC
Thanks Niels.


Moving the bug on_qa

Comment 13 Oonkwee Lim_ 2016-05-20 02:28:20 UTC
*** Bug 1280021 has been marked as a duplicate of this bug. ***

Comment 14 surabhi 2016-06-06 11:23:10 UTC
Bhavana,

I still see lots of reference given to samba servers in NFS setup section which may create confusion. 
Action:
Remove references to samba servers in ctdb with nfs setup.

Comment 16 surabhi 2016-06-08 14:43:18 UTC
The doc looks good now. Moving to verified.