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.
Document URL:
https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/7/html/Logical_Volume_Manager_Administration/fsgrow_overview.html
Section Number and Name:
3.3. GROWING A FILE SYSTEM ON A LOGICAL VOLUME
Describe the issue:
The process to grow a filesystem appears to be incorrect.
Text reads:
"To grow a file system on a logical volume, perform the following steps:
1. Make a new physical volume.
2. Extend the volume group that contains the logical volume with the file system you are growing to include the new physical volume.
3. Extend the logical volume to include the new physical volume.
4. Grow the file system.
If you have sufficient unallocated space in the volume group, you can use that space to extend the logical volume instead of performing steps 1 and 2."
This section seems inaccurate as it suggests adding a new physical volume, extending the vg. then growing the LV with a new PV.
Step 3 also directs extending the LV with a new PV which is not possible as a PV can only be added to a VG.
Suggestions for improvement:
It may be clearer to first check if the VG has sufficient space to extend the LV. If so, run the appropriate command (e.g., lvresize -r -L +xG... ). If not, direct the reader to the process to extend the VG with a new PV.
Suggested sequence:
1) Determine if the VG has sufficient space to extend the LV. If not, follow the process to create a new PV and extend the VG.
2. If there is sufficient space in the VG, extend the LV.
3. Resize the filesystem on the LV.
Note that 2 & 3 can often be completed in a single step.
Additional information:
Comment 5Jonathan Earl Brassow
2016-06-03 15:24:27 UTC
Sure, the statements could use some love. What the reporter suggests could improve things and is also correct.
Jonathan found a couple of small errors, now fixed, and approved the updates.
The procedure in the document has been updated:
To grow a file system on a logical volume, perform the following steps:
1. Determine whether there is sufficient unallocated space in the existing volume group to extend the logical volume. If not, perform the following procedure:
1. Create a new physical volume with the pvcreate command.
2. Use the vgextend command to extend the volume group that contains the logical volume with the file system you are growing to include the new physical volume.
2. Once the volume group is large enough to include the larger file system, extend the logical volume with the lvresize command.
3. Resize the file system on the logical volume.
Note that you can use the -r option of the lvresize command to extend the logical volume and resize the underlying file system with a single command