Bug 1796971 - [GSS] Mistakes/Additions to Deployment Guide
Summary: [GSS] Mistakes/Additions to Deployment Guide
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Gluster Storage
Classification: Red Hat Storage
Component: doc-Deploying_RHHI
Version: rhhiv-1.6
Hardware: x86_64
OS: Linux
low
low
Target Milestone: ---
: RHHI-V 1.7.z Async Update
Assignee: Laura Bailey
QA Contact: SATHEESARAN
URL:
Whiteboard:
Depends On:
Blocks: 1804071
TreeView+ depends on / blocked
 
Reported: 2020-01-31 16:05 UTC by Cal Calhoun
Modified: 2023-03-24 16:55 UTC (History)
4 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
: 1805093 (view as bug list)
Environment:
Last Closed: 2020-02-26 08:05:55 UTC
Embargoed:


Attachments (Terms of Use)

Description Cal Calhoun 2020-01-31 16:05:36 UTC
Description of problem:

  There are a few omissions/mistakes in the doc.

Version-Release number of selected component (if applicable):

  RHHI-V 1.6

Additional info:

  1. chapter 5.1.1 , section 8

  It would be awesome to have either a description or a link to manual configuration.  This point is so important for a proper cluster, that it should be a little bit more explanatory.

  2. chapter 7, Device, Code Example

  the content is:
  ---
  [root@ ~]# cat /etc/multipath/conf.d/99-custom-multipath.conf
  blacklist {
    devnodes "sdb"
  }
  ---

  but must be:
  ---
  [root@ ~]# cat /etc/multipath/conf.d/99-custom-multipath.conf
  blacklist {
    devnode "sdb"
  }
  ---

  3. Chapter 8, section 3 (virtual management details)

  A link should be included for a guide to configure this afterwards.

Comment 2 SATHEESARAN 2020-02-03 10:44:28 UTC
This looks important details to be fixed in the document, providing qa_ack to be fixed in RHHI-V 1.7

Comment 3 SATHEESARAN 2020-02-10 11:58:14 UTC
(In reply to Cal Calhoun from comment #0)
> Description of problem:
> 
>   There are a few omissions/mistakes in the doc.
> 
> Version-Release number of selected component (if applicable):
> 
>   RHHI-V 1.6
> 
> Additional info:
> 
>   1. chapter 5.1.1 , section 8
> 
>   It would be awesome to have either a description or a link to manual
> configuration.  This point is so important for a proper cluster, that it
> should be a little bit more explanatory.

You mean the 'Static IP configuration". Could you explain more ?
> 
>   2. chapter 7, Device, Code Example
> 
>   the content is:
>   ---
>   [root@ ~]# cat /etc/multipath/conf.d/99-custom-multipath.conf
>   blacklist {
>     devnodes "sdb"
>   }
>   ---
> 
>   but must be:
>   ---
>   [root@ ~]# cat /etc/multipath/conf.d/99-custom-multipath.conf
>   blacklist {
>     devnode "sdb"
>   }
>   ---
> 
This can be fixed

>   3. Chapter 8, section 3 (virtual management details)
> 
>   A link should be included for a guide to configure this afterwards.

You mean configuration engine notifications post deployment ?

Comment 4 Cal Calhoun 2020-02-19 13:56:02 UTC
Here is the feedback from the customer:

--> You mean the 'Static IP configuration". Could you explain more ?

Afaik, RHHI needs two dedicated interfaces to function properly. A picture, explaining this a bit better or at least some lines of text how one should configure the network properly would be nice.

I think most of the engineers will create a bnd, if they see 2 dedicated interfaces, if not stated otherwise. Therefore it should be made clear, that a bond is not needed, if only 2 interfaces are present.

--> You mean configuration engine notifications post deployment?

Exactly, if one is not able to configure notifications at this point, there should be a link or explanation how this can be done POST deployment.

Thanks again for your support. I am always impressed of the speed, expertise and time you at RedHat are investing in my cases.


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