Bug 1648352

Summary:	OCS deployment guide should suggest proper version of glusterfs-client to be installed
Product:	[Red Hat Storage] Red Hat Gluster Storage	Reporter:	Neha Berry <nberry>
Component:	doc-Container_Native_Storage_with_OpenShift	Assignee:	Chandrakanth Pai <chpai>
Status:	CLOSED CURRENTRELEASE	QA Contact:	RamaKasturi <knarra>
Severity:	high	Docs Contact:
Priority:	unspecified
Version:	ocs-3.11	CC:	asriram, chpai, knarra, rhs-bugs, rtalur, sankarshan, storage-doc
Target Milestone:	---	Keywords:	ZStream
Target Release:	OCS 3.11.z Batch Update 2
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-04-01 06:08:17 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:	1672844

Description Neha Berry 2018-11-09 13:52:18 UTC

Description of problem:
++++++++++++++++++

The OCS 3.11 Deployment guide includes checking the glusterfs-client packages are installed or not in all the OCP nodes : section- 3.1.3 and 3.2.3. 

But it doesn't explicitly mention that the client package should either be the same OR only one version lower than the gluster-rhgs version(which differs based on the selected OCS version). Only checking the gluster-client is installed or not is not sufficient, we need to have the correct version installed.

Reason for ask:
===============
During ansible OCP install(deploy_cluster), a task is executed to install glusterfs-client packages on all OCP nodes. Depending on the repo enabled, we may end up in situations where the client version installed is either lower or higher than the gluster rhgs version in OCS gluster pods. 

Hence, it would be advisable to add a note to make sure the glusterfs-client version is appropriate, based on the selected OCS version(aka gluster server version in OCS pods)


Document link
=====================

Chapter 3. Verify Prerequisites

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

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



One example
==============

Currently, in RHEL 7.6 ,
if repo rh-gluster-3-client-for-rhel-7-server-rpms is enabled  
-------------------------------------------------------------

gluster-client package =3.12.2-25

if only repo: rhel-7-server-rpms is enabled
------------------------------------------
gluster-client version = 3.12.2-18.el7.x86_64


But if we install OCS 3.11, the gluster-server rpm in pods= 3.12.2-18.2

Hence, we may end up in a situation where the client and server packages are not of the recommended version of compatibility.

# yum provides glusterfs-client|grep -B3  3.12.2

glusterfs-fuse-3.12.2-25.el7.x86_64 : Fuse client
Repo        : rh-gluster-3-client-for-rhel-7-server-rpms
Matched from:
Provides    : glusterfs-client = 3.12.2-25.el7


glusterfs-fuse-3.12.2-18.el7.x86_64 : Fuse client
Repo        : rhel-7-server-rpms
Matched from:
Provides    : glusterfs-client = 3.12.2-18.el7

Comment 3 RamaKasturi 2019-03-18 08:49:33 UTC

Hello Talur,

   Is it okay to say in our docs that we support glusterfs-client should be the same as server version or one version lower. As of today we test with glusterfs-client version the same as server. Please suggest.

Thanks
kasturi

Comment 4 RamaKasturi 2019-03-20 12:25:46 UTC

Moving this back to assigned state since we test with glusterfs-client version being the same as rhgs-server version. Can the same be updated in the docs too ?

Clearing the need info on talur

Comment 5 Anjana Suparna Sriram 2019-03-20 12:56:51 UTC

(In reply to RamaKasturi from comment #4)
> Moving this back to assigned state since we test with glusterfs-client
> version being the same as rhgs-server version. Can the same be updated in
> the docs too ?
> 
> Clearing the need info on talur

Raising a needinfo on Chandrakanth to address comment 4.

Regards,
Anjana

Comment 7 RamaKasturi 2019-03-21 13:06:06 UTC

Hello chandrakanth,


     Can you modify the note as below, currently i see gluster-rhgs instead of gluster-rhgs-server.

Ensure that the latest version of glusterfs-client RPMs are installed. The client RPMs version must be the same version as that of gluster-rhgs-server version. The gluster-rhgs-server version is based on the selected OCS version

Thanks
kasturi

Comment 9 RamaKasturi 2019-03-22 12:24:12 UTC

Verified in the links provided at Comment 8 and i see that the changes are present.

Moving the bug to verified state.