Bug 588374 - gfs2_convert manpage and documentation updates
Summary: gfs2_convert manpage and documentation updates
Status: CLOSED ERRATA
Alias: None
Product: Red Hat Enterprise Linux 5
Classification: Red Hat
Component: gfs2-utils
Version: 5.6
Hardware: All
OS: Linux
low
medium
Target Milestone: rc
: ---
Assignee: Abhijith Das
QA Contact: Cluster QE
URL:
Whiteboard:
Keywords: Documentation
Depends On:
Blocks: 594510 601315 605371
TreeView+ depends on / blocked
 
Reported: 2010-05-03 15:23 UTC by Abhijith Das
Modified: 2011-01-13 23:20 UTC (History)
5 users (show)

(edit)
Clone Of:
: 594510 601315 (view as bug list)
(edit)
Last Closed: 2011-01-13 23:20:28 UTC


Attachments (Terms of Use)
manpage update to document recent changes to gfs2_convert (1.75 KB, patch)
2010-05-20 20:37 UTC, Abhijith Das
no flags Details | Diff


External Trackers
Tracker ID Priority Status Summary Last Updated
Red Hat Product Errata RHBA-2011:0135 normal SHIPPED_LIVE gfs2-utils bug fix update 2011-01-12 19:26:41 UTC

Description Abhijith Das 2010-05-03 15:23:29 UTC
The recent fixes/updates to gfs2_convert changes its behavior in a few cases such as handling of CDPNs, converting full filesystems etc. This needs to be documented in the manpage and the gfs2-utils documentation.

Comment 1 Steven J. Levine 2010-05-20 20:11:41 UTC
Abhi:

Just for reference (to keep this info attached to this bug), here's the current RHEL 5 gfs2_convert documentation. I'll need to run it by you for review.

http://documentation-stage.bne.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5/html/Global_File_System_2/gfs_upgrade.html

Here's the RHEL 6 version (for completeness's sake):

http://documentation-stage.bne.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/6/html/Global_File_System_2/gfs_upgrade.html

Comment 2 Abhijith Das 2010-05-20 20:37:46 UTC
Created attachment 415505 [details]
manpage update to document recent changes to gfs2_convert

Comment 3 Steven J. Levine 2010-05-20 21:23:05 UTC
Abhi: 

Is this for 6.0 as well?

I'll file a separate bug to update the gfs2 document for 5.6, to add these additional caveats.

I'm not sure if you were looking for an edit of the updates to the man page, or just feedback on the clarity of the information. It all seems clear enough to me, but I might slightly change these wordings (although they are not incorrect, per se):

> It is possible to reissue the gfs2_convert command on such a filesystem to
> completely convert it to GFS2.

The "it is possible to" is a little unclear. It may be possible to reissue the command, but is that what we're saying is the procedure?  Maybe something like:

  When this occurs, reissue the gfs2_convert command on the partially converted
  filesystem to complete the conversion process.

> The administrator can use bind mounts on these directories to get
> the same effect of CDPNs.

Very tiny, but I'd say "as CDPNs" rather than "of CDPNs".

As I say, I'll open a separate bug for my document for 5.6. If this information applies to 6.0, I'll open a bug for that as well.

Comment 4 Steven J. Levine 2010-05-21 17:21:56 UTC
The new bug for the GFS2 manual is BZ#594510

Comment 5 Robert Peterson 2010-09-17 15:54:29 UTC
Build 2768496 successful.  Changing status to Modified.
This fix is in gfs2-utils-0.1.62-25.el5.

Note that the patch in distcvs does not match the patch in git.
The patch in git fixes gfs-utils and gfs2-utils, but crossing
components is not allowed in cvs since they are two separate
rpms.  Therefore the patch in distcvs is only the gfs2 portion.
We will likely have to do another build for gfs-utils to
build the gfs-utils half of the git patch.  Depending on brew
and such, we may need to temporarily reset the bug back to POST.

Comment 7 Nate Straz 2010-12-03 14:47:02 UTC
Verified new language is in the gfs2_convert man page in gfs2-utils-0.1.62-28.el5.

Comment 9 errata-xmlrpc 2011-01-13 23:20:28 UTC
An advisory has been issued which should help the problem
described in this bug report. This report is therefore being
closed with a resolution of ERRATA. For more information
on therefore solution and/or where to find the updated files,
please follow the link below. You may reopen this bug report
if the solution does not work for you.

http://rhn.redhat.com/errata/RHBA-2011-0135.html


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