Bug 1886744 - [Test Day] [Doc] Mention the Red Hat Enterprise Linux 8 channels and commands required for upgrade
Summary: [Test Day] [Doc] Mention the Red Hat Enterprise Linux 8 channels and commands...
Keywords:
Status: CLOSED EOL
Alias: None
Product: Red Hat Gluster Storage
Classification: Red Hat Storage
Component: doc-Installation_Guide
Version: rhgs-3.5
Hardware: Unspecified
OS: Unspecified
unspecified
high
Target Milestone: ---
: ---
Assignee: Disha Walvekar
QA Contact: Vinayak Papnoi
URL:
Whiteboard:
Depends On:
Blocks: 1887323
TreeView+ depends on / blocked
 
Reported: 2020-10-09 10:11 UTC by Sayalee
Modified: 2023-11-25 05:38 UTC (History)
5 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2023-11-24 04:53:14 UTC
Embargoed:
puebele: needinfo+


Attachments (Terms of Use)

Description Sayalee 2020-10-09 10:11:51 UTC
Describe the issue:
------------------
The RHEL8 commands and channels required for upgrading RHGS are missing.


Suggestions for improvement:
----------------------------
Add the RHEL8 commands and channels required for upgrading RHGS.


Document URL:
------------
https://access.redhat.com/documentation/en-us/red_hat_gluster_storage/3.5/html/installation_guide/chap-upgrading_red_hat_storage


Chapter/Section Number and Title:
---------------------------------

(1) 
Chapter - 5.1.1. Upgrading to Red Hat Gluster Storage 3.5 for Systems Subscribed to Red Hat Subscription Manager
Section - Procedure 5.2. Upgrade using yum
Sub-section - 1. If you use Samba: 
Issue - Only subscription channels for RHEL 7 and RHEL 6  are mentioned.
Change required - Add the subscription channels for RHEL 8 as well.


(2) 
Chapter - 5.1.1. Upgrading to Red Hat Gluster Storage 3.5 for Systems Subscribed to Red Hat Subscription Manager
Section - Procedure 5.2. Upgrade using yum
Sub-section - 1. If you use Samba: 
Issue - Under "Stop the CTDB and SMB services." no mention about RHEL8
Change required - Add command to stop the services on RHEL8 as well.


(3) 
Chapter - 5.1.1. Upgrading to Red Hat Gluster Storage 3.5 for Systems Subscribed to Red Hat Subscription Manager
Section - Procedure 5.2. Upgrade using yum
Sub-section - 12. If you use Samba: 
Issue - Under "iii) If all servers that host volumes accessed via SMB have been updated, then start the CTDB and Samba services by executing the following commands." ; no command for RHEL8 is present.
Change required - Add command to start the services on RHEL8 as well.


(4)
Chapter - 5.1.2. Upgrading to Red Hat Gluster Storage 3.5 for Systems Subscribed to Red Hat Network Satellite Server
Section - Procedure 5.4. Upgrade using Satellite
Sub-section - 1. Create an Activation Key at the Red Hat Network Satellite Server, and associate it with the following channels.
Issue - Channels for RHEL8 are missing.
Change required - Add channels for RHEL8


(5)
Chapter - 5.1.2. Upgrading to Red Hat Gluster Storage 3.5 for Systems Subscribed to Red Hat Network Satellite Server
Section - Procedure 5.4. Upgrade using Satellite
Sub-section -Verify that the channel subscriptions have been updated.
Issue - No check for RHEL8 is present.
Change required - Add check for RHEL8 channels.


(6)
Chapter - 5.2.1. Pre-upgrade Tasks
Section - 5.2.1.1. Upgrade Requirements for Red Hat Gluster Storage 3.5
Sub-section - "Ensure the Red Hat Gluster Storage server is registered to the required channels."
Issue - No check for RHEL8 is present.
Change required - Add check for RHEL8 channels.


(7)
Chapter - 5.2.4. Special Consideration for In-Service Software Upgrade
Section - 5.2.4.1. In-Service Software Upgrade for a CTDB Setup
Sub-section -  1. Stop the CTDB service on the Red Hat Gluster Storage node using the following command on each node of the CTDB cluster: 
Issue - Command to stop services on RHEL8 is missing.
Change required - Add command to stop services on RHEL8 as well.
 

Product Version:
----------------
RHGS 3.5

Comment 2 Sayalee 2021-02-10 15:09:39 UTC
Hello Disha, please find the RHEL8 commands for the respective chapters below:

> Document URL:
> ------------
> https://access.redhat.com/documentation/en-us/red_hat_gluster_storage/3.5/
> html/installation_guide/chap-upgrading_red_hat_storage


> 
> (1) 
> Chapter - 5.1.1. Upgrading to Red Hat Gluster Storage 3.5 for Systems
> Subscribed to Red Hat Subscription Manager
> Section - Procedure 5.2. Upgrade using yum
> Sub-section - 1. If you use Samba: 
> Issue - Only subscription channels for RHEL 7 and RHEL 6  are mentioned.
> Change required - Add the subscription channels for RHEL 8 as well.

