Hide Forgot
Additional info: This bug will track the following use case from the CNS 3.4 content plan: Use Case #1 As an administrator, I need to install CNS 3.4 to an OpenShift 3.4 system from a client machine. - Provide detailed instructions regarding how to install CNS 3.4 via a single command (installation utility). - Provide message text that provides the administrator with the following information at run time: - Installation successful. - Installation failed with applicable RCs, log information, and additional relevant content for the administrator to understand how to resolve the install failure. Note: Existing manual deployment tasks will need to be revised and/or removed based on final outcome/design of the install utility.
Anjana, I will be working with Humble wrt installation steps. For upgrade, Ken has added the following note to the Resource List [1] doc: >>>> RHGS volmanager (heketi) container image upgrade steps - ownership on QE to test, discover steps and provide to CCS for documentation, Devel to assist QE in process. <<<< Could you let me know the QE contact and the timelines of when they would be providing the inputs to the CCS? Thanks! [1] https://docs.google.com/document/d/1aixoTr0qI6tNCtX3g7FGHthjcZBxYKgJ9t0A-EXqUyo/edit
Humble, Could you please provide me the steps or the links which outlines the steps to install CNS 3.4 to an OpenShift 3.4 system from a client machine? If you have demo video, please do share. Thanks, Divya
(In reply to Divya from comment #5) > Anjana, > > I will be working with Humble wrt installation steps. > > For upgrade, Ken has added the following note to the Resource List [1] doc: > > >>>> > > RHGS volmanager (heketi) container image upgrade steps - ownership on QE to > test, discover steps and provide to CCS for documentation, Devel to assist > QE in process. > > <<<< > > Could you let me know the QE contact and the timelines of when they would be > providing the inputs to the CCS? > > Thanks! > > [1] > https://docs.google.com/document/d/1aixoTr0qI6tNCtX3g7FGHthjcZBxYKgJ9t0A- > EXqUyo/edit Anjana, I have added this comment in BZ# 1386681 as it is more relevant to the upgrade bug. Cancelling the need info here.
Clarification regarding these two items: - Provide detailed instructions regarding how to install CNS 3.4 via a single command (installation utility). -->"via a single command (installation utility)" is out of scope for 3.4. Please use this BZ to track 3.4 installation documentation effort. - Provide message text that provides the administrator with the following information at run time: --> Message text might be dependent on frozen upstream CLI output and therefore, might not be available for CCS to edit/revise.
Humble, I have created CNS 3.4 guide based on CNS 3.3 guide. Could you please review the following chapters and let me know if it requires any change for 3.4? Chapter 3. Support Requirements: https://access.qa.redhat.com/documentation/en/red-hat-gluster-storage/3.1/single/container-native-storage-for-openshift-container-platform/#chap-Documentation-Red_Hat_Gluster_Storage_Container_Native_with_OpenShift_Platform-Support_Requirements_2 Chapter 4. Setting up the Environment: https://access.qa.redhat.com/documentation/en/red-hat-gluster-storage/3.1/single/container-native-storage-for-openshift-container-platform/#chap-Documentation-Red_Hat_Gluster_Storage_Container_Native_with_OpenShift_Platform-Setting_the_environment Thanks!
http://jenkinscat.gsslab.pnq.redhat.com:8080/view/Gluster/job/doc-Red_Hat_Gluster_Storage-3.4-Container_Native_Storage_with_OpenShift_Platform%20%28html-single%29/lastSuccessfulBuild/artifact/tmp/en-US/html-single/index.html#chap-Documentation-Red_Hat_Gluster_Storage_Container_Native_with_OpenShift_Platform-Support_Requirements_2 POINT 1: ~~~ Subscribe to the OpenShift Enterprise 3.2 repository If you are using OpenShift Enterprise 3.2, subscribe to 3.2 repository to enable you to install the Openshift client packages # subscription-manager repos --enable=rhel-7-server-ose-3.2-rpms --enable=rhel-7-server-rpms # yum install atomic-openshift-clients # yum install atomic-openshift ~~~ Any specific reason for this section ? POINT 2: We have mentioned static provisioning in this doc . I am bit confused on, whats the plan for dynamic provisioning section. Is it going to be in this same doc or some where else ? POINT 3: We were preparing troubleshooting doc, Where its going to be ? POINT 4: ~~~~ Execute the following command to deploy heketi: # oc process deploy-heketi -v \ HEKETI_KUBE_NAMESPACE=<Project name> \ HEKETI_KUBE_APIHOST='<OpenShift master endpoint address>' \ HEKETI_KUBE_INSECURE=y \ HEKETI_KUBE_USER=<user name> \ HEKETI_KUBE_PASSWORD=<password> | oc create -f - For example: # oc process deploy-heketi -v \ HEKETI_KUBE_NAMESPACE=storage-project \ HEKETI_KUBE_APIHOST='https://master.example.com:8443' \ HEKETI_KUBE_INSECURE=y \ HEKETI_KUBE_USER=test-admin \ HEKETI_KUBE_PASSWORD=admin | oc create -f - ~~~ There are some changes required to the above. Lets discuss this tomorrow.
Humble, My comments in line. (In reply to Humble Chirammal from comment #14) > http://jenkinscat.gsslab.pnq.redhat.com:8080/view/Gluster/job/doc- > Red_Hat_Gluster_Storage-3.4- > Container_Native_Storage_with_OpenShift_Platform%20%28html-single%29/ > lastSuccessfulBuild/artifact/tmp/en-US/html-single/index.html#chap- > Documentation- > Red_Hat_Gluster_Storage_Container_Native_with_OpenShift_Platform- > Support_Requirements_2 > > > POINT 1: > > ~~~ > Subscribe to the OpenShift Enterprise 3.2 repository > If you are using OpenShift Enterprise 3.2, subscribe to 3.2 repository to > enable you to install the Openshift client packages > > # subscription-manager repos --enable=rhel-7-server-ose-3.2-rpms > --enable=rhel-7-server-rpms > > # yum install atomic-openshift-clients > > # yum install atomic-openshift > ~~~ > > Any specific reason for this section ? I had deleted the 3.2 information in the guide. Looks like there was an issue in sync. Link to the latest guide without 3.2 information: https://access.qa.redhat.com/documentation/en/red-hat-gluster-storage/3.1/single/container-native-storage-for-openshift-container-platform/#chap-Documentation-Red_Hat_Gluster_Storage_Container_Native_with_OpenShift_Platform-Support_Requirements_2-Supported_Versions > > > POINT 2: > > We have mentioned static provisioning in this doc . I am bit confused on, > whats the plan for dynamic provisioning section. Is it going to be in this > same doc or some where else ? Please refer to https://bugzilla.redhat.com/show_bug.cgi?id=1386546 for information on dynamic provisioning. The google doc mentioned in the bug has information on dynamic provisioning and static provisioning. > > > POINT 3: > > > We were preparing troubleshooting doc, Where its going to be ? I will be adding it as a new chapter after the Managing Clusters chapter. The content of the troubleshooting chapter is WIP and is available at: https://docs.google.com/document/d/1Co8ROwNF9TjYNeafvZkeF9AcINOjVWnIyYkMpqOhjyI/edit# > > POINT 4: > > ~~~~ > Execute the following command to deploy heketi: > > # oc process deploy-heketi -v \ > HEKETI_KUBE_NAMESPACE=<Project name> \ > HEKETI_KUBE_APIHOST='<OpenShift master endpoint address>' \ > HEKETI_KUBE_INSECURE=y \ > HEKETI_KUBE_USER=<user name> \ > HEKETI_KUBE_PASSWORD=<password> | oc create -f - > > For example: > > # oc process deploy-heketi -v \ > HEKETI_KUBE_NAMESPACE=storage-project \ > HEKETI_KUBE_APIHOST='https://master.example.com:8443' \ > HEKETI_KUBE_INSECURE=y \ > HEKETI_KUBE_USER=test-admin \ > HEKETI_KUBE_PASSWORD=admin | oc create -f - > > ~~~ > > There are some changes required to the above. Lets discuss this tomorrow. I have scheduled a meeting to take this forward. Thanks, Divya
(In reply to Divya from comment #16) > > > > POINT 1: > > > > ~~~ > > Subscribe to the OpenShift Enterprise 3.2 repository > > If you are using OpenShift Enterprise 3.2, subscribe to 3.2 repository to > > enable you to install the Openshift client packages > > > > # subscription-manager repos --enable=rhel-7-server-ose-3.2-rpms > > --enable=rhel-7-server-rpms > > > > # yum install atomic-openshift-clients > > > > # yum install atomic-openshift > > ~~~ > > > > Any specific reason for this section ? > > I had deleted the 3.2 information in the guide. Looks like there was an > issue in sync. > > Link to the latest guide without 3.2 information: > https://access.qa.redhat.com/documentation/en/red-hat-gluster-storage/3.1/ > single/container-native-storage-for-openshift-container-platform/#chap- > Documentation- > Red_Hat_Gluster_Storage_Container_Native_with_OpenShift_Platform- > Support_Requirements_2-Supported_Versions > Oh..ok.. Looks fine. > > > > > > POINT 2: > > > > We have mentioned static provisioning in this doc . I am bit confused on, > > whats the plan for dynamic provisioning section. Is it going to be in this > > same doc or some where else ? > > Please refer to https://bugzilla.redhat.com/show_bug.cgi?id=1386546 for > information on dynamic provisioning. The google doc mentioned in the bug has > information on dynamic provisioning and static provisioning. As discussed we can consolidate the doc now and can go for a final review. > > > > > > > POINT 3: > > > > > > We were preparing troubleshooting doc, Where its going to be ? > > I will be adding it as a new chapter after the Managing Clusters chapter. > The content of the troubleshooting chapter is WIP and is available at: > https://docs.google.com/document/d/ > 1Co8ROwNF9TjYNeafvZkeF9AcINOjVWnIyYkMpqOhjyI/edit# > > As in Point 3, lets consolidate and review. > > > > POINT 4: ........... > > I have scheduled a meeting to take this forward. > Discard Point 4. In short, ack from me. Now, we need to consolidate the docs and send for final review in rhs-containers ML.
Based on the eng/Humble's confirmation in Comment 17, moving the bug ON_QA. Link to the latest guide: https://access.qa.redhat.com/documentation/en/red-hat-gluster-storage/3.1/single/container-native-storage-for-openshift-container-platform/#chap-Documentation-Red_Hat_Gluster_Storage_Container_Native_with_OpenShift_Platform-Support_Requirements_2-Supported_Versions
comment 1: Subscribe to the Red Hat Gluster Storage repository: yum install heketi-client heketi-templates should be, yum install cns-deploy heketi-client Please change this is all occurrences in the doc. comment 2: All the pointers to openshift documentation currently point to 3.3 or 3.2, this has to be changed to 3.4. For ex, For more information regarding router setup, see https://access.redhat.com/documentation/en/openshift-enterprise/3.2/single/installation-and-configuration/#install-config-install-deploy-router For more information regarding setting up the DNS, see https://access.redhat.com/documentation/en/openshift-enterprise/version-3.2/installation-and-configuration/#prereq-dns. Please make the changes throughout the document.
(In reply to krishnaram Karthick from comment #19) > comment 1: > > Subscribe to the Red Hat Gluster Storage repository: > > yum install heketi-client heketi-templates > > should be, > > yum install cns-deploy heketi-client > > Please change this is all occurrences in the doc. I have updated the commands. Link to the doc: http://ccs-jenkins.gsslab.brq.redhat.com:8080/job/doc-Red_Hat_Gluster_Storage-3.4-Container_Native_Storage_with_OpenShift_Platform-branch-master/lastSuccessfulBuild/artifact/tmp/en-US/html-single/index.html#idm140007708729504 > > comment 2: > > All the pointers to openshift documentation currently point to 3.3 or 3.2, > this has to be changed to 3.4. > > For ex, > > For more information regarding router setup, see > https://access.redhat.com/documentation/en/openshift-enterprise/3.2/single/ > installation-and-configuration/#install-config-install-deploy-router > > For more information regarding setting up the DNS, see > https://access.redhat.com/documentation/en/openshift-enterprise/version-3.2/ > installation-and-configuration/#prereq-dns. > > Please make the changes throughout the document. Links to the OpenShift 3.4 docs is available only by end of the week.
To maintain consistency throughout the document, device names have to be same. so please change the following. { "clusters": [ { "nodes": [ { "node": { "hostnames": { "manage": [ "node1.example.com" ], "storage": [ "192.168.121.168" ] }, "zone": 1 }, "devices": [ "/dev/sdb", "/dev/sdc", "/dev/sdd", "/dev/sde" ] },... has to be, { "clusters": [ { "nodes": [ { "node": { "hostnames": { "manage": [ "node1.example.com" ], "storage": [ "192.168.121.168" ] }, "zone": 1 }, "devices": [ "/dev/vdb", "/dev/vdc", "/dev/vdd", "/dev/vde" ] },...
supported versions only reflect cns 3.4, why did we remove the previous versions? 3.1. Supported Versions The following table lists the supported versions of OpenShift Container Platform with Red Hat Gluster Storage Server.
(In reply to krishnaram Karthick from comment #22) > supported versions only reflect cns 3.4, why did we remove the previous > versions? > > 3.1. Supported Versions > The following table lists the supported versions of OpenShift Container > Platform with Red Hat Gluster Storage Server. This guide is applicable only for CNS 3.4 release. Users who use previous versions of the product has to use the respective version guide. Hence, the supported versions table contains only OpenShift 3.4.
(In reply to krishnaram Karthick from comment #21) > To maintain consistency throughout the document, device names have to be > same. so please change the following. I have updated the output of the cns-deploy command to maintain consistency across the doc. Link to the doc: http://ccs-jenkins.gsslab.brq.redhat.com:8080/job/doc-Red_Hat_Gluster_Storage-3.4-Container_Native_Storage_with_OpenShift_Platform-branch-master/lastSuccessfulBuild/artifact/tmp/en-US/html-single/index.html#idm140387201101920
(In reply to Divya from comment #20) > > > > > comment 2: > > > > All the pointers to openshift documentation currently point to 3.3 or 3.2, > > this has to be changed to 3.4. > > > > For ex, > > > > For more information regarding router setup, see > > https://access.redhat.com/documentation/en/openshift-enterprise/3.2/single/ > > installation-and-configuration/#install-config-install-deploy-router > > > > For more information regarding setting up the DNS, see > > https://access.redhat.com/documentation/en/openshift-enterprise/version-3.2/ > > installation-and-configuration/#prereq-dns. > > > > Please make the changes throughout the document. > > Links to the OpenShift 3.4 docs is available only by end of the week. Bug https://bugzilla.redhat.com/show_bug.cgi?id=1389070 will be used to track the link updates/corrections to OpenShift 3.4 docs.
requested changes are made, moving the bug to verified.