Bug 1371387 - Updates required in section 3.1. Supported Operating Systems
Summary: Updates required in section 3.1. Supported Operating Systems
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Gluster Storage
Classification: Red Hat
Component: Documentation
Version: rhgs-3.1
Hardware: Unspecified
OS: Unspecified
unspecified
unspecified
Target Milestone: ---
: CNS 3.3
Assignee: Divya
QA Contact: krishnaram Karthick
URL:
Whiteboard:
Depends On:
Blocks: 1371471
TreeView+ depends on / blocked
 
Reported: 2016-08-30 06:37 UTC by Anjana Suparna Sriram
Modified: 2016-10-14 13:54 UTC (History)
8 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2016-10-14 13:54:26 UTC
Target Upstream Version:
divya: needinfo-


Attachments (Terms of Use)

Description Anjana Suparna Sriram 2016-08-30 06:37:06 UTC
Document URL: https://access.redhat.com/documentation/en/red-hat-gluster-storage/3.1/paged/deployment-guide-for-containerized-red-hat-gluster-storage-in-openshift-enterprise/chapter-3-support-requirements

Section Number and Name: 3.1. Supported Operating Systems

Describe the issue: Add "3.3" to OSE requirements

Comment 3 Divya 2016-09-21 12:00:55 UTC
(In reply to Divya from comment #2)
> I have updated the "Chapter 3. Support Requirements" with OpenShift
> supported versions.
> 
> Link to the doc:
> https://access.qa.redhat.com/documentation/en/red-hat-gluster-storage/3.1/
> single/red-hat-gluster-storage-container-native-with-openshift-platform/
> #chap-Documentation-
> Red_Hat_Gluster_Storage_Container_Native_with_OpenShift_Platform-
> Support_Requirements_2

The link listed in Comment 2 is not working. Please use the following link to review the updates.

http://jenkinscat.gsslab.pnq.redhat.com:8080/view/Gluster/job/doc-Red_Hat_Gluster_Storage-3.1-Red_Hat_Gluster_Storage_Container_Native_with_OpenShift_Platform%20(html-single)/lastSuccessfulBuild/artifact/tmp/en-US/html-single/index.html#chap-Documentation-Red_Hat_Gluster_Storage_Container_Native_with_OpenShift_Platform-Support_Requirements_2

Comment 4 krishnaram Karthick 2016-09-27 14:09:55 UTC
I see '3.2 and later' has been updated under 'OpenShift Container Platform' in the above link.

Moving the bug to verified.

Comment 5 Prasanth 2016-09-28 08:33:55 UTC
Divya,

As discussed and suggested, i'm pasting a few suggestions from my side in this BZ:

1. Table 3.1. Supported Operating Systems --> Why are we calling it as Operating Systems??        IMO, it shouldn't be called as OS

2. I think we should mention OpenShift Enterprise 3.2 and OpenShift Container Platform 3.3 separately as the supported versions to avoid any confusion 

3. Subscribe to the OpenShift Enterprise 3.2 repo --> this should be either removed to moved to  a separate section to avoid any confusion. Also, by default, we should first mention about 3.3 repo ONLY

4. Subscribe to the OpenShift Container Platform 3.3 repo --> We should also add --enable="rhel-7-server-rpms" to it as it has a dependency on the package "git"

Can you please check and update the guide if these suggestions seems to be valid?

-Prasanth

Comment 7 Divya 2016-09-29 10:20:06 UTC
(In reply to Prasanth from comment #5)
> Divya,
> 
> As discussed and suggested, i'm pasting a few suggestions from my side in
> this BZ:
> 
> 1. Table 3.1. Supported Operating Systems --> Why are we calling it as
> Operating Systems??        IMO, it shouldn't be called as OS

Ahh you are right. I have changed it to "Supported Versions"

> 
> 2. I think we should mention OpenShift Enterprise 3.2 and OpenShift
> Container Platform 3.3 separately as the supported versions to avoid any
> confusion 

We always mention it as "x.y and later". Hence, to maintain consistency across the docs, retaining it as is.

> 
> 3. Subscribe to the OpenShift Enterprise 3.2 repo --> this should be either
> removed to moved to  a separate section to avoid any confusion. Also, by
> default, we should first mention about 3.3 repo ONLY

This guide is applicable for both 3.2 and 3.3 versions of OpenShift. I have updated the text to make it clear that you need to subscribe to 3.2 or 3.3 repository.

> 
> 4. Subscribe to the OpenShift Container Platform 3.3 repo --> We should also
> add --enable="rhel-7-server-rpms" to it as it has a dependency on the
> package "git"

Updated the command to "# subscription-manager repos --enable=rhel-7-server-ose-3.3-rpms --enable=rhel-7-server-rpms" for 3.3 

and for 3.2 as:

# subscription-manager repos --enable=rhel-7-server-ose-3.2-rpms --enable=rhel-7-server-rpms

Link to the latest doc: https://doc-stage.usersys.redhat.com/documentation/en/red-hat-gluster-storage/3.1/single/red-hat-gluster-storage-container-native-with-openshift-platform/#chap-Documentation-Red_Hat_Gluster_Storage_Container_Native_with_OpenShift_Platform-Support_Requirements_2

Moving the bug back to ON_QA.

> 
> Can you please check and update the guide if these suggestions seems to be
> valid?
> 
> -Prasanth


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