""
For Red Hat Enterprise Linux 8, enable the following repository: 

subscription-manager repos --enable=rh-gluster-3-samba-for-rhel-8-x86_64-rpms
""

#########################################################################################

> (2) 
> Chapter - 5.1.1. Upgrading to Red Hat Gluster Storage 3.5 for Systems
> Subscribed to Red Hat Subscription Manager
> Section - Procedure 5.2. Upgrade using yum
> Sub-section - 1. If you use Samba: 
> Issue - Under "Stop the CTDB and SMB services." no mention about RHEL8
> Change required - Add command to stop the services on RHEL8 as well.

""
On Red Hat Enterprise Linux 7 and Red Hat Enterprise Linux 8:
# systemctl stop ctdb
""

#########################################################################################

> (3) 
> Chapter - 5.1.1. Upgrading to Red Hat Gluster Storage 3.5 for Systems
> Subscribed to Red Hat Subscription Manager
> Section - Procedure 5.2. Upgrade using yum
> Sub-section - 12. If you use Samba: 
> Issue - Under "iii) If all servers that host volumes accessed via SMB have
> been updated, then start the CTDB and Samba services by executing the
> following commands." ; no command for RHEL8 is present.
> Change required - Add command to start the services on RHEL8 as well.

""
On Red Hat Enterprise Linux 7 and Red Hat Enterprise Linux 8:
# systemctl start ctdb
""

#########################################################################################
 
> (4)
> Chapter - 5.1.2. Upgrading to Red Hat Gluster Storage 3.5 for Systems
> Subscribed to Red Hat Network Satellite Server
> Section - Procedure 5.4. Upgrade using Satellite
> Sub-section - 1. Create an Activation Key at the Red Hat Network Satellite
> Server, and associate it with the following channels.
> Issue - Channels for RHEL8 are missing.
> Change required - Add channels for RHEL8


The channels required for RHEL8 need to be tested by QE, we can leave it as it is as of now.
Will raise a new bug for these doc changes once the channels are validated.

#########################################################################################

 
> (5)
> Chapter - 5.1.2. Upgrading to Red Hat Gluster Storage 3.5 for Systems
> Subscribed to Red Hat Network Satellite Server
> Section - Procedure 5.4. Upgrade using Satellite
> Sub-section -Verify that the channel subscriptions have been updated.
> Issue - No check for RHEL8 is present.
> Change required - Add check for RHEL8 channels.


The channels required for RHEL8 need to be tested by QE, we can leave it as it is as of now.
Will raise a new bug for these doc changes once the channels are validated.

#########################################################################################

> (6)
> Chapter - 5.2.1. Pre-upgrade Tasks
> Section - 5.2.1.1. Upgrade Requirements for Red Hat Gluster Storage 3.5
> Sub-section - "Ensure the Red Hat Gluster Storage server is registered to
> the required channels."
> Issue - No check for RHEL8 is present.
> Change required - Add check for RHEL8 channels.

""
On Red Hat Enterprise Linux 8:
rhel-8-for-x86_64-baseos-rpms
rhel-8-for-x86_64-appstream-rpms
rh-gluster-3-for-rhel-8-x86_64-rpms
""

#########################################################################################
 
> (7)
> Chapter - 5.2.4. Special Consideration for In-Service Software Upgrade
> Section - 5.2.4.1. In-Service Software Upgrade for a CTDB Setup
> Sub-section -  1. Stop the CTDB service on the Red Hat Gluster Storage node
> using the following command on each node of the CTDB cluster: 
> Issue - Command to stop services on RHEL8 is missing.
> Change required - Add command to stop services on RHEL8 as well.


There are multiple changes needed here:

* First of all the issue with "5.2.4.1. In-Service Software Upgrade for a CTDB Setup" has been resolved;
  and there is no such point present any more in the installation guide.

* After that we need to do following changes:

1. Remove "5.2.4.1. Migrate CTDB configuration files" and "5.2.4.2. Verifying In-Service Software Upgrade"
2. Put a Note in the beginning of "5.2.3. In-Service Software Upgrade" as >> "Only offline mode is supported for samba."
3. Move "5.2.4.1. Migrate CTDB configuration files" and add a new point to "5.1. Offline Upgrade to Red Hat Gluster Storage 3.5" as "5.1.3" as below-
"""
5.1.3 Special consideration for Offline Software Upgrade
5.1.3.1 Migrate CTDB configuration files
If upgrading CTDB to 4.9.x and beyond from an older version of ctbd please follow the below steps post upgrade"""
[Note : Add the 8 points from 5.2.4.1. here]
"""

After doing all this, 
"5.2.4.3. Upgrading the Native Client" will become "5.2.4.1. Upgrading the Native Client"

#########################################################################################

@ Disha,

If there any queries, please let me know, we can discuss over call.

Comment 5 Vinayak Papnoi 2021-03-30 10:02:32 UTC
All the changes suggested in the  Comment #2 have been successfully incorporated in the preview links provided in the Comment #3.
Moving the bug to VERIFIED.


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