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 815680 - Update of man page to reflect new thinp functionality
Summary: Update of man page to reflect new thinp functionality
Keywords:
Status: CLOSED ERRATA
Alias: None
Product: Red Hat Enterprise Linux 6
Classification: Red Hat
Component: lvm2
Version: 6.3
Hardware: Unspecified
OS: Unspecified
high
low
Target Milestone: rc
: ---
Assignee: LVM and device-mapper development team
QA Contact: Cluster QE
URL:
Whiteboard:
Depends On:
Blocks: 1119576
TreeView+ depends on / blocked
 
Reported: 2012-04-24 09:02 UTC by Nenad Peric
Modified: 2014-10-14 08:22 UTC (History)
13 users (show)

Fixed In Version: lvm2-2.02.107-2.el6
Doc Type: Enhancement
Doc Text:
Man pages have been added to cover the LVM topics of thin-provisioning and caching (i.e. "tiered storage"). The new man pages are 'lvmthin(7)' and 'lvmcache(7)'.
Clone Of:
Environment:
Last Closed: 2014-10-14 08:22:54 UTC
Target Upstream Version:
Embargoed:

Attachments (Terms of Use)


Links
System ID Private Priority Status Summary Last Updated
Red Hat Product Errata RHBA-2014:1387 0 normal SHIPPED_LIVE lvm2 bug fix and enhancement update 2014-10-14 01:39:47 UTC

Description Nenad Peric 2012-04-24 09:02:02 UTC 
Description of problem:

The current man pages are not descriptive enough to cover all the functionality and intricacies of thin provisioning. 

A suggested man page update was proposed in Bug #773507 which would provide for more space and better explanation of the new functionality. 


A copy of comment #17 follows:

-------

I've discussed some variations of man page part for thinp with Nate and we came
up with a suggestion on how to make things much clearer in MAN of lvcreate:
It will make the whole thinp idea more coherent and will avoid "chicken and the
egg" confusion some people who dive right in might experience. 


-T, --thin, --thinpool ThinPoolLogicalVolume{Name|Path}
    Creates  thin  pool or thin logical volume or both. See THIN PROVISIONING.




...

THIN PROVISIONING

Thin provisioning allows for the creation of logical volumes larger than
available extents.  First create a pool then create a volume in the pool.

To create a thin pool ...
    Options, examples, interaction with other LVM options

To create a logical volume in the thin pool...
    Options, examples, interaction with other LVM options 

To create a thin logical volume and pool at the same time... 
    Options, examples, interaction with other LVM options
Comment 2 Zdenek Kabelac 2012-04-24 11:24:22 UTC 
Hmm - it doesn't fit current layout of lvcreate man page - since we don't have separate section for mirrors/raids, snapshot.

I'd still prefer to keep things described rather with option itself.
Otherwise the man-page might start to look probably even less readable than it's today i.e. having multiple example sections...

Would there be also proposal to preserve current layout ?

(Since there might be in future some tool to generate man page from set of options)
Comment 3 Nenad Peric 2012-04-24 12:50:35 UTC 
The layout with a separate section was just a suggestion for making the description of thin provisioning works separate actually from the options themselves, to try and maybe avoid some cluttering of text. 

Any kind of more detailed description of what the options do, how they combine  and what is the idea behind lvm thin provisioning (possibly with a few nice examples) would be all-right I suppose.
Comment 4 RHEL Program Management 2012-05-03 05:22:07 UTC 
Since RHEL 6.3 External Beta has begun, and this bug remains
unresolved, it has been rejected as it is not proposed as
exception or blocker.

Red Hat invites you to ask your support representative to
propose this request, if appropriate and relevant, in the
next release of Red Hat Enterprise Linux.
Comment 6 RHEL Program Management 2012-07-10 08:25:17 UTC 
This request was not resolved in time for the current release.
Red Hat invites you to ask your support representative to
propose this request, if still desired, for consideration in
the next release of Red Hat Enterprise Linux.
Comment 7 RHEL Program Management 2012-07-10 23:57:44 UTC 
This request was erroneously removed from consideration in Red Hat Enterprise Linux 6.4, which is currently under development.  This request will be evaluated for inclusion in Red Hat Enterprise Linux 6.4.
Comment 12 Zdenek Kabelac 2014-06-09 11:35:10 UTC 
Latest release of  lvm2  provides:

man  lvmthin

and same will apply to cache support:

man lvmcache


These pages will provide more in-depth description of thin and cache functionality with another set of examples.
Comment 23 Nenad Peric 2014-07-22 12:46:46 UTC 
Detailed man pages of lvm thin provisioning and lvm caching have been created as lvmcaache and lvmthin.
They are referred to at the end of the following man pages as well:

/usr/share/man/man8/lvm.8.gz
/usr/share/man/man8/lvconvert.8.gz
/usr/share/man/man8/lvchange.8.gz
/usr/share/man/man8/lvcreate.8.gz

and the main man pages:

/usr/share/man/man7/lvmcache.7.gz
/usr/share/man/man7/lvmthin.7.gz

Marking VERIFIED with:

lvm2-2.02.107-2.el6    BUILT: Fri Jul 11 15:47:33 CEST 2014
lvm2-libs-2.02.107-2.el6    BUILT: Fri Jul 11 15:47:33 CEST 2014
lvm2-cluster-2.02.107-2.el6    BUILT: Fri Jul 11 15:47:33 CEST 2014
udev-147-2.56.el6    BUILT: Fri Jul 11 16:53:07 CEST 2014
device-mapper-1.02.86-2.el6    BUILT: Fri Jul 11 15:47:33 CEST 2014
device-mapper-libs-1.02.86-2.el6    BUILT: Fri Jul 11 15:47:33 CEST 2014
device-mapper-event-1.02.86-2.el6    BUILT: Fri Jul 11 15:47:33 CEST 2014
device-mapper-event-libs-1.02.86-2.el6    BUILT: Fri Jul 11 15:47:33 CEST 2014
device-mapper-persistent-data-0.3.2-1.el6    BUILT: Fri Apr  4 15:43:06 CEST 2014
cmirror-2.02.107-2.el6    BUILT: Fri Jul 11 15:47:33 CEST 2014
Comment 25 errata-xmlrpc 2014-10-14 08:22:54 UTC 
Since the problem described in this bug report should be
resolved in a recent advisory, it has been closed with a
resolution of ERRATA.

For information on the advisory, and where to find the updated
files, follow the link below.

If the solution does not work for you, open a new bug report.

http://rhn.redhat.com/errata/RHBA-2014-1387.html
Note You need to log in before you can comment on or make changes to this bug.