Bug 1636187

Summary: reference upgrade procedure for RHGSWA 3.4.1 from main upgrade section
Product: [Red Hat Storage] Red Hat Gluster Storage Reporter: Martin Bukatovic <mbukatov>
Component: doc-Installation_GuideAssignee: Rakesh <rghatvis>
doc-Installation_Guide sub component: Default QA Contact: Daniel Horák <dahorak>
Status: CLOSED CURRENTRELEASE Docs Contact:
Severity: unspecified    
Priority: unspecified CC: asriram, dahorak, mbukatov, nlevinki, pmulay, rcyriac, rhinduja, rhs-bugs, rmusil, rwheeler, storage-doc
Version: rhgs-3.4Keywords: ZStream
Target Milestone: ---   
Target Release: RHGS 3.4.z Batch Update 1   
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: 2018-10-31 13:18:49 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: 1631264    

Description Martin Bukatovic 2018-10-04 16:38:43 UTC 
Document URL
============

https://access.qa.redhat.com/documentation/en-us/red_hat_gluster_storage/3.4/html-single/installation_guide/

Section Number and Name
=======================

Can't provide number and name, there is no section which discuss upgrade
from RHGS 3.4.0 to RHGS 3.4.1 yet.

Describe the issue
==================

WA is component of RHGS product, and is expected to be updated at the same
time when gluster is updated. For this reason, we need to reference/link to
WA upgrade section from the main gluster upgrade docs, so that customer
would not miss extra steps needed to upgrade WA.

WA upgrade steps will be provided in WA guide, see BZ 1631264.

Suggestions for improvement
===========================

At suitable place, add statement stating something like this:

If you use Red Hat Gluster Storage Web Administration, follow extra upgrade
steps in section TODO of WA guide.

Additional information
======================

This bug is created based on discussion with Atin, Nishanth and me.

Suitable place for this reference needs to be agreed based on doc and eng
team discussion.
Comment 6 Martin Bukatovic 2018-10-17 07:43:18 UTC 
Based on the following conflict, moving this back to assigned:

Notes linking to WA upgrade text are in "7.3. In-service Software Update
from Red Hat Gluster Storage" section, but the WA text talks are links back
to "7.2. Updating Red Hat Gluster Storage in the Offline Mode" section.

Note that there are more problems (see comment 4 for details).
Comment 8 Rakesh 2018-10-19 08:35:17 UTC 
Martin, please review these changes and validate if it aligns with what we discussed. If there are any deviations, please bring it to my attention and I shall update it accordingly.
Comment 12 Daniel Horák 2018-10-24 17:30:42 UTC 
Red Hat Gluster Storage Installation Guide - chapter 7.2. Updating Red Hat
Gluster Storage in the Offline Mode contains proper references to WA Quick
Start Guide - chapter 4.2. Red Hat Gluster Storage Web Administration 3.4.x to
3.4.y.

* At the beginning, explaining the full update process for RHGS and WA.
* And also at the end reminding to return to the WA GSQ and finish the update
  on WA Server.

The chapter 7.2. Updating Red Hat Gluster Storage in the Offline Mode in RHGS
Installation Guide requires some updates, but they are not related to WA.

>> VERIFIED