Bug 1717751

Summary: Add steps to recreate template after openshift-ansible update
Product: [Red Hat Storage] Red Hat Gluster Storage Reporter: Rachael <rgeorge>
Component: doc-Container_Native_Storage_with_OpenShiftAssignee: Anjana KD <akrishna>
Status: CLOSED CURRENTRELEASE QA Contact: Rachael <rgeorge>
Severity: high Docs Contact:
Priority: unspecified    
Version: ocs-3.11CC: akrishna, asriram, knarra, pprakash, puebele, rhs-bugs, rtalur, sankarshan, storage-doc
Target Milestone: ---Keywords: ZStream
Target Release: OCS 3.11.z Batch Update 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: 2019-07-22 13:31:30 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: 1694089    
Attachments:
Description Flags
3.11 Deployment Guide PDF
none
3.10 Deployment Guide pdf none

Description Rachael 2019-06-06 06:23:00 UTC 
Description of problem:

In the deployment guide, sections 6.1.1 and 6.2.1, after the update of openshift-ansible packages, the existing templates need to be re-created so that the updated changes can be included in the templates. 

The steps required to this are missing from the documentation and should be added.

https://access.redhat.com/documentation/en-us/red_hat_openshift_container_storage/3.11/html-single/deployment_guide/index#idm140154237358144

https://access.redhat.com/documentation/en-us/red_hat_openshift_container_storage/3.11/html-single/deployment_guide/index#idm140154238956448


Additional info:

This change has to be made for both OCS 3.10 and OCS 3.11 documentation
Comment 5 Anjana KD 2019-06-10 03:10:04 UTC 
Note: Few comments were already updated in the guide. Hence, I have mentioned the step number for verification.




1. Section 6.1.3.1

   a. update step 1 to have the following:
      Install or Update to the latest openshift-ansible-roles using the command
      yum install openshift-ansible-roles || yum update openshift-ansible-roles

   b. insert two steps before step 4
      1. Execute the following command to delete the heketi template.
         # oc delete templates heketi
      2. Execute the following command to install the heketi template.
         # oc create -f /usr/share/ansible/openshift-ansible/roles/openshift_storage_glusterfs/files/heketi-template.yml
           template "heketi" created
---------------------------------------------------------------------------------------------------------------------------
Deployment Guide 3.11: 

6.1.3.1: Upgrading cns-deploy and Heketi Server
a. Updated step 1 
b. The 2 comments are inserted as step 4 and step 5.


Deployment Guide 3.10:
6.1.3.1: Upgrading cns-deploy and Heketi Server
a. Updated step 1
b. The 2 comments are inserted as step 3 and step 5.

=====================================================================
2. Section 6.1.3.2
   a. insert two steps before step 5
      1. Execute the following command to delete the old glusterfs template.
         # oc delete templates glusterfs
      2. Execute the following command to register new glusterfs template.
         # oc create -f /usr/share/ansible/openshift-ansible/roles/openshift_storage_glusterfs/files/glusterfs-template.yml
           template "glusterfs" created
-----------------------------------------------------------------------------------------------------------------------------
 Section 6.1.3.2: Upgrading the Red Hat Gluster Storage Pods

Deployment Guide 3.11: 
  a) Step 5 
  b) step 7 


Deployment Guide 3.10:
  a) Step 5 
  b) step 7

=======================================================================================================

3. Section 6.2.3.1


   a. insert step 1 to have the following:
      Install or Update to the latest openshift-ansible-roles using the command
      yum install openshift-ansible-roles || yum update openshift-ansible-roles

   b. insert two steps before current step 3
      1. Execute the following command to delete the heketi template.
         # oc delete templates heketi
      2. Execute the following command to install the heketi template.
         # oc create -f /usr/share/ansible/openshift-ansible/roles/openshift_storage_glusterfs/files/heketi-template.yml
           template "heketi" created
   ------------------------------------------------------------------------------

