Bug 1710739

Summary: The upgrade section for registry cluster needs 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: high    
Version: ocs-3.11CC: akrishna, aramteke, asriram, knarra, puebele, rhs-bugs, sankarshan, sselvan, 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:33 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
Deployment Guide - PDF
none
Deployment Guide - updated PDF
none
Deployment guide PDF - Updated comment 12
none
Deployment Guide - updated PDF template
none
Deployment Guide - updated PDF none

Comment 2 Aditya Ramteke 2019-05-22 11:38:53 UTC
*** Bug 1712859 has been marked as a duplicate of this bug. ***

Comment 3 Anjana KD 2019-05-24 10:31:24 UTC
Hi Rachael,

As discussed over IRC. Sharing the google doc for review.

https://docs.google.com/document/d/1AhhRN25C1mxk6wj52Z8cYKcLmYHJTxX-pkbpOaYhcM8/edit#

Comment 4 Anjana KD 2019-05-27 05:30:15 UTC
Hi Rachael

Clearing the need info, as queries were responded in the google doc. Have incorporated all the changes. Sharing PDF for verification.

Kindly look into section 6.2.3.1, 6.2.4.1 and 6.2.4.2.

Comment 5 Anjana KD 2019-05-27 05:31:31 UTC
Created attachment 1573747 [details]
Deployment Guide - PDF

Comment 6 Sri Vignesh Selvan 2019-05-29 06:45:13 UTC
*** Bug 1714431 has been marked as a duplicate of this bug. ***

Comment 8 Anjana KD 2019-05-30 02:36:46 UTC
Could you please provide the example/output required for step 5 and 9.

5. 6.2.3.1. Upgrading cns-deploy and Heketi Server, step 11, the heketi-registry pod is not listed in the example

9. 6.2.4.1. Upgrading Heketi Server, step 6, the heketi-registry pod is not listed in the example

Comment 10 Anjana KD 2019-05-30 07:17:39 UTC
Created attachment 1575116 [details]
Deployment Guide -  updated PDF

Comment 13 Anjana KD 2019-05-31 06:14:47 UTC
Created attachment 1575557 [details]
Deployment guide PDF - Updated comment 12

Comment 16 Anjana KD 2019-06-03 11:37:34 UTC
As discussed I will be making the following changes:

6.2.4.2. Upgrading the Red Hat Gluster Storage Registry Pods 

Step 5) Execute the following command to edit the old glusterfs template

 oc edit template glusterfs
- description: Labels which define the daemonset node selector. Must
contain at least one label of the format \'glusterfs=<CLUSTER_NAME>-
host\'
  displayName: Daemonset Node Labels
  name: NODE_LABELS
  value: '{ "glusterfs": "registry-host" }'
- displayName: GlusterFS container image name
  name: IMAGE_NAME
  required: true
  value: registry.access.redhat.com/rhgs3/rhgs-server-rhel7:v3.11.3
- description: A unique name to identify which heketi service manages
this cluster, useful for running multiple heketi instances
  displayName: GlusterFS cluster name
  name: CLUSTER_NAME
  value: registry

If the template has IMAGE_NAME and IMAGE_VERSION as two separate parameters, then update
the glusterfs template as following. For example:

    # oc edit template glusterfs
  - description: Labels which define the daemonset node selector. Must
contain at least one label of the format \'glusterfs=<CLUSTER_NAME>-
host\'
    displayName: Daemonset Node Labels
    name: NODE_LABELS
    value: '{ "glusterfs": "registry-host" }'
  - displayName: GlusterFS container image name
    name: IMAGE_NAME
    required: true
    value: registry.access.redhat.com/rhgs3/rhgs-server-rhel7
  - displayName: GlusterFS container image version
    name: IMAGE_VERSION
    required: true
    value: v3.11.3
  - description: A unique name to identify which heketi service
manages this cluster, useful for running multiple heketi instances
    displayName: GlusterFS cluster name
    name: CLUSTER_NAME
    value: registry


6.2.4.2. Upgrading the Red Hat Gluster Storage Registry Pods 

step 16)
Depending on the OCP version, edit the glusterblock-provisioner template to change the
IMAGE_NAME, IMAGE_VERSION and NAMESPACE.
# oc edit template glusterblock-provisioner
- displayName: glusterblock provisioner container image name
  name: IMAGE_NAME
  required: true
  value: registry.access.redhat.com/rhgs3/rhgs-gluster-block-prov-
rhel7:v3.11.3
- description: The namespace in which these resources are being
created
  displayName: glusterblock provisioner namespace
  name: NAMESPACE
  required: true
  value: glusterfs-registry
- description: A unique name to identify which heketi service manages
this cluster, useful for running multiple heketi instances
  displayName: GlusterFS cluster name
  name: CLUSTER_NAME
  value: registry

If the template has IMAGE_NAME and IMAGE_VERSION as two separate parameters, then update
the glusterblock-provisioner template as following. For example

    # oc edit template glusterblock-provisioner
- displayName: glusterblock provisioner container image name
  name: IMAGE_NAME
  required: true
  value: registry.access.redhat.com/rhgs3/rhgs-gluster-block-prov-
rhel7
- displayName: glusterblock provisioner container image version
  name: IMAGE_VERSION
  required: true
  value: v3.11.3
- description: The namespace in which these resources are being
created
  displayName: glusterblock provisioner namespace
  name: NAMESPACE
  required: true
  value: glusterfs-registry
- description: A unique name to identify which heketi service manages
this cluster, useful for running multiple heketi instances
  displayName: GlusterFS-registry cluster name
  name: CLUSTER_NAME
  value: registry


Making the above changes in the doc.

Comment 17 Anjana KD 2019-06-03 12:31:52 UTC
Created attachment 1576625 [details]
Deployment Guide -  updated PDF template

Comment 18 Anjana KD 2019-06-06 07:37:29 UTC
Created attachment 1577796 [details]
Deployment Guide -  updated PDF