Bug 1717752

Summary: Add note in section 7.4 to update glusterfs-client with version for converged mode only
Product: [Red Hat Storage] Red Hat Gluster Storage Reporter: Ashmitha Ambastha <asambast>
Component: doc-Container_Native_Storage_with_OpenShiftAssignee: Anjana KD <akrishna>
Status: CLOSED CURRENTRELEASE QA Contact: Ashmitha Ambastha <asambast>
Severity: urgent Docs Contact:
Priority: urgent    
Version: ocs-3.11CC: akrishna, asriram, knarra, pasik, pprakash, puebele, rhs-bugs, 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:29 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.10 pdf
none
3.11 Deployment Guide PDF
none
3.10 pdf
none
3.11 Deployment Guide PDF
none
3.11 Deployment Guide PDF none

Comment 2 Anjana KD 2019-06-06 10:34:30 UTC
Created attachment 1577840 [details]
3.10 pdf

Comment 3 Anjana KD 2019-06-06 10:35:28 UTC
Created attachment 1577841 [details]
3.11 Deployment Guide PDF

Comment 4 Anjana KD 2019-06-06 10:37:32 UTC
Updated the required changes in section 7.4. Upgrading the client on Red Hat Openshift Container Platform Nodes.

Have attached  Deployment guide PDF for 3.10 and 3.11, kindly verify.

Comment 6 Anjana KD 2019-06-06 10:55:16 UTC
Created attachment 1577844 [details]
3.10 pdf

Comment 12 Anjana KD 2019-06-07 13:00:42 UTC
Created attachment 1578345 [details]
3.11 Deployment Guide PDF

section 7.4 point 3

Updated command.

Comment 13 RamaKasturi 2019-06-08 11:37:55 UTC
Failing the bug because the command needs to be present at 6.4 section and has to be removed from section  7.4 Since 7.4 section talks about updating glusterfs-client on OCP nodes in independent mode and the command which is present there already satisfies the requirement to upgrade the clients.

@Ashmitha, could you please confirm as well ?

Comment 14 Ashmitha Ambastha 2019-06-10 06:39:28 UTC
With the constant changes being made to the doc, I see we have the section 6.3 Upgrading the client on Red Hat Openshift Container Platform Nodes specifically for Converged mode upgrades as well. 
The already existing change is NOT right for any of the 3.11 batch updates!

Anyways, Clearing the confusion.

The change has to be made ONLY in section 6.3 Upgrading the client on Red Hat Openshift Container Platform Nodes in point #3 for 3.11 deployment guide.
                          ----
*This change is for converged mode upgrades ONLY*

Has to be changed from : 
--------------------------

Execute the command on the node to upgrade the client on the node to glusterfs-fuse-3.12.2-32.el7.x86_64 version:
# yum install glusterfs-client

To this : 
----------
Execute the command on the node to upgrade the client on the node to glusterfs-fuse-3.12.2-47.el7.x86_64 version:
yum update glusterfs-fuse-3.12.2-47.el7.x86_64



@Anjana, Please reach out to me on IRC if you face any issue in understanding this change before you go ahead and make the change in the doc.

Comment 15 Ashmitha Ambastha 2019-06-10 07:19:41 UTC
I see there is this bug in the fixing - https://bugzilla.redhat.com/show_bug.cgi?id=1683726

So I'm writing this comment to point to the correct section the change has to be made to. 

According to the PDF attached in comment #12, please make the change to 

6.4. Upgrading the client on Red Hat Openshift Container Platform Nodes in point #3

The change which needs to be made is the same as written in comment #14

Comment 16 Anjana KD 2019-06-10 07:55:58 UTC
Have updated section 6.4

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

In case the changes are not visible in the above link, please see the attached PDF.

Comment 17 Anjana KD 2019-06-10 07:56:52 UTC
Created attachment 1578963 [details]
3.11 Deployment Guide PDF

Comment 18 Ashmitha Ambastha 2019-06-10 08:45:28 UTC
Moving bug to verified state based on PDF attached in comment#17
Section 6.4 point 3 is changed to yum update glusterfs-fuse-3.12.2-47.el7.x86_64


