Bug 1614365 - [GSS] RHV+RHGS in-service upgrade missing
Summary: [GSS] RHV+RHGS in-service upgrade missing
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Gluster Storage
Classification: Red Hat Storage
Component: doc-Installation_Guide
Version: rhgs-3.3
Hardware: x86_64
OS: Linux
medium
high
Target Milestone: ---
: RHGS 3.4.z Batch Update 2
Assignee: Laura Bailey
QA Contact: SATHEESARAN
URL:
Whiteboard:
Depends On:
Blocks: 1650394
TreeView+ depends on / blocked
 
Reported: 2018-08-09 13:45 UTC by Bipin Kunal
Modified: 2022-03-13 15:22 UTC (History)
15 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2018-12-28 10:22:01 UTC
Embargoed:


Attachments (Terms of Use)

Description Bipin Kunal 2018-08-09 13:45:09 UTC
Document URL: 
https://access.redhat.com/documentation/en-us/red_hat_gluster_storage/3.3/html-single/installation_guide/#chap-RHEV_RHS

Doc doesn't talk about an in-service upgrade.

We need to ensure that those are well documented and tested.

Section Number and Name: 
Chapter 9. Upgrading from Red Hat Gluster Storage 3.2 to Red Hat Gluster Storage 3.3 in a Red Hat Enterprise Virtualization-Red Hat Gluster Storage Environment


Describe the issue: 
This section talks about 2 upgrade methods. Both offline upgrade method.

Suggestions for improvement: 
1) Add in-service upgrade to the doc
2) Some improvement is needed in the existing offline section as well.

Additional information: 
Taking in terms of point (2) i.e improvement wrt to the existing section.

9.2. Upgrading using yum

in this section there is a note :

==================================================
Note

Re-installation of Red Hat Gluster Storage nodes is required, as the network configurations and bootstrapping configurations done prior to upgrade are preserved, unlike ISO upgrade.

==================================================

Do we really intend to say, re-installation is needed? Looks like a typo to me.


In the same section we say:
==================================================
Upgrade the native client bits for Red Hat Enterprise Linux 6 or Red Hat Enterprise Linux 7, based on the Red Hat Enterprise Linux server hypervisor used.
==================================================

But we don't point to the section which provides steps on how that should be done.

Comment 12 SATHEESARAN 2018-10-23 08:12:34 UTC
In-service software upgrade for RHV-RHGS component is very much required. The bug is already devel_acked, which denotes the doc work is already in progress.

Doc verification could be done for this release the bug is targeted for. Providing the qa_ack

Comment 17 SATHEESARAN 2018-10-28 01:08:45 UTC
As Sahina has mentioned most of the items can be borrowed from RHHI guide. But let me draw a outline here:

In-Service Software upgrade for RHV-RHGS environment
----------------------------------------------------- 
1. Start upgrading the RHGS Nodes one after other following In-Service Software upgrade procedure of RHGS.
    a. Put one of the RHGS node serving the replica set, in to maintenance from RHV Manager UI
    b. Perform upgrade on that RHGS node
    c. Reboot the node
    d. Activate the node from RHV Manager UI
    e. Repeat it for other hosts in that replica set

2. Update the gluster clients on Virtualization hosts
Virtualization hosts that could be used can be with Red Hat Virtualization(RHVH) host or RHEL hosts

In the case of Red Hat Virtualization host,
    a. Perform upgrade from RHV Manager UI, click on 'upgrade' from RHV Manager UI, which will eventually move the host in to maintenance, then update to the latest redhat-virtualization-host-image update, which contains all the required glusterfs clients packages, reboots the node, and activates the node back in RHV Manager UI

In case of RHEL hosts, update the glusterfs client,
a. Move the hosts in to maintenance
b. Make sure this RHEL host has access to required channels to  update to latest glusterfs clients
c. Perform update # yum update
d. Activate the host from RHV Manager UI


@Sahina, Could you verify the technical correctness of the above outline ?

Comment 24 Sahina Bose 2018-10-30 05:46:09 UTC
(In reply to SATHEESARAN from comment #17)
> As Sahina has mentioned most of the items can be borrowed from RHHI guide.
> But let me draw a outline here:
> 
> In-Service Software upgrade for RHV-RHGS environment
> ----------------------------------------------------- 
> 1. Start upgrading the RHGS Nodes one after other following In-Service
> Software upgrade procedure of RHGS.
>     a. Put one of the RHGS node serving the replica set, in to maintenance
> from RHV Manager UI

-- Ensure gluster processes are stopped when moving node to maintenance

>     b. Perform upgrade on that RHGS node
>     c. Reboot the node
>     d. Activate the node from RHV Manager UI
>     e. Repeat it for other hosts in that replica set
> 
> 2. Update the gluster clients on Virtualization hosts
> Virtualization hosts that could be used can be with Red Hat
> Virtualization(RHVH) host or RHEL hosts
> 
> In the case of Red Hat Virtualization host,
>     a. Perform upgrade from RHV Manager UI, click on 'upgrade' from RHV
> Manager UI, which will eventually move the host in to maintenance, then
> update to the latest redhat-virtualization-host-image update, which contains
> all the required glusterfs clients packages, reboots the node, and activates
> the node back in RHV Manager UI
> 
> In case of RHEL hosts, update the glusterfs client,
> a. Move the hosts in to maintenance
> b. Make sure this RHEL host has access to required channels to  update to
> latest glusterfs clients
> c. Perform update # yum update
> d. Activate the host from RHV Manager UI
> 
> 
> @Sahina, Could you verify the technical correctness of the above outline ?

Looks good. (one minor edit)

Comment 29 SATHEESARAN 2018-12-07 17:05:36 UTC
Verified the doc content for updating RHV-RHGS environment. The content looks good


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