Bug 1318719

Summary: [DOC] NFS Ganesha : PCS authentication should be more descriptive
Product: Red Hat Gluster Storage Reporter: Ambarish <asoman>
Component: doc-Administration_GuideAssignee: Bhavana <bmohanra>
doc-Administration_Guide sub component: Default QA Contact: Ambarish <asoman>
Status: CLOSED CURRENTRELEASE Docs Contact:
Severity: medium    
Priority: unspecified CC: asoman, asriram, asrivast, bmohanra, bturner, mhideo, nlevinki, rcyriac, rhs-bugs, rwheeler, storage-doc
Version: rhgs-3.1Keywords: ZStream
Target Milestone: ---   
Target Release: RHGS 3.1.2   
Hardware: All   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2016-05-11 17:32:05 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: 1329186    

Description Ambarish 2016-03-17 15:17:18 UTC
Document URL: 

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

Section Number and Name: 

7.2.3.3. Configuring NFS-Ganesha using Gluster CLI

Describe the issue: 

Creating a username/password for PCS auth is missing in the doc :

Eg :echo demopass | passwd --stdin hacluster

Moreover,incase of more than one node,the doc should clearly mention that the the nodenames should be a space separated list.

Eg : pcs cluster auth dhcp37-67.lab.eng.blr.redhat.com dhcp37-144.lab.eng.blr.redhat.com

Suggestions for improvement: 

Modify the doc with the above changes.

Additional information:

Comment 1 Bhavana 2016-04-19 10:48:01 UTC
Hi Ambarish,

An additional bullet point is added in section "7.2.3.3.1. Prerequisites to run NFS-Ganesha"


http://jenkinscat.gsslab.pnq.redhat.com:8080/job/doc-Red_Hat_Gluster_Storage-3.1-3.1.2-Stage_Administration_Guide%20%28html-single%29/lastSuccessfulBuild/artifact/tmp/en-US/html-single/index.html#sect-NFS_Ganesha

-----------------------------------------------------------------------

 Set a password for the user ‘hacluster’ on all the nodes using the following command. Use the same password for all the nodes:

# echo <password> | passwd --stdin hacluster

Perform cluster authentication between the nodes, where, username is ‘hacluster’, and password is the one you used in the previous step. Ensure to execute the following command on each of the nodes:

# pcs cluster auth <hostname1> <hostname2> ...

Note
The hostname of all the nodes in the Ganesha-HA cluster must be included in the command when executing it on every node.

For example, in a four node cluster; nfs1, nfs2, nfs3, and nfs4, execute the following command on every node:

# pcs cluster auth nfs1 nfs2 nfs3 nfs4
Username: hacluster
Password:
nfs1: Authorized
nfs2: Authorized
nfs3: Authorized
nfs4: Authorized

-------------------------------------------------------------------------

Let me know if this addresses the issue, including your comment about making it clear in the doc that the nodenames should be a space separated list.

Comment 2 Ambarish 2016-04-19 10:56:58 UTC
Yep Bhavana(In reply to Bhavana from comment #1)
> Hi Ambarish,
> 
> An additional bullet point is added in section "7.2.3.3.1. Prerequisites to
> run NFS-Ganesha"
> 
> 
> http://jenkinscat.gsslab.pnq.redhat.com:8080/job/doc-Red_Hat_Gluster_Storage-
> 3.1-3.1.2-Stage_Administration_Guide%20%28html-single%29/lastSuccessfulBuild/
> artifact/tmp/en-US/html-single/index.html#sect-NFS_Ganesha
> 
> -----------------------------------------------------------------------
> 
>  Set a password for the user ‘hacluster’ on all the nodes using the
> following command. Use the same password for all the nodes:
> 
> # echo <password> | passwd --stdin hacluster
> 
> Perform cluster authentication between the nodes, where, username is
> ‘hacluster’, and password is the one you used in the previous step. Ensure
> to execute the following command on each of the nodes:
> 
> # pcs cluster auth <hostname1> <hostname2> ...
> 
> Note
> The hostname of all the nodes in the Ganesha-HA cluster must be included in
> the command when executing it on every node.
> 
> For example, in a four node cluster; nfs1, nfs2, nfs3, and nfs4, execute the
> following command on every node:
> 
> # pcs cluster auth nfs1 nfs2 nfs3 nfs4
> Username: hacluster
> Password:
> nfs1: Authorized
> nfs2: Authorized
> nfs3: Authorized
> nfs4: Authorized
> 
> -------------------------------------------------------------------------
> 
> Let me know if this addresses the issue, including your comment about making
> it clear in the doc that the nodenames should be a space separated list.

Yep Bhavana..This certainly addresses the problem I had with the documented steps in a very clear way.
Thanks!

Comment 3 Bhavana 2016-04-25 12:46:54 UTC
Thankyou.

Moving to on_qa

Comment 5 Ambarish 2016-04-26 14:32:31 UTC
Look OK.
Verified.