Bug 463828 - LVM Admin Guide: incorrect information about stripe size limits
Summary: LVM Admin Guide: incorrect information about stripe size limits
Keywords:
Status: CLOSED NOTABUG
Alias: None
Product: Red Hat Enterprise Linux 5
Classification: Red Hat
Component: Documentation
Version: 5.1
Hardware: All
OS: Linux
medium
medium
Target Milestone: rc
: ---
Assignee: Steven J. Levine
QA Contact: Content Services Development
URL:
Whiteboard:
Depends On:
Blocks: 465305
TreeView+ depends on / blocked
 
Reported: 2008-09-24 20:14 UTC by Bryn M. Reeves
Modified: 2018-10-19 23:50 UTC (History)
2 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2009-02-25 23:32:21 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)

Description Bryn M. Reeves 2008-09-24 20:14:11 UTC
Description of problem:
The LVM2 administrators guide incorrectly states that the stripe size of LVM2 volumes is limited to a power of 2 between 4kB and 512kB (p35). This is also present in the online version:

http://www.redhat.com/docs/manuals/enterprise/RHEL-5-manual/en-US/RHEL510/pdf/Cluster_Logical_Volume_Manager.pdf

--- snip ---
4.1.2. Creating Striped Volumes
The stripe size should be tuned to a power of 2 between 4kB and
512kB, and matched to the application's I/O that is using the
striped volume. The -I argument of the lvcreate command specifies
the stripe size in kilobytes.
--- snip ---

This is only the case for the LVM1 binary metadata format. The LVM2 text VG format declares the format flag FMT_UNLIMITED_STRIPESIZE and is not subject to this restriction.

See the following code which enforces the check for other metadata formats (but not LVM2):

tools/lvcreate.c:_lvcreate():
535         if (lp->stripes > 1 &&
536             !(vg->fid->fmt->features & FMT_UNLIMITED_STRIPESIZE) &&
537             (lp->stripe_size > STRIPE_SIZE_MAX)) {
538                 log_error("Stripe size may not exceed %s",
539                           display_size(cmd, (uint64_t) STRIPE_SIZE_MAX));
540                 return 0;
541         }

Version-Release number of selected component (if applicable):


How reproducible:
100%

Steps to Reproduce:
1. Read the doc :)
  
Actual results:
Limits described apply to LVM1 not LVM2 metadata.

Expected results:
Documentation should either document LVM2 capabilities or make it clear that this restriction is only for legacy LVM1 volume groups.

Comment 1 Don Domingo 2008-09-24 23:41:38 UTC
reassigning to Paul Kennedy, who i believe is the person assigned to the book in question.

Comment 2 Paul Kennedy 2008-09-26 14:21:21 UTC
Assigned to Steven Levine (slevine); primary content author of this book.

Comment 4 Steven J. Levine 2009-02-25 23:32:21 UTC
I am closing this bug because the RHEL 5.3 documents have been released.


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