Bug 1566250

Summary: [Docs] Configuring RHV with Gluster refers to incompatible documentation
Product: [Red Hat Storage] Red Hat Gluster Storage Reporter: Thom Carlin <tcarlin>
Component: doc-Configuring_Red_Hat_Enterprise_Virtualization_with_RHGSAssignee: storage-doc
Status: CLOSED WONTFIX QA Contact: storage-qa-internal <storage-qa-internal>
Severity: medium Docs Contact:
Priority: unspecified    
Version: rhgs-3.3CC: agantony, asriram, bkunal, jroberts, sasundar, tcarlin
Target Milestone: ---Keywords: ZStream
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2020-04-14 12:37:16 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:
Embargoed:
Bug Depends On:    
Bug Blocks: 1724792    

Description Thom Carlin 2018-04-11 20:40:43 UTC
Description of problem:

Section 2.2 refers to https://access.redhat.com/articles/2356261 which currently lists 4.0 as the minimum RHV version compatible with Gluster 3.3 (in RHGS and Red Hat Virtualization Compatibility Version table).
However, the documentation references RHV 3.x and 3.x documentation


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

3.3

How reproducible:

100%

Steps to Reproduce:
1. Examine Title
2. Examine Section 3.1
2. Examine Section 5.7
3.

Actual results:

1. "Getting Started with Red Hat Gluster Storage 3.3 and Red Hat Virtualization 3.4 or later"
2. "See Installing the Red Hat Virtualization Manager in the Red Hat Virtualization Installation Guide for more information: https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.6/html/Installation_Guide/part-Installing_Red_Hat_Enterprise_Virtualization.html."
[...]
"Red Hat Virtualization Hypervisor 3.4
Red Hat Enterprise Linux 6.3
Red Hat Enterprise Linux 6.4
Red Hat Enterprise Linux 6.5"
[...]
"For information on installing the hypervisor, see Installing Hypervisor Hosts in the Red Hat Virtualization Installation Guide: https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.6/html/Installation_Guide/part-Installing_Hypervisor_Hosts.html."
[...]
"You must install Red Hat Enterprise Linux 6.3, Red Hat Enterprise Linux 6.4 Server or Red Hat Enterprise Linux 6.5 on a system to use it as a virtualization host in a Red Hat Virtualization environment. See Installing Red Hat Enterprise Linux Hosts in the Red Hat Virtualization Installation Guide for details: https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.6/html/Installation_Guide/chap-Red_Hat_Enterprise_Linux_Hosts.html."
[...]
"Red Hat Enterprise Linux hosts need to be registered and subscribed to a number of entitlements using either Subscription Manager or Red Hat Network Classic. For more information, see Subscribing to Required Channels using RHN Classic in the Red Hat Virtualization Installation Guide: https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.6/html/Installation_Guide/Subscribing_to_Required_Channels_using_Subscription_Manager1.html."
[...]
"Install Red Hat Virtualization Hypervisor 3.4 on bare metal. See Installing the Red Hat Virtualization Hypervisor chapter of the Red Hat Virtualization Installation Guide: https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.6/html/Installation_Guide/part-Installing_Hypervisor_Hosts.html"
[...]
"Red Hat Virtualization Hypervisor host
Install Red Hat Virtualization Hypervisor 3.4 on bare metal. See Installing the Red Hat Virtualization Hypervisor chapter of the Red Hat Virtualization Installation Guide: https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.6/html/Installation_Guide/part-Installing_Hypervisor_Hosts.html."
3. "From the Red Hat Virtualization Manager 3.4 release onwards, you can perform asynchronous tasks on the Red Hat Gluster Storage volume such as rebalance and remove brick operations."

Expected results:

1. "Getting Started with Red Hat Gluster Storage 3.3 and Red Hat Virtualization 4.0 or later"
2. Equivalent references for 4.0
3. "From the Red Hat Virtualization Manager 4.0 release onwards, you can perform asynchronous tasks on the Red Hat Gluster Storage volume such as rebalance and remove brick operations." (although it is strictly true)

Additional info:

May also need to review RHEL version references to ensure compatibility
There may be additional references that I missed