# yum update glusterfs-fuse-3.12.2-47.el7.x86_64
Loaded plugins: product-id, search-disabled-repos, subscription-manager
Resolving Dependencies
--> Running transaction check
---> Package glusterfs-fuse.x86_64 0:3.12.2-32.el7 will be updated
---> Package glusterfs-fuse.x86_64 0:3.12.2-47.el7 will be an update
--> Processing Dependency: glusterfs(x86-64) = 3.12.2-47.el7 for package: glusterfs-fuse-3.12.2-47.el7.x86_64
--> Processing Dependency: glusterfs-client-xlators(x86-64) = 3.12.2-47.el7 for package: glusterfs-fuse-3.12.2-47.el7.x86_64
--> Processing Dependency: glusterfs-libs(x86-64) = 3.12.2-47.el7 for package: glusterfs-fuse-3.12.2-47.el7.x86_64
--> Running transaction check
---> Package glusterfs.x86_64 0:3.12.2-32.el7 will be updated
---> Package glusterfs.x86_64 0:3.12.2-47.el7 will be an update
---> Package glusterfs-client-xlators.x86_64 0:3.12.2-32.el7 will be updated
---> Package glusterfs-client-xlators.x86_64 0:3.12.2-47.el7 will be an update
---> Package glusterfs-libs.x86_64 0:3.12.2-32.el7 will be updated
---> Package glusterfs-libs.x86_64 0:3.12.2-47.el7 will be an update
--> Finished Dependency Resolution
 
Dependencies Resolved
 
================================================================================
 Package  Arch   Version       Repository                                  Size
================================================================================
Updating:
 glusterfs-fuse
          x86_64 3.12.2-47.el7 rh-gluster-3-client-for-rhel-7-server-rpms 126 k
Updating for dependencies:
 glusterfs
          x86_64 3.12.2-47.el7 rh-gluster-3-client-for-rhel-7-server-rpms 512 k
 glusterfs-client-xlators
          x86_64 3.12.2-47.el7 rh-gluster-3-client-for-rhel-7-server-rpms 882 k
 glusterfs-libs
          x86_64 3.12.2-47.el7 rh-gluster-3-client-for-rhel-7-server-rpms 387 k
 
Transaction Summary
================================================================================
Upgrade  1 Package (+3 Dependent packages)
 
Total download size: 1.9 M
Downloading packages:
Delta RPMs disabled because /usr/bin/applydeltarpm not installed.
--------------------------------------------------------------------------------
Total                                              1.4 MB/s | 1.9 MB  00:01    
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
  Updating   : glusterfs-libs-3.12.2-47.el7.x86_64                          1/8
  Updating   : glusterfs-client-xlators-3.12.2-47.el7.x86_64                2/8
  Updating   : glusterfs-3.12.2-47.el7.x86_64                               3/8
  Updating   : glusterfs-fuse-3.12.2-47.el7.x86_64                          4/8
  Cleanup    : glusterfs-fuse-3.12.2-32.el7.x86_64                          5/8
  Cleanup    : glusterfs-3.12.2-32.el7.x86_64                               6/8
  Cleanup    : glusterfs-client-xlators-3.12.2-32.el7.x86_64                7/8
  Cleanup    : glusterfs-libs-3.12.2-32.el7.x86_64                          8/8
  Verifying  : glusterfs-libs-3.12.2-47.el7.x86_64                          1/8
  Verifying  : glusterfs-client-xlators-3.12.2-47.el7.x86_64                2/8
  Verifying  : glusterfs-fuse-3.12.2-47.el7.x86_64                          3/8
  Verifying  : glusterfs-3.12.2-47.el7.x86_64                               4/8
  Verifying  : glusterfs-3.12.2-32.el7.x86_64                               5/8
  Verifying  : glusterfs-libs-3.12.2-32.el7.x86_64                          6/8
  Verifying  : glusterfs-fuse-3.12.2-32.el7.x86_64                          7/8
  Verifying  : glusterfs-client-xlators-3.12.2-32.el7.x86_64                8/8
 
Updated:
  glusterfs-fuse.x86_64 0:3.12.2-47.el7                                        
 
Dependency Updated:
  glusterfs.x86_64 0:3.12.2-47.el7                                              
  glusterfs-client-xlators.x86_64 0:3.12.2-47.el7                              
  glusterfs-libs.x86_64 0:3.12.2-47.el7                                        
 
Complete!