Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.

RHEL Engineering is moving the tracking of its product development work on RHEL 6 through RHEL 9 to Red Hat Jira (issues.redhat.com). If you're a Red Hat customer, please continue to file support cases via the Red Hat customer portal. If you're not, please head to the "RHEL project" in Red Hat Jira and file new tickets here. Individual Bugzilla bugs in the statuses "NEW", "ASSIGNED", and "POST" are being migrated throughout September 2023. Bugs of Red Hat partners with an assigned Engineering Partner Manager (EPM) are migrated in late September as per pre-agreed dates. Bugs against components "kernel", "kernel-rt", and "kpatch" are only migrated if still in "NEW" or "ASSIGNED". If you cannot log in to RH Jira, please consult article #7032570. That failing, please send an e-mail to the RH Jira admins at rh-issues@redhat.com to troubleshoot your issue as a user management inquiry. The email creates a ServiceNow ticket with Red Hat. Individual Bugzilla bugs that are migrated will be moved to status "CLOSED", resolution "MIGRATED", and set with "MigratedToJIRA" in "Keywords". The link to the successor Jira issue will be found under "Links", have a little "two-footprint" icon next to it, and direct you to the "RHEL project" in Red Hat Jira (issue links are of type "https://issues.redhat.com/browse/RHEL-XXXX", where "X" is a digit). This same link will be available in a blue banner at the top of the page informing you that that bug has been migrated.

I needed to set up a GFS2 filesystem for a project, and tried to follow the RHEL9 document here:

https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/9/html/configuring_gfs2_file_systems/index

Unfortunately, this document seems to have regressed somewhat since earlier RHEL versions. It mentions how to create a GFS2 filesystem, but there is no reference to setting up the cluster itself or DLM to run within it. That might be part of the HA docs, but this document doesn't seem to reference them in any way.

It does say this in section 3.2:

"Before you can mount a GFS2 file system, the file system must exist, the volume where the file system exists must be activated, and the supporting clustering and locking systems must be started. After those requirements have been met, you can mount the GFS2 file system as you would any Linux file system."

...but there are no pointers to directions on how to set up the clustering and locking systems.

CCing Steven Levine. I think we should review how the GFS2 documentation is split into two parts:

1. https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/9/html/configuring_gfs2_file_systems/index
2. https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/9/html/configuring_and_managing_high_availability_clusters/assembly_configuring-gfs2-in-a-cluster-configuring-and-managing-high-availability-clusters

Really we want users to see and use the second one, as it describes how to set up our supported gfs2 configuration, but the first one is more prominent and that's the one that Jeff found and concluded was incomplete. Perhaps a link from (1) to (2) could be added in the near term and for a longer term goal we could discuss whether/how they could be restructured.

The GFS2 document on the Portal now includes the GFS2 cluster configuration procedures that are also in the HA title.  This is the same source text in both titles, so the information is identical.

RHEL 9, chapter 8:
https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/9/html-single/configuring_gfs2_file_systems/index

RHEL 8, also chapter 8.  The RHEL 8 chapter includes a section on migrating from RHEL 7 to RHEL 8.

https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/8/html-single/configuring_gfs2_file_systems/index