From: Joseph Gmitter <joseph.gmitter@intel.com>
Date: Thu, 12 Apr 2018 04:20:44 +0000 (-0400)
Subject: LUDOC-399 dom: Fix example and clarify 64KB alignment
X-Git-Tag: 2.11.0~5
X-Git-Url: https://git.whamcloud.com/?a=commitdiff_plain;h=4003cf63802867abf92bec25bf055144260425ef;p=doc%2Fmanual.git

LUDOC-399 dom: Fix example and clarify 64KB alignment

This patch fixes an example that incorrectly used 32KB
instead of 64KB as the dom component size.

The patch also clarifies the LFS limits for the DoM component size to
mention that the 64KB restriction is due to the minimum Lustre
stripe size.

Signed-off-by: Joseph Gmitter <joseph.gmitter@intel.com>
Change-Id: I32c2b2f46743010387196560ead7f0f880f1dcf4
Reviewed-on: https://review.whamcloud.com/31969
Tested-by: Jenkins
Reviewed-by: Mike Pershin <mike.pershin@intel.com>
Reviewed-by: Andreas Dilger <andreas.dilger@intel.com>
---

diff --git a/DataOnMDT.xml b/DataOnMDT.xml
index c7a721f..1ab9a1c 100644
--- a/DataOnMDT.xml
+++ b/DataOnMDT.xml
@@ -257,10 +257,12 @@ client$ lfs getstripe /mnt/lustre/domdir/domfile
           <section><title>LFS limits for DoM component size</title>
               <para><literal>lfs setstripe</literal> allows for setting the
               component size for MDT layouts up to 1GB, however, the size must
-              be also aligned by 64KB. This is the maximum possible size on MDT.
+              also be aligned by 64KB due to the minimum stripe size in Lustre
+              (see <xref linkend="settinguplustresystem.tab2"/>). This value
+              represents the maximum possible size of the component on the MDT.
               Meanwhile, there is another limit which is checked by
-              <literal>lfs setstripe</literal> is provided by MDT server itself.
-              </para>
+              <literal>lfs setstripe</literal> and is provided by the MDT
+              server itself.</para>
           </section>
           <section><title>MDT Server Limits</title>
               <para>The LOD parameter <literal>dom_stripesize</literal> is used
@@ -406,11 +408,11 @@ Invalid argument</screen></para>
           </section>
           <section><title>Temporary Set Examples</title>
               <para>The example below shows a change to the default DoM limit on
-              the server to 32KB and try to create a file with 1MB DoM size
+              the server to 64KB and try to create a file with 1MB DoM size
               after that.
-              <screen>mds# lctl set_param -n lod.*MDT0000*.dom_stripesize=32K
+              <screen>mds# lctl set_param -n lod.*MDT0000*.dom_stripesize=64K
 mds# lctl get_param -n lod.*MDT0000*.dom_stripesize
-32768
+65536
 
 client$ lfs setstripe -E 1M -L mdt /mnt/lustre/dom
 Create composite file /mnt/lustre/dom failed. Invalid argument