Bug 1710739 - The upgrade section for registry cluster needs update
Summary: The upgrade section for registry cluster needs update
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Gluster Storage
Classification: Red Hat Storage
Component: doc-Container_Native_Storage_with_OpenShift
Version: ocs-3.11
Hardware: Unspecified
OS: Unspecified
high
high
Target Milestone: ---
: OCS 3.11.z Batch Update 3
Assignee: Anjana KD
QA Contact: Rachael
URL:
Whiteboard:
: 1712859 1714431 (view as bug list)
Depends On:
Blocks: 1694089
TreeView+ depends on / blocked
 
Reported: 2019-05-16 08:07 UTC by Rachael
Modified: 2019-07-22 13:31 UTC (History)
9 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2019-07-22 13:31:33 UTC
Embargoed:


Attachments (Terms of Use)
Deployment Guide - PDF (1.59 MB, application/pdf)
2019-05-27 05:31 UTC, Anjana KD
no flags Details
Deployment Guide - updated PDF (1.59 MB, application/pdf)
2019-05-30 07:17 UTC, Anjana KD
no flags Details
Deployment guide PDF - Updated comment 12 (1.59 MB, application/pdf)
2019-05-31 06:14 UTC, Anjana KD
no flags Details
Deployment Guide - updated PDF template (1.59 MB, application/pdf)
2019-06-03 12:31 UTC, Anjana KD
no flags Details
Deployment Guide - updated PDF (1.59 MB, application/pdf)
2019-06-06 07:37 UTC, Anjana KD
no flags Details

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


Note You need to log in before you can comment on or make changes to this bug.