Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.
For bugs related to Red Hat Enterprise Linux 5 product line. The current stable release is 5.10. For Red Hat Enterprise Linux 6 and above, please visit Red Hat JIRA https://issues.redhat.com/secure/CreateIssue!default.jspa?pid=12332745 to report new issues.

Bug 463828

Summary: LVM Admin Guide: incorrect information about stripe size limits
Product: Red Hat Enterprise Linux 5 Reporter: Bryn M. Reeves <bmr>
Component: DocumentationAssignee: Steven J. Levine <slevine>
Status: CLOSED NOTABUG QA Contact: Content Services Development <ecs-dev-list>
Severity: medium Docs Contact:
Priority: medium    
Version: 5.1CC: pkennedy, tao
Target Milestone: rcKeywords: Documentation
Target Release: ---   
Hardware: All   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2009-02-25 23:32:21 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Bug Depends On:    
Bug Blocks: 465305    

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.