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
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.
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.