Bug 1371471 - [Tracker] - Tracker for RHGS-Container-Native-with-OCP-3.3 Release Documentation BZs
Summary: [Tracker] - Tracker for RHGS-Container-Native-with-OCP-3.3 Release Documentat...
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Gluster Storage
Classification: Red Hat
Component: Documentation
Version: unspecified
Hardware: Unspecified
OS: Unspecified
unspecified
unspecified
Target Milestone: ---
: CNS 3.3
Assignee: Anjana Suparna Sriram
QA Contact: Anoop
URL:
Whiteboard:
Depends On: 1371382 1371386 1371387 1377358 1378662 1378925
Blocks:
TreeView+ depends on / blocked
 
Reported: 2016-08-30 09:36 UTC by Anjana Suparna Sriram
Modified: 2016-10-14 13:57 UTC (History)
9 users (show)

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


Attachments (Terms of Use)

Description Anjana Suparna Sriram 2016-08-30 09:36:05 UTC
Document URL: 

Section Number and Name: 

Describe the issue: 

Suggestions for improvement: 

Additional information:

Comment 2 Erin Boyd 2016-09-29 20:36:22 UTC
Issue 1:
Directions are confusing for version:
User should not be executing both of these commands:
Subscribe to the OpenShift Enterprise 3.2 repo
This enables you to install the Openshift client packages

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

# yum install atomic-openshift-clients

# yum install atomic-openshift

Subscribe to the OpenShift Container Platform 3.3 repo
This enables you to install the Openshift client packages

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

# yum install atomic-openshift-clients

# yum install atomic-openshift

Issue 2:
If router doesn't deploy, user can use port-forwarding but it's finicky. It should remind user to check status of the port forwarding if heketi-cli commands aren't working. This may prevent many users from being stuck.

Issue 3:
When creating the PV/PVCs it should be done in a consistent manner. Either all yaml or json. It's strange to mix both

Issue 4: Selectors:
Comments directly in doc: https://docs.google.com/document/d/1CDb35N7N_qIW98ga9967QnCDHTE_dHhKTrNn0CWEJzk/edit?ts=57e38508

Comment 3 Divya 2016-09-30 08:52:36 UTC
(In reply to Erin Boyd from comment #2)
> Issue 1:
> Directions are confusing for version:
> User should not be executing both of these commands:
> Subscribe to the OpenShift Enterprise 3.2 repo
> This enables you to install the Openshift client packages
> 
> # subscription-manager repos --enable=rhel-7-server-ose-3.2-rpms
> 
> # yum install atomic-openshift-clients
> 
> # yum install atomic-openshift
> 
> Subscribe to the OpenShift Container Platform 3.3 repo
> This enables you to install the Openshift client packages
> 
> # subscription-manager repos --enable=rhel-7-server-ose-3.3-rpms
> 
> # yum install atomic-openshift-clients
> 
> # yum install atomic-openshift

I have already fixed this issue based on Erin's email on 29/09/2016

Link to the 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/#idm139904512129824

> 
> Issue 2:
> If router doesn't deploy, user can use port-forwarding but it's finicky. It
> should remind user to check status of the port forwarding if heketi-cli
> commands aren't working. This may prevent many users from being stuck.
> 
> Issue 3:
> When creating the PV/PVCs it should be done in a consistent manner. Either
> all yaml or json. It's strange to mix both
> 
> Issue 4: Selectors:
> Comments directly in doc:
> https://docs.google.com/document/d/
> 1CDb35N7N_qIW98ga9967QnCDHTE_dHhKTrNn0CWEJzk/edit?ts=57e38508

Comment 5 Divya 2016-10-03 09:33:15 UTC
(In reply to Divya from comment #3)
> (In reply to Erin Boyd from comment #2)
> > Issue 1:
> > Directions are confusing for version:
> > User should not be executing both of these commands:
> > Subscribe to the OpenShift Enterprise 3.2 repo
> > This enables you to install the Openshift client packages
> > 
> > # subscription-manager repos --enable=rhel-7-server-ose-3.2-rpms
> > 
> > # yum install atomic-openshift-clients
> > 
> > # yum install atomic-openshift
> > 
> > Subscribe to the OpenShift Container Platform 3.3 repo
> > This enables you to install the Openshift client packages
> > 
> > # subscription-manager repos --enable=rhel-7-server-ose-3.3-rpms
> > 
> > # yum install atomic-openshift-clients
> > 
> > # yum install atomic-openshift
> 
> I have already fixed this issue based on Erin's email on 29/09/2016
> 
> Link to the 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/#idm139904512129824
> 
> > 
> > Issue 2:
> > If router doesn't deploy, user can use port-forwarding but it's finicky. It
> > should remind user to check status of the port forwarding if heketi-cli
> > commands aren't working. This may prevent many users from being stuck.

Erin,

We have already added the following note in the "4.1. Preparing the Red Hat OpenShift Container Platform Cluster" section : If the router setup fails, use the port forward method as described in Appendix B, Client Configuration using Port Forwarding.

Appendix B has information how to configure the client using Port Forwarding

Do you want us to add a similar note in any other section?

> > Issue 3:
> > When creating the PV/PVCs it should be done in a consistent manner. Either
> > all yaml or json. It's strange to mix both
> > 
> > Issue 4: Selectors:
> > Comments directly in doc:
> > https://docs.google.com/document/d/
> > 1CDb35N7N_qIW98ga9967QnCDHTE_dHhKTrNn0CWEJzk/edit?ts=57e38508

I have incorporated the comments listed in the google doc.

Comment 6 Erin Boyd 2016-10-03 17:07:05 UTC
The two topology files should match (using 7.1.2.2 as the RIGHT one)
 ⁠7.1.3.1. Updating Topology file and 7.1.2.2

Comment 7 Divya 2016-10-04 07:03:05 UTC
(In reply to Erin Boyd from comment #6)
> The two topology files should match (using 7.1.2.2 as the RIGHT one)
>  ⁠7.1.3.1. Updating Topology file and 7.1.2.2

I have updated the topology files in "Chapter 7. Managing Clusters" to address the issue wrt hostname and IP address.

Link to the 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-Managing_Clusters

Comment 8 Prasanth 2016-10-04 10:24:47 UTC
Verified.

Comment 9 Erin Boyd 2016-10-04 16:02:50 UTC
Verified


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