Bug 1318719 - [DOC] NFS Ganesha : PCS authentication should be more descriptive
Summary: [DOC] NFS Ganesha : PCS authentication should be more descriptive
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Gluster Storage
Classification: Red Hat
Component: doc-Administration_Guide
Version: rhgs-3.1
Hardware: All
OS: Linux
unspecified
medium
Target Milestone: ---
: RHGS 3.1.2
Assignee: Bhavana
QA Contact: Ambarish
URL:
Whiteboard:
Depends On:
Blocks: 1329186
TreeView+ depends on / blocked
 
Reported: 2016-03-17 15:17 UTC by Ambarish
Modified: 2016-05-11 17:32 UTC (History)
11 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2016-05-11 17:32:05 UTC
Target Upstream Version:


Attachments (Terms of Use)

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.


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