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.
Bug 601977 - Please document the usage of '--fsoptions' for the 'part|partition' kickstart option in the install guide.
Summary: Please document the usage of '--fsoptions' for the 'part|partition' kickstart...
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Enterprise Linux 6
Classification: Red Hat
Component: doc-Installation_Guide
Version: 6.0
Hardware: All
OS: Linux
low
medium
Target Milestone: rc
: ---
Assignee: Ruediger Landmann
QA Contact:
URL:
Whiteboard:
Depends On: 600298
Blocks: 601980
TreeView+ depends on / blocked
 
Reported: 2010-06-08 23:46 UTC by Michael Hideo
Modified: 2010-11-11 15:34 UTC (History)
5 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of: 600298
: 601980 (view as bug list)
Environment:
Last Closed: 2010-11-11 15:34:00 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)

Description Michael Hideo 2010-06-08 23:46:26 UTC
+++ This bug was initially created as a clone of Bug #600298 +++

Description of problem:
Kickstart documentation in the "RHEL Installation Guide" does not document the
'part|partition' option's "--fsoptions" option.

Version-Release number of selected component (if applicable):
RHEL 5.5 and earlier.

How reproducible:
100%

Steps to Reproduce:
1. Read the installation guide's section on kickstart from start to finish.
2. Read through it again looking for a way to specify mount options.
3. Observe that there isn't any such option documented for the 'part' option.

Actual results:
Write your own ugly script in %post to munge fstab because you can't find a
built in method to specify mount options.  Hit corner cases that don't quite work right and have to special case them while your nose hairs fall out.  ;o)

Accidentally stumble upon the --fsoptions option documented in the 'raid' and 'logvol' options, and then notice it also on the Fedoraproject website anaconda documentation.

Test the option out in a dummy kickstart install and discover that it actually works with 'part' and not just with 'raid' and 'logvol'.  Rejoice and remove a screenful of unnecessary bash scripting from %post.  ;o)


Expected results:
For --fsoptions to be documented under the 'part' option, and any other missing options that there might be left to discover. ;o)


Additional info:
I'd paste my fstab_munge() function here for completeness but it'd make you barf.

--- Additional comment from clumens on 2010-06-04 13:09:15 EDT ---

Here's what docs/kickstart-docs.txt on rhel5-branch has to say:

       --fsoptions=

           Specifies a free form string of options to be used when
           mounting the filesystem. This string will be copied into the
           /etc/fstab file of the installed system and should be enclosed
           in quotes.

--- Additional comment from mharris on 2010-06-05 06:51:29 EDT ---

I probably didn't file this bug report against the right component as it is technically not an anaconda bug.  The problem is specifically the RHEL 5 Installation Guide does not mention the option, so anyone using that as their basis for writing a kickstart file, will not see the --fsoptions documented for the 'part' command, and may resort to writing their own /etc/fstab mangling routines in %post.  When I discovered this and mentioned it in IRC, 3 or 4 other competent admins mentioned that they did the same type of mangling and were happy to find out about --fsoptions.

It is good that it is documented elsewhere, but all documentation should be consistent.  I suspect most admins, in particular newer admins will look either directly in the RHEL Installation Guide, or to Google, and "docs/kickstart.txt" doesn't come up high in the search list.  ;o)

I'll try to reassign this to the proper component if I can figure that out.

--- Additional comment from mharris on 2010-06-05 06:53:11 EDT ---

Doh, my bad...  I didn't notice it was already reassigned.  Good stuff.  Now that I'm aware of the option, this isn't for me, but rather for other admins out there who might not ever go looking beyond the installation guide for kickstart documentation.  It's a minor issue, but would still be nice to see it fixed in the next documentation update.

Comment 1 Ruediger Landmann 2010-06-21 06:43:58 UTC
Fixed in build 0-64 onwards

Comment 3 releng-rhel@redhat.com 2010-11-11 15:34:00 UTC
Red Hat Enterprise Linux 6.0 is now available and should resolve
the problem described in this bug report. This report is therefore being closed
with a resolution of CURRENTRELEASE. You may reopen this bug report if the
solution does not work for you.


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