Bug 498292
Summary: | Clarify GFS2 documentation on adding journals | ||
---|---|---|---|
Product: | Red Hat Enterprise Linux 5 | Reporter: | Steven J. Levine <slevine> |
Component: | Documentation-cluster | Assignee: | Steven J. Levine <slevine> |
Status: | CLOSED NOTABUG | QA Contact: | Content Services Development <ecs-dev-list> |
Severity: | medium | Docs Contact: | |
Priority: | low | ||
Version: | 5.4 | CC: | cluster-maint, edamato, slevine, swhiteho |
Target Milestone: | rc | Keywords: | Documentation |
Target Release: | --- | ||
Hardware: | All | ||
OS: | Linux | ||
Whiteboard: | |||
Fixed In Version: | Doc Type: | Bug Fix | |
Doc Text: | Story Points: | --- | |
Clone Of: | Environment: | ||
Last Closed: | 2009-09-03 16:45:39 UTC | Type: | --- |
Regression: | --- | Mount Type: | --- |
Documentation: | --- | CRM: | |
Verified Versions: | Category: | --- | |
oVirt Team: | --- | RHEL 7.3 requirements from Atomic Host: | |
Cloudforms Team: | --- | Target Upstream Version: | |
Embargoed: |
Description
Steven J. Levine
2009-04-29 18:38:20 UTC
I've been looking at how to add this information to the GFS2 manual. There's a section a the beginning of the document that lists the operational differences between GFS and GFS2, and that's where I think specific comparisons between the file systems belong (rather than in the general admin. documentation). There already exists a bullet point about how you can add journals dynamically in GFS2 because journals are files rather than "embedded metadata" (I must have gotten that phrase from an early spec), but I have rewritten this slightly to emphasize the difference in how you add journals in the two file systems and to note that there must be space on a file system to add a journal dynamically. The working draft now says this under the heading "Adding Journals Dynamically" " In GFS file systems, journals are embedded metadata that exists outside of the file system, making it necessary to extend the size of the logical volume that contains the file system before adding journals. In GFS2 file systems, journals are plain (though hidden) files. This means that for GFS2 file systems, journals can be dynamically added as additional servers mount a filesystem, as long as space remains on the file system for the additional journals. For information on adding journals to a GFS2 file system, see Adding Journals to a File System." In the section on gfs2_jadd, I have added a note. This bug suggests that add two boxes -- a warning and a note -- but technically a warning contains information that will prevent you from damaging your file system or data. I don't think a failing gfs2_jadd command quite fits this, so I've put the new information into a note that says this (as a first draft): "NOTE If a GFS2 file system is full, the gfs2_jadd will fail, even if the logical volume containing the file system has been extended and is larger than the file system. This is because in a GFS2 file system, journals are plain files rather than embedded metadata, so simply extending the underlying logical volume will not provide space for the journals." I will shortly be sending out the updated GFS2 manual for review (for RHEL 5.4) and I will be sure to include Eduardo on the review list. With the release of RHEL 5.4, I am closing this bug. |