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
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.
Created attachment 1578886 [details] 3.11 Deployment Guide PDF
Created attachment 1578887 [details] 3.10 Deployment Guide pdf
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
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