Deployment Guide 3.11: 
Section 6.2.3.1: Upgrading cns-deploy and Heketi Server
	
a)Step 1
b)step 3 and step 5


Deployment Guide 3.10: 
section 6.2.2.1: Upgrading cns-deploy and Heketi Server
a)Step 1
b)step 3 and step 5

====================================================================================================================

4. Section 6.2.3.2
   a. insert two steps before step 5
      1. Execute the following command to delete the old glusterfs template.
         # oc delete templates glusterfs
      2. Execute the following command to register new glusterfs template.
         # oc create -f /usr/share/ansible/openshift-ansible/roles/openshift_storage_glusterfs/files/glusterfs-template.yml
           template "glusterfs" created

--------------------------------------------------------------------------------------------------
Deployment Guide 3.11:
6.2.3.2: Upgrading the Red Hat Gluster Storage Registry Pods
 1. step 5
 2. step 7 
 

Deployment Guide 3.10:
Section 6.2.2.2: Upgrading the Red Hat Gluster Storage Registry Pods
 1. step 5
 2. step 7 

======================================================================================================================


Link for verification:

https://access.redhat.com/documentation/en-us/red_hat_openshift_container_storage/3.11/html-single/deployment_guide/index?lb_target=preview#idm140362879787824
https://access.redhat.com/documentation/en-us/red_hat_openshift_container_storage/3.10/html-single/deployment_guide/index?lb_target=preview#idm140176663645568

In case the changes are not visible in the above links, please see the attached PDFs.
Comment 6 Anjana KD 2019-06-10 03:11:32 UTC 
Created attachment 1578886 [details]
3.11 Deployment Guide PDF
Comment 7 Anjana KD 2019-06-10 03:12:31 UTC 
Created attachment 1578887 [details]
3.10 Deployment Guide pdf
Comment 12 Anjana KD 2019-06-13 02:12:00 UTC 
I have updated changes mentioned in comment 8 and 9. 
Also incorporated the following changes for independent mode

For the independent mode registry section:
7.3.2. Upgrading Heketi Registry pod Before step 4,  you'll have to add this:
1. Execute the following command to delete the heketi template.
         # oc delete templates heketi
      2. Execute the following command to install the heketi template.
         # oc create -f /usr/share/ansible/openshift-ansible/roles/openshift_storage_glusterfs/files/heketi-template.yml
           template "heketi" created
7.3.2. Upgrading Heketi Registry pod Before step 8,  you'll have to add this:
1. Execute the following command to delete the old glusterblock provisioner template.
         # oc delete templates glusterblock-provisioner

      2. Execute the following command to register new glusterblock provisioner template.
         # oc create -f /usr/share/ansible/openshift-ansible/roles/openshift_storage_glusterfs/files/glusterblock-provisioner.yml
           template "glusterblock-provisioner" created


link to verify
=============
Chapter 6 - https://access.redhat.com/documentation/en-us/red_hat_openshift_container_storage/3.11/html-single/deployment_guide/index?lb_target=stage#chap-Documentation-Red_Hat_Gluster_Storage_Container_Native_with_OpenShift_Platform-Upgrade

Chapter 7 - https://access.redhat.com/documentation/en-us/red_hat_openshift_container_storage/3.11/html-single/deployment_guide/index?lb_target=stage#chap-Upgrade_CRS
Comment 16 Anjana KD 2019-06-13 10:15:44 UTC 
link to verify
=============
Chapter 6 - https://access.redhat.com/documentation/en-us/red_hat_openshift_container_storage/3.11/html-single/deployment_guide/index?lb_target=stage#chap-Documentation-Red_Hat_Gluster_Storage_Container_Native_with_OpenShift_Platform-Upgrade

Chapter 7 - https://access.redhat.com/documentation/en-us/red_hat_openshift_container_storage/3.11/html-single/deployment_guide/index?lb_target=stage#chap-Upgrade_CRS