Bug 1759886

Summary:	[RFE] add new parameters in the documentation of upgrade playbook
Product:	[Red Hat Storage] Red Hat Gluster Storage	Reporter:	Arun Kumar <arukumar>
Component:	doc-Container_Native_Storage_with_OpenShift	Assignee:	Anjana KD <akrishna>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Arun Kumar <arukumar>
Severity:	high	Docs Contact:
Priority:	unspecified
Version:	ocs-3.11	CC:	akrishna, asriram, pprakash, puebele, rhs-bugs, rtalur, storage-doc, storage-qa-internal
Target Milestone:	---	Keywords:	ZStream
Target Release:	OCS 3.11.z Async
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-11-25 06:36:03 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:	1703695, 1709460

Description Arun Kumar 2019-10-09 10:39:51 UTC

Describe the issue: 
There are some new variables introduced that we need to mention in the inventory file for the successful upgrade of the OCS cluster using the upgrade playbook. we now need to document them in the documentation of upgrade playbook
 

1. openshift_storage_glusterfs_health_timeout=10 

Explanation: This variable limits the number of cluster health check retries. The variable value should be multiple of 10, 10 means one retry, 20 means 2 retries and this value should not be less than 10. By default value of this var is 30, so do not specify anything playbook will do 3 retries.
bug related to this: https://bugzilla.redhat.com/show_bug.cgi?id=1726608


2. openshift_storage_gluster_update_techpreview=true  

Explanation: The playbook is in tech preview. set this variable to true for using upgrade playbook.
bug related to this: https://bugzilla.redhat.com/show_bug.cgi?id=1748449


3. openshift_storage_glusterfs_fuse_version=<version>

Explanation: To upgrade nodes to specific client packages we need to mention the version of which you want to upgrade.
for eg. openshift_storage_glusterfs_fuse_version=-3.12.2-18.el7
bug related to this:https://bugzilla.redhat.com/show_bug.cgi?id=1694937

Comment 2 Arun Kumar 2019-10-14 09:26:06 UTC

There is one more variable 

4. openshift_storage_glusterfs_check_brick_size_health=false

Explanation: When the playbook is executing it checks for the brick capacity and while checking brick capacity we need to exclude some bricks from checking, these bricks are the bricks that are part of block hosting volume. For that purpose, we need to set the above variable to false in the inventory file.
bug related to this: https://bugzilla.redhat.com/show_bug.cgi?id=1726620

Comment 8 Anjana KD 2019-11-14 05:00:22 UTC

Have added the variables as chapter 7 https://access.redhat.com/documentation/en-us/red_hat_openshift_container_storage/3.11/html-single/deployment_guide/index?lb_target=preview#parameters_of_upgrade_playbook