| Summary: | [Tracker] - Tracker for RHGS-Container-Native-with-OCP-3.3 Release Documentation BZs | ||
|---|---|---|---|
| Product: | Red Hat Gluster Storage | Reporter: | Anjana Suparna Sriram <asriram> |
| Component: | Documentation | Assignee: | Anjana Suparna Sriram <asriram> |
| Status: | CLOSED CURRENTRELEASE | QA Contact: | Anoop <annair> |
| Severity: | unspecified | Docs Contact: | |
| Priority: | unspecified | ||
| Version: | unspecified | CC: | divya, eboyd, khartsoe, pprakash, rcyriac, rhs-bugs, sankarshan, storage-doc, storage-qa-internal |
| Target Milestone: | --- | ||
| Target Release: | CNS 3.3 | ||
| 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: | 2016-10-14 13:57:10 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: | |
| Bug Depends On: | 1371382, 1371386, 1371387, 1377358, 1378662, 1378925 | ||
| Bug Blocks: | |||
|
Description
Anjana Suparna Sriram
2016-08-30 09:36:05 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 (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 (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. 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 (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 Verified. Verified |