Bug 1392003 - VIP assign contradiction in NFS ganesha documentation
Summary: VIP assign contradiction in NFS ganesha documentation
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Gluster Storage
Classification: Red Hat
Component: doc-Administration_Guide
Version: rhgs-3.1
Hardware: Unspecified
OS: Unspecified
unspecified
unspecified
Target Milestone: ---
: RHGS 3.2.0
Assignee: Bhavana
QA Contact: Manisha Saini
URL:
Whiteboard:
: 1392004 (view as bug list)
Depends On:
Blocks: 1351553
TreeView+ depends on / blocked
 
Reported: 2016-11-04 14:58 UTC by Chris Blum
Modified: 2017-03-24 10:24 UTC (History)
9 users (show)

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


Attachments (Terms of Use)

Description Chris Blum 2016-11-04 14:58:58 UTC
Document URL: 
https://access.redhat.com/documentation/en-US/Red_Hat_Storage/3.1/html/Administration_Guide/sect-NFS.html#sect-NFS_Ganesha

Section Number and Name: 
7.2.4.3. Highly Available Active-Active NFS-Ganesha

Describe the issue: 
The Note under the sample ganesha-ha.conf states:
"PCS handles the creation of the VIP and assigning a interface."

But down at 7.2.4.4.1. Prerequisites to run NFS-Ganesha
there is a point stating:
"Create multiple virtual IPs (VIPs) on the network for each of the servers configured in the ganesha-ha.conf file and assign them to any unused NIC."

This is a contradiction!

Comment 3 Rahul Hinduja 2016-11-14 09:36:13 UTC
*** Bug 1392004 has been marked as a duplicate of this bug. ***

Comment 5 Bhavana 2017-01-12 07:31:25 UTC
Hi Kaleb,

Can you please share your opinion regarding the contradictory content. Which of the sections should be edited/reworded ?

Thanks

Comment 6 Kaleb KEITHLEY 2017-02-08 10:49:29 UTC
   Section Number and Name: 
   7.2.4.3. Highly Available Active-Active NFS-Ganesha

   Describe the issue: 
   The Note under the sample ganesha-ha.conf states:
   "PCS handles the creation of the VIP and assigning a interface."

The above is correct, but change PCS to Pacemaker.


   But down at 7.2.4.4.1. Prerequisites to run NFS-Ganesha
   there is a point stating:
   "Create multiple virtual IPs (VIPs) on the network for each of the servers 
   configured in the ganesha-ha.conf file and assign them to any unused NIC."

IMO, delete the "assign them to any unused NIC" part.

The prerequisite is: the the admin must obtain or reserve the IPs he or she wishes to used for the VIPs in the cluster. They must be different than the hosts' static IPs and not be used anywhere else in the cluster or in the subnet. The admin needs to pick the host that each is nominally assigned to and enter them in the ganesha-ha.conf file, e.g.:

  ...
  VIP_server1_lab_redhat_com="10.81.43.101"
  VIP_server2_lab_redhat_com="10.81.43.102"
  ...

Comment 7 Bhavana 2017-02-14 13:08:22 UTC
Hi Kaleb,

The Note in 7.2.4.3 is changed as suggested.

For the point in 7.2.4.4.1. Prerequisites to run NFS-Ganesha is changed to the following:

"Reserve virtual IPs on the network for each of the servers configured in the ganesha.conf file. Ensure that these IPs are different than the hosts' static IPs and are not used anywhere else in the trusted storage pool or in the subnet."

Let me know if this conveys the message.

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

Comment 8 Kaleb KEITHLEY 2017-02-20 01:59:55 UTC
Yes, IMO it conveys the message.

Comment 9 Bhavana 2017-02-20 05:54:58 UTC
Thanks Kaleb.

Moving the bug ON_QA

Comment 10 Manisha Saini 2017-03-07 13:37:50 UTC
Modified description looks good.Moving this bug to verified.

Comment 11 Rejy M Cyriac 2017-03-24 10:24:22 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.