Whamcloud - gitweb
Linda Bebernes [Wed, 29 May 2013 16:28:26 +0000 (09:28 -0700)]
LUDOC-109: Added scheduler default and recommendations.
Added note about scheduler default (deadline)
and recommendations (deadline, noop).
Signed-off-by: Linda Bebernes <linda.bebernes@intel.com>
Change-Id: I8cd1e3d9e547b28ccf87274b3d1737762c8fc21f
Reviewed-on: http://review.whamcloud.com/6486
Tested-by: Hudson
Reviewed-by: Cliff White <cliff.white@intel.com>
Reviewed-by: Andreas Dilger <andreas.dilger@intel.com>
Przemyslaw Dubaniewicz [Wed, 10 Apr 2013 10:29:38 +0000 (12:29 +0200)]
LUDOC-140 Add contents info to pdf edition
Enable a "fop1.extensions" in order to show
bookmarks in a pdf version of the manual.
Signed-off-by: Przemyslaw Dubaniewicz <przemyslaw@dubaniewicz.com>
Change-Id: I07a55d227ebf169587ef6671eddb633b1cbdb1f4
Reviewed-on: http://review.whamcloud.com/6008
Tested-by: Hudson
Reviewed-by: Nathaniel Clark <nathaniel.l.clark@intel.com>
Reviewed-by: Andreas Dilger <andreas.dilger@intel.com>
Reviewed-by: Richard Henwood <richard.henwood@intel.com>
Richard Henwood [Thu, 9 May 2013 18:27:25 +0000 (13:27 -0500)]
LUDOC-118 trademarks: trademark policy must be applied.
A trademark compliance review was completed on the opening content and
Section 1: Lustre Intro and a few additional minor edits were made.
Signed-off-by: Richard Henwood <richard.henwood@intel.com>
Signed-off-by: Linda Bebernes <linda.bebernes@intel.com>
Change-Id: Iaedab4e3d1b4f53e2d0d6c35171c4b270d37b909
Reviewed-on: http://review.whamcloud.com/6303
Tested-by: Hudson
Richard Henwood [Tue, 30 Apr 2013 22:27:26 +0000 (17:27 -0500)]
LUDOC-117 cleanup: minor changes to wording and markup.
Minor changes to add clarify.
Signed-off-by: Richard Henwood <richard.henwood@intel.com>
Change-Id: Ic5c8c6cf23d9779c0d1ad7a5cb702a179f9dca0b
Reviewed-on: http://review.whamcloud.com/6218
Tested-by: Hudson
Reviewed-by: Linda Bebernes <linda.bebernes@intel.com>
Nikitas Angelinas [Wed, 27 Mar 2013 01:05:22 +0000 (01:05 +0000)]
LUDOC-79 ptlrpc: Add NRS documentation
This patch adds a description of NRS changes added to Lustre from
LU-398, including policies and their tunables.
Signed-off-by: Nikitas Angelinas <nikitas_angelinas@xyratex.com>
Change-Id: I87de8c3d63d84a23215a5375384462a3429bcbab
Oracle-bug-id: b=13634
Xyratex-bug-id: MRP-73
Reviewed-on: http://review.whamcloud.com/5848
Tested-by: Hudson
Reviewed-by: Andreas Dilger <andreas.dilger@intel.com>
Sergii Glushchenko [Thu, 28 Mar 2013 15:34:07 +0000 (17:34 +0200)]
LUDOC-80: 4MB RPC Doc Changes
Reflect changes introduced in LU-1431 in the Lustre manual:
maximum value of max_pages_per_rpc is now 1024.
Change-Id: I0a2e5c6c94f99f5380200cfc1e856f4f2e3d2585
Signed-off-by: Sergii Glushchenko <sergii_glushchenko@xyratex.com>
Xyratex-bug-id: MRP-319
Reviewed-on: http://review.whamcloud.com/5534
Tested-by: Hudson
Reviewed-by: Oleg Drokin <oleg.drokin@intel.com>
Reviewed-by: Andreas Dilger <andreas.dilger@intel.com>
Richard Henwood [Tue, 8 Jan 2013 23:07:30 +0000 (17:07 -0600)]
LUDOC-117 cleanup: minor changes to wording and cleanup.
Minor wording changes to add clarity.
Reviewed position of replaceable markup tags.
Signed-off-by: Richard Henwood <richard.henwood@intel.com>
Change-Id: If0be703ac384d468cd56262fa3dd789209d009be
Reviewed-on: http://review.whamcloud.com/4974
Tested-by: Hudson
Reviewed-by: Andreas Dilger <andreas.dilger@intel.com>
Reviewed-by: Doug Oucharek <doug.s.oucharek@intel.com>
Richard Henwood [Wed, 28 Nov 2012 11:32:45 +0000 (11:32 +0000)]
LUDOC-28 llapi: clean up sample code
Clean up the examples for using the lustreapi interfaces.
This code is updated following fixes for the client API which
are tracked against LU-1606.
Signed-off-by: Richard Henwood <richard.henwood@intel.com>
Change-Id: I87f8f5a5d7f7f4792e088b45863b6656391525e9
Reviewed-on: http://review.whamcloud.com/1879
Tested-by: Hudson
Reviewed-by: Andreas Dilger <andreas.dilger@intel.com>
Andreas Dilger [Wed, 17 Aug 2011 21:33:05 +0000 (15:33 -0600)]
LUDOC-11 cleanup: cleanups of examples and text
Clean up some examples seen in the manual while working on LUDOC-14.
When the --index parameter is passed to mkfs.lustre, it will already
assign an OST or MDT index, so OSTffff will not be in the output.
Clean up the example for multiple NIDs to remove the use of the old
elan network type.
Signed-off-by: Richard Henwood <richard.henwood@intel.com>
Change-Id: Ibe1068d66627e72a88c2584f413d2c40df99cab0
Reviewed-on: http://review.whamcloud.com/2181
Tested-by: Hudson
Reviewed-by: Andreas Dilger <andreas.dilger@intel.com>
Linda Bebernes [Mon, 22 Apr 2013 20:20:54 +0000 (13:20 -0700)]
LUDOC-11: Removed Serna note.
Signed-off-by: Linda Bebernes <linda.bebernes@intel.com>
Change-Id: I2f66d7239769822dec401ecc518bf03631867825
Reviewed-on: http://review.whamcloud.com/6118
Tested-by: Hudson
Reviewed-by: Richard Henwood <richard.henwood@intel.com>
James Nunez [Mon, 8 Apr 2013 21:25:35 +0000 (15:25 -0600)]
LUDOC-11 typos: Correct assorted minor errors
Correct the following errors:
Section 8.1.1.2 Changed "utilities are must be" to "utilities must be"
Section 9.1 Changed text formatting of "networks" to match "ip2nets"
Section 9.1 Changed text formatting of "routes" to match "networks"
and "ip2nets" in the same section
Section 10.1 Changed "and MGS" to "an MGS"
Section 10.1 Changed "simplify the translating" to "simplify
translating"
Section 26.1.2 Extended text formatting to the end of the line
"Lustre logs are dumped to /proc/sys/lnet/debug_path"
Section 30.6 Changed "will still be notified reconnect" to "will
still be notified to reconnect"
Section 30.6 Changed "the last the non-IR client" to "the last non-IR
client"
Signed-off-by: James Nunez <james.a.nunez@intel.com>
Change-Id: I0148156245452e231a15fa1f863830b6df30e8bc
Reviewed-on: http://review.whamcloud.com/5976
Tested-by: Hudson
Reviewed-by: Richard Henwood <richard.henwood@intel.com>
Richard Henwood [Fri, 8 Mar 2013 01:27:50 +0000 (19:27 -0600)]
LUDOC-126 startup: component start-up order.
Component startup order is now correct.
Signed-off-by: Richard Henwood <rhenwood@whamcloud.com>
Change-Id: I3b9f24323c539d042858e98a1566ce1fadee0748
Reviewed-on: http://review.whamcloud.com/5645
Tested-by: Hudson
Reviewed-by: Cliff White <cliff.white@intel.com>
Reviewed-by: Linda Bebernes <linda.bebernes@intel.com>
Reviewed-by: Cory Spitz <spitzcor@cray.com>
Reviewed-by: Richard Henwood <richard.henwood@intel.com>
Richard Henwood [Thu, 21 Mar 2013 16:10:36 +0000 (11:10 -0500)]
LUDOC-85 enhance: new LFSCK options are now documented.
LFSCK has added significant functionality in the recent release. The
manual now makes a clear distinction which version of lustre supports
the various lfsck options.
LFSCK namespace is now included and documented.
Signed-off-by: Richard Henwood <richard.henwood@intel.com>
Change-Id: Iff0ff5b696b8a55fefedfcfe78031e28c2a93749
Reviewed-on: http://review.whamcloud.com/5801
Tested-by: Hudson
Reviewed-by: Doug Oucharek <doug.s.oucharek@intel.com>
Reviewed-by: Cliff White <cliff.white@intel.com>
Przemyslaw Dubaniewicz [Wed, 27 Mar 2013 12:18:14 +0000 (13:18 +0100)]
LUDOC-11 typos: minor cleanup of text.
Signed-off-by: Przemyslaw Dubaniewicz <przemyslaw@dubaniewicz.com>
Change-Id: I6047faadbead0e81c7c0dd94ec3ef2cd94e109ca
Reviewed-on: http://review.whamcloud.com/5853
Tested-by: Hudson
Reviewed-by: Richard Henwood <richard.henwood@intel.com>
Richard Henwood [Fri, 22 Mar 2013 20:21:37 +0000 (15:21 -0500)]
LUDOC-104 style: added style elements for 2.1, 2.2 and 2.5
Style rules now support condition='{l21|l22|l23|l24|l25}'.
Code refactored for simplicity.
Signed-off-by: Richard Henwood <richard.henwood@intel.com>
Change-Id: I2ef60e50f390b566a2193a0114bfbac3aee54979
Reviewed-on: http://review.whamcloud.com/5753
Tested-by: Hudson
Linda Bebernes [Wed, 20 Mar 2013 16:43:05 +0000 (09:43 -0700)]
LUDOC-129: Corrected dircount language
Signed-off-by: Linda Bebernes <linda.bebernes@intel.com>
Change-Id: Ifea277ebb4199db5abde7b37d4638d1e8c38604e
Reviewed-on: http://review.whamcloud.com/5788
Tested-by: Hudson
Reviewed-by: Richard Henwood <richard.henwood@intel.com>
Linda Bebernes [Wed, 20 Mar 2013 16:31:47 +0000 (09:31 -0700)]
LUDOC-70: Small editing changes
Signed-off-by: Linda Bebernes <linda.bebernes@intel.com>
Richard Henwood [Fri, 8 Mar 2013 01:47:28 +0000 (19:47 -0600)]
LUDOC-128 build: commit hooks
Commit hooks help commit messages conform to best practice. These
hooks are copied from the Lustre code commit hooks. Modified to make
them specific to the Manual.
Signed-off-by: Richard Henwood <richard.henwood@intel.com>
Change-Id: I407644562011fe66ace0e34667f67f04b9d58070
Reviewed-on: http://review.whamcloud.com/5646
Tested-by: Hudson
Reviewed-by: Andreas Dilger <andreas.dilger@intel.com>
Przemyslaw Dubaniewicz [Mon, 11 Mar 2013 11:14:21 +0000 (12:14 +0100)]
LUDOC-34 remove modules with 'lustre_rmmod'
Use "lustre_rmmod" instead of
"lctl modules | awk '{print $2}' | xargs rmmod" to remove modules.
(Corrected tip in section 15.2.2)
Change-Id: I833f83a85e87d00427ed41180e0db6fa51074d2d
Signed-off-by: Przemyslaw Dubaniewicz <przemyslaw@dubaniewicz.com>
Reviewed-on: http://review.whamcloud.com/5668
Tested-by: Hudson
Reviewed-by: Cliff White <cliff.white@intel.com>
Reviewed-by: Andreas Dilger <andreas.dilger@intel.com>
Doug Oucharek [Fri, 22 Feb 2013 08:22:37 +0000 (00:22 -0800)]
LUDOC-125 lnet: Add Remote Network Hash Table Size Parameter
Change LU-2466 added a new module parameter: rnet_htable_size
to let the user optimize the size of the LNet remote networks
hash table.
This change is to document rnet_htable_size in the manual.
Signed-off-by: Doug Oucharek <doug.s.oucharek@intel.com>
Change-Id: I4e95acb752c6c1accf13307990210120cbb78c4c
Reviewed-on: http://review.whamcloud.com/5510
Tested-by: Hudson
Reviewed-by: Cliff White <cliff.white@intel.com>
Reviewed-by: Richard Henwood <richard.henwood@intel.com>
Richard Henwood [Mon, 11 Feb 2013 19:55:41 +0000 (13:55 -0600)]
LUDOC-123: provide instruction on listing debug masks.
Clarifies instructions for the subsystem_mask parameter of lctl debug.
Provides examples.
Change-Id: I51e2104469721d15a29dda1dbaf3caeebe65b252
Signed-off-by: Richard Henwood <richard.henwood@intel.com>
Signed-off-by: Cliff White <cliff.white@intel.com>
Reviewed-on: http://review.whamcloud.com/5320
Tested-by: Hudson
Reviewed-by: John Hammond <johnlockwoodhammond@gmail.com>
Li Wei [Tue, 5 Mar 2013 07:20:35 +0000 (15:20 +0800)]
LUDOC-111 recovery: Add a section on "suppress_pings"
This patch adds a section on the new ptlrpc kernel module parameter
"suppress_pings".
Signed-off-by: Li Wei <wei.g.li@intel.com>
Change-Id: I93a63df4fa0cd15b2901161201a578236baa2d01
Reviewed-on: http://review.whamcloud.com/5588
Tested-by: Hudson
Reviewed-by: Emoly Liu <emoly.liu@intel.com>
Reviewed-by: Andreas Dilger <andreas.dilger@intel.com>
Nathaniel Clark [Mon, 28 Jan 2013 21:28:24 +0000 (16:28 -0500)]
LUDOC-91: Add wireshark to debugging tools
Add section on wireshark and pointing to wireshark plugins in contrib.
Change-Id: Id7bcbcb1ac7803c1893a75d08a62edc6f45e548b
Signed-off-by: Nathaniel Clark <nathaniel.l.clark@intel.com>
Reviewed-on: http://review.whamcloud.com/5197
Tested-by: Hudson
Reviewed-by: Doug Oucharek <doug.s.oucharek@intel.com>
Reviewed-by: Richard Henwood <richard.henwood@intel.com>
Richard Henwood [Wed, 26 Dec 2012 21:01:43 +0000 (15:01 -0600)]
LUDOC-104: Design elements to highlight lustre specific features.
The Docbook 5 standard allows for a condition attribute to all
elements. By setting this condition with the value of l23 or l24
passages of the manual that are specific to version of Lustre
can be marked up.
This change adds an annotation against elements that have the
condition attribute set. Graphics are rendered in-line at the
relevant point in the text and against the relevant entries in
the table of contents.
'condition' annotations to two existing lustre specific sections
of the to demonstrate this new design feature.
The document design elements are displayed similarly across epub, html,
xhtml and pdf renderings of the manual.
Signed-off-by: Richard Henwood <richard.henwood@intel.com>
Change-Id: Idd2cb762e219204bfc63c9ed81ccedd49b2c43ac
Reviewed-on: http://review.whamcloud.com/4611
Tested-by: Hudson
Richard Henwood [Tue, 29 Jan 2013 22:33:47 +0000 (16:33 -0600)]
LUDOC-11 typo: minor cleanup of virtual block device section.
Signed-off-by: Richard Henwood <richard.henwood@intel.com>
Change-Id: Ib29454dd0d4105f35ee0d049cf5f66fdc77fb196
Reviewed-on: http://review.whamcloud.com/5201
Tested-by: Hudson
Andreas Dilger [Sat, 12 Jan 2013 01:40:27 +0000 (18:40 -0700)]
LUDOC-117 style: use <replaceable> in example text
Use the <replaceable> tag and {} instead of <emphasis> and
<> for user-supplied text. The XML markup is intended to
be semantic, so <replaceable> is more correct to use.
The use of <> makes the XML ugly, since it needs to be
written as >< in the .xml files.
Some incorrect usages of <emphasis> were corrected.
Signed-off-by: Andreas Dilger <andreas.dilger@intel.com>
Signed-off-by: Richard Henwood <richard.henwood@intel.com>
Change-Id: I8edb59a100e20573e06f11ce10fe1642d45fbd4f
Reviewed-on: http://review.whamcloud.com/5006
Tested-by: Hudson
Richard Henwood [Wed, 14 Nov 2012 22:09:34 +0000 (16:09 -0600)]
LUDOC-71: clean-up of OST removal text.
There is no-longer duplicate text in the introduction to
removing OSTs.
Signed-off-by: Richard Henwood <richard.henwood@intel.com>
Change-Id: Icfce0c0bdefded1202af7c2fa0ce8831e0c824d5
Reviewed-on: http://review.whamcloud.com/4585
Tested-by: Hudson
Richard Henwood [Fri, 7 Dec 2012 21:54:21 +0000 (15:54 -0600)]
LUDOC-108 dne: Manual includes DNE usage instructions.
The manual now includes instructions to:
- add a MDT.
- remove a MDT.
- upgrade to multiple MDT configurations.
- designing active-active MDS configurations.
- warns against having chained remote directories.
- added administrative documentation for lfs.
Signed-off-by: Richard Henwood <richard.henwood@intel.com>
Change-Id: I9b4fb35d7932b9e90561e03b0b72271b9c2728cf
Reviewed-on: http://review.whamcloud.com/4773
Tested-by: Hudson
James Nunez [Wed, 2 Jan 2013 14:55:22 +0000 (07:55 -0700)]
LUDOC-11: Correct assorted minor errors
Corrected three minor errors:
Section 1.2.3 removed "something" before the link to the LNET section.
Section 9.1 removed duplicate text "Setting the LNET Module ip2nets Parameter"
Section 23.1 added closing parenthesis
Signed-off-by: James Nunez <james.a.nunez@intel.com>
Change-Id: If1bac00b0245e82d21290f86ce9890a167478ada
Reviewed-on: http://review.whamcloud.com/4941
Tested-by: Hudson
Reviewed-by: Richard Henwood <richard.henwood@intel.com>
Johann Lombardi [Fri, 16 Nov 2012 14:19:07 +0000 (15:19 +0100)]
LUDOC-89 quota: updates for new quota implementation
2.4 comes with many quota changes which require updates to the
lustre documentation.
Signed-off-by: Johann Lombardi <johann.lombardi@intel.com>
Change-Id: If465eb2b92d955a29799d041662b770e84891d39
Reviewed-on: http://review.whamcloud.com/4600
Tested-by: Hudson
Reviewed-by: Andreas Dilger <andreas.dilger@intel.com>
Reviewed-by: Richard Henwood <richard.henwood@intel.com>
Niu Yawei [Fri, 9 Nov 2012 09:10:26 +0000 (04:10 -0500)]
LUDOC-100 monitoring: jobstats manual
Update manual for jobstats.
Signed-off-by: Niu Yawei <niu@whamcloud.com>
Change-Id: Icfd85f788c1657b0601d06f2890db03068ea5c06
Reviewed-on: http://review.whamcloud.com/4500
Tested-by: Hudson
Reviewed-by: Andreas Dilger <andreas.dilger@intel.com>
Reviewed-by: Richard Henwood <richard.henwood@intel.com>
Richard Henwood [Wed, 14 Nov 2012 21:57:10 +0000 (15:57 -0600)]
LUDOC-95: fix server kernel RPM entry.
Table 8.1 in Section 8.1.1 in the Lustre manual contains
outdated references to the Lustre patched kernel RPM
kernel-ib-<ver>. This has been removed.
Signed-off-by: Richard Henwood <richard.henwood@intel.com>
Change-Id: I9a4c9024faa34e6fa26e8aee16d2518682172d8a
Reviewed-on: http://review.whamcloud.com/4584
Tested-by: Hudson
Reviewed-by: Brian J. Murrell <brian.murrell@intel.com>
Richard Henwood [Thu, 8 Nov 2012 00:29:06 +0000 (18:29 -0600)]
LUDOC-99 quota: clarified quota behavior.
Documentation has been corrected to remove erroneous
wording that implied a quota could be applied to a directory.
Signed-off-by: Richard Henwood <richard.henwood@intel.com>
Change-Id: I46161dcff8e57b5c224270c85d99311d9882725c
Reviewed-on: http://review.whamcloud.com/4492
Tested-by: Hudson
Reviewed-by: Bob Glossman <bob.glossman@intel.com>
Reviewed-by: Cliff White <cliff.white@intel.com>
Richard Henwood [Wed, 14 Nov 2012 02:51:02 +0000 (20:51 -0600)]
LUDOC-103 version: mds-survey is now marked as 2.2 and beyond.
mds-survey is only available in version of Lustre version 2.2. The
Manual now includes text to this effect.
Signed-off-by: Richard Henwood <richard.henwood@intel.com>
Change-Id: I43349f5994d7ff0f55db7cf58b3fd3b316f200fc
Reviewed-on: http://review.whamcloud.com/4527
Tested-by: Hudson
Reviewed-by: wangdi <di.wang@intel.com>
Reviewed-by: Cliff White <cliff.white@intel.com>
Andreas Dilger [Wed, 17 Oct 2012 21:22:02 +0000 (15:22 -0600)]
LUDOC-66 lfsck: improve online LFSCK documentation
Improve the description of the online LFSCK feature, providing a
high-level overview of the feature of what the LFSCK feature is,
and improving the readability of the text.
Also update the Backup/Restore section to replace bugzilla reference
with Jira bug reference. Also mention that the OST device label needs
to be reset for 2.4 and later filesystems.
Signed-off-by: Andreas Dilger <adilger@whamcloud.com>
Change-Id: Iadbdec4f17ca7bc1ad49065756088e4d05ddcab0
Reviewed-on: http://review.whamcloud.com/4506
Tested-by: Hudson
Reviewed-by: Fan Yong <yong.fan@whamcloud.com>
Reviewed-by: Richard Henwood <richard.henwood@intel.com>
Andreas Dilger [Fri, 9 Nov 2012 20:20:48 +0000 (13:20 -0700)]
LUDOC-76 license: change Whamcloud to Intel
Change references in the manual from Whamcloud over to Intel in
both the license cover page as well as within the manual.
Update URLs for package downloads to reference the release download
title page instead of the top-level wiki page.
Signed-off-by: Andreas Dilger <adilger@whamcloud.com>
Change-Id: I8d0926881a140e3e76202dc442037366046b6469
Reviewed-on: http://review.whamcloud.com/4497
Tested-by: Hudson
Reviewed-by: Richard Henwood <richard.henwood@intel.com>
Richard Henwood [Tue, 30 Oct 2012 19:58:08 +0000 (14:58 -0500)]
LUDOC-97 tuning: SMP node affinity parameters are now documented.
SMP Node Affinity arrived with Lustre 2.3 (LU-56). The default
values SMP machines are judged to be suitable for most workloads.
If and administrator does want to tinker, this change records
the available parameters.
Entries added to the glossary for NUMA and Node Affinity.
Signed-off-by: Richard Henwood <richard.henwood@intel.com>
Signed-off-by: Liang Zhen <liang.zhen@intel.com>
Change-Id: Ib5dd25431046d2842cbde77f0b6fede47a790da7
Reviewed-on: http://review.whamcloud.com/4413
Tested-by: Hudson
Reviewed-by: Doug Oucharek <doug.s.oucharek@intel.com>
Reviewed-by: Liang Zhen <liang@whamcloud.com>
Reviewed-by: Cliff White <cliff.white@intel.com>
Ned Bass [Fri, 7 Sep 2012 20:09:16 +0000 (13:09 -0700)]
LUDOC-11 fix assorted minor errors
A number of grammatical, spelling, and formatting errors were found by
running the html manual through aspell -H.
Signed-off-by: Ned Bass <bass6@llnl.gov>
Change-Id: Ie4f3cfba62cfb452c1bddb21a3137142dada9d47
Reviewed-on: http://review.whamcloud.com/3908
Tested-by: Hudson
Reviewed-by: Richard Henwood <Richard.Henwood@intel.com>
Doug Oucharek [Thu, 6 Sep 2012 20:54:31 +0000 (13:54 -0700)]
LUDOC-75 lnet: Add lst utility environment variable LST_FEATURES
Change LU-521 added a new environment variable LST_FEATURES.
This change is to document LST_FEATURES in the manul.
Signed-off-by: Doug Oucharek <doug.s.oucharek@intel.com>
Change-Id: I8760bb902b45d82203645f26c0d1df3e17b8891b
Reviewed-on: http://review.whamcloud.com/3893
Tested-by: Hudson
Reviewed-by: Richard Henwood <Richard.Henwood@intel.com>
Reviewed-by: Liang Zhen <liang@whamcloud.com>
Reviewed-by: Cliff White <cliffw@whamcloud.com>
Ned Bass [Wed, 5 Sep 2012 22:34:34 +0000 (15:34 -0700)]
LUDOC-11 debug: fix wrong libcfs debug header path
An incorrect path was given to the header file listing debug
subsystems and message types.
Signed-off-by: Ned Bass <bass6@llnl.gov>
Change-Id: Ib272ed9630f23f99d5f66760804bc3627d58f5dc
Reviewed-on: http://review.whamcloud.com/3882
Tested-by: Hudson
Reviewed-by: Richard Henwood <Richard.Henwood@intel.com>
Tested-by: Richard Henwood <Richard.Henwood@intel.com>
Richard Henwood [Tue, 10 Jul 2012 13:57:49 +0000 (08:57 -0500)]
LUDOC-66 lfsck: User interface documentation.
lfsck with OI Scrub is new in Lustre 2.3. The user interface is documented by
this change.
Signed-off-by: Richard Henwood <rhenwood@whamcloud.com>
Change-Id: I5a74e3ed143ed1c067e41731edf666e900a3b485
Reviewed-on: http://review.whamcloud.com/3368
Tested-by: Hudson
Reviewed-by: Fan Yong <yong.fan@whamcloud.com>
Reviewed-by: Cliff White <cliffw@whamcloud.com>
Reviewed-by: Richard Henwood <Richard.Henwood@intel.com>
Andreas Dilger [Thu, 30 Aug 2012 07:38:17 +0000 (01:38 -0600)]
LUDOC-62 admin: better OST/MDT migrate description
Instead of restating the backup/restore steps for OST/MDT migration,
reference the existing file/device backup/restore process. Clean up
the formatting of backup/restore examples a bit.
Update the OST object-to-MDS file mapping process to reference new
MDT FIDs and fid2path, in preference to the old 1.8 debugfs method.
Signed-off-by: Andreas Dilger <adilger@whamcloud.com>
Change-Id: Ida33c2f055cf9f66fa1ec7463e1ca36875aecab0
Reviewed-on: http://review.whamcloud.com/3827
Tested-by: Hudson
Reviewed-by: Richard Henwood <Richard.Henwood@intel.com>
Reviewed-by: Cliff White <cliffw@whamcloud.com>
Richard Henwood [Mon, 30 Jul 2012 18:47:50 +0000 (14:47 -0400)]
Merge "LUDOC-62 backup: file-level MDT backup now supported."
Richard Henwood [Fri, 27 Jul 2012 21:48:39 +0000 (16:48 -0500)]
LUDOC-58: Clarify multiple file system issues.
Manual is updated to emphasise Lustre is designed to only have one MGS. If
there are multiple MGSs then best practice suggests fsname must be unique.
Signed-off-by: Richard Henwood <rhenwood@whamcloud.com>
Change-Id: I82af8e6004fe1d7f70f4a8c93d60103271fcd298
Richard Henwood [Tue, 3 Jul 2012 16:38:59 +0000 (11:38 -0500)]
LUDOC-62 backup: file-level MDT backup now supported.
Because LU-957 will land for 2.3 the Manual now describes file level
back for both an MDT and an OST.
Signed-off-by: Richard Henwood <rhenwood@whamcloud.com>
Change-Id: I8f797f8566453f99b2fe67f26e780db07a9eb3e0
Richard Henwood [Tue, 29 May 2012 18:01:01 +0000 (14:01 -0400)]
Merge "LUDOC-49: MDT sizing hint for stripes."
Richard Henwood [Wed, 2 May 2012 16:42:31 +0000 (11:42 -0500)]
LUDOC-11: tidied up minor word ordering errors.
Signed-off-by: Richard Henwood <rhenwood@whamcloud.com>
Cliff White [Sun, 29 Apr 2012 17:20:13 +0000 (10:20 -0700)]
LUDOC-24 Glossary: Fix a typo
Change-Id: I1349f0a79729efcdb94d25a1da0977450250915a
Signed-off-by: Cliff White <cliffw@whamcloud.com>
Richard Henwood [Fri, 20 Apr 2012 18:56:41 +0000 (14:56 -0400)]
Merge "LUDOC-39"
Cliff White [Mon, 2 Apr 2012 22:53:45 +0000 (15:53 -0700)]
LUDOC-39
Add Imperative Recovery to the manual
Include tuning parameters.
Change-Id: I856d92078dc1f7e72c29816197e71851c423f1f2
Signed-off-By: Cliff White <cliffw@whamcloud.com>
Andreas Dilger [Fri, 24 Feb 2012 09:04:22 +0000 (02:04 -0700)]
LUDOC-11 ptlrpc: fix max_rpcs_in_flight_limit
The maximum number of RPCs in flight per OSC is actually 256, not 32.
Signed-off-by: Andreas Dilger <adilger@whamcloud.com>
Change-Id: Ie8e9ccbc56132d9112b03934dea004c0bd2faf9b
Richard Henwood [Fri, 6 Apr 2012 12:24:24 +0000 (08:24 -0400)]
Merge "LUDOC-42 document Statahead and AGL"
Richard Henwood [Thu, 5 Apr 2012 15:15:36 +0000 (11:15 -0400)]
Merge "LUDOC-40 - Add ptlrpcd thread pool"
Yu Jian [Sat, 31 Mar 2012 06:10:34 +0000 (14:10 +0800)]
LUDOC-42 document Statahead and AGL
Update the directory statahead tunable interface descriptions and
add the document for AGL (asynchronous glimpse lock).
Signed-off-by: Yu Jian <yujian@whamcloud.com>
Change-Id: I9dbe2a78f351704bd6ea05093489affea993ea1a
Minh Diep [Wed, 4 Apr 2012 18:15:13 +0000 (11:15 -0700)]
LUDOC-20 admin: fix mount lustre on ldiskfs
lustre can only mount using ldiskfs, not ext4
Signed-off-by: Minh Diep <mdiep@whamcloud.com>
Change-Id: Ifecc9f8302fa777bfe2a1e07e79d42d5c3b803e4
Cliff White [Fri, 30 Mar 2012 18:52:24 +0000 (11:52 -0700)]
LUDOC-40 - Add ptlrpcd thread pool
Add Ptlrpcd Thread Pool to manual.
Change-Id: I34ff809d9550c6003cc77383a5950c2fe9097779
Signed-off-By: cliff white <cliffw@whamcloud.com>
Minh Diep [Fri, 30 Mar 2012 18:41:45 +0000 (11:41 -0700)]
LUDOC-20 admin: Add instructions for separate MGS
1. Fix order list for Lustre Maintenance section
2. Add instructions on how to separate MGS
Signed-off-by: Minh Diep <mdiep@whamcloud.com>
Change-Id: I69288028cb012f9d0d944cf8809d2660b7ad36d0
Yu Jian [Fri, 30 Mar 2012 08:06:23 +0000 (16:06 +0800)]
LUDOC-2 add "--raw" option to "lfs getstripe"
A new option to "lfs getstripe" is introduced; the "--raw" or
"-R" option.
If this option is specified, the stripe information is printed
without substituting the filesystem's default values for
unspecified fields. If the striping EA is not set, 0, 0, and -1
will be printed for the stripe count, size, and offset respectively.
Signed-off-by: Yu Jian <yujian@whamcloud.com>
Change-Id: I2d4a1bf8fd063afb40345609db9c8204d6e3cc09
Richard Henwood [Thu, 29 Mar 2012 22:15:11 +0000 (18:15 -0400)]
Merge "LUDOC-33: fixed identity information upcall 2.x"
Richard Henwood [Fri, 10 Feb 2012 20:50:04 +0000 (14:50 -0600)]
LUDOC-33: fixed identity information upcall 2.x
Pre 2.x, Lustre used the user identity information upcall on Lustre MDS side is
through the /proc interface: /proc/fs/lustre/mds/{mdsname}/group_upcall
From 2.x: interface has been replaced (since Lustre-2.0 release) by:
/proc/fs/lustre/mdt/{mdtname}/identity_upcall, and this interface has been
superseded by lctl set_param mdt.{mdtname}.identity_info={path}. "NONE" means
no identity_upcall.
In addition, the following substitutions have been made for Lustre 2.x
"group_info" becomes "identity_info"
"mds_grp_downcall_data" becomes "identity_downcall_data"
"l_getgroups" becomes "l_getidentity"
Signed-off-by: Richard Henwood <rhenwood@whamcloud.com>
Change-Id: I9db35e8882834f4df234f38f13a55fbb1d79a377
Minh Diep [Tue, 31 Jan 2012 20:01:08 +0000 (12:01 -0800)]
LUDOC-36 iokit: add mds-survey information
Added mds-survey in lustre-iokit
Signed-off-by: Minh Diep <mdiep@whamcloud.com>
Change-Id: Ia5e62b8caa9ae9ff34dea5a95e7f2836f52661c1
Richard Henwood [Mon, 19 Mar 2012 21:01:16 +0000 (16:01 -0500)]
LUDOC-49: MDT sizing hint for stripes.
MDT sizing now provides basic advice on including strip count in
calculations.
Signed-off-by: Richard Henwood <rhenwood@whamcloud.com>
Richard Henwood [Fri, 16 Mar 2012 16:09:42 +0000 (12:09 -0400)]
Merge "LU-1203 Replace 'mds' with 'mdt' in root_squash section"
Cliff White [Mon, 12 Mar 2012 17:10:26 +0000 (10:10 -0700)]
LU-1203 Replace 'mds' with 'mdt' in root_squash section
Fix parameter documentation for root_squash
Addressed Richards correction
Signed-off-by: cliffw@whamcloud.com
Change-Id: I99d1c2df310406848eb6096af84fb8fdf840a0fb
Yu Jian [Fri, 2 Mar 2012 15:23:12 +0000 (23:23 +0800)]
LUDOC-29 upgrade/downgrade process with wide striping feature
Document the process to upgrade from an existing filesystem to
enable wide striping on the MDT and how to downgrade the MDT
filesystem to an earlier version of Lustre that does not support
wide striping.
Signed-off-by: Yu Jian <yujian@whamcloud.com>
Change-Id: I0b3c0b365b5a9fd5bc330cadddf0be147cec9b12
Cliff White [Mon, 12 Mar 2012 17:01:02 +0000 (10:01 -0700)]
LU-1203 - undo previous changes
Change-Id: I4074c12dff5bcb7987d402c15a10a495926ca3c3
Cliff White [Mon, 12 Mar 2012 16:32:25 +0000 (09:32 -0700)]
LU-1203 Fix root_squash documentation for mdt
Replace 'mds' with 'mdt' in root_sqaush setup
Change-Id: I410c5078b3f0a44b3e40b7b7814e31c913a424ad
Cliff White [Mon, 12 Mar 2012 16:27:57 +0000 (09:27 -0700)]
LU-1203 Fix root_squash in manual
Replace 'mds' with 'mdt' in root_squash examples
Cliff White [Mon, 12 Mar 2012 16:14:50 +0000 (09:14 -0700)]
Fixes root squash section to use mdt instead of mds
Richard Henwood [Thu, 23 Feb 2012 19:32:19 +0000 (14:32 -0500)]
Merge "LUDOC-11 upgrade: document 2.1 upgrade requirement"
Richard Henwood [Tue, 13 Dec 2011 19:25:53 +0000 (13:25 -0600)]
LU-680 manual: documentation for instance <-> path mapping.
A new feature was added to lfs with LU-680. This change records
the usage of this new feature in the manual.
lfs commands are now listed in alphabetical order.
The code changeset is:
http://review.whamcloud.com/#change,1373
Signed-off-by: Richard Henwood <rhenwood@whamcloud.com>
Change-Id: Ifed7b26193fe219174891cdf79f4401b901750f7
Yu Jian [Mon, 9 Jan 2012 11:21:54 +0000 (19:21 +0800)]
LUDOC-29 increase maximum stripe count from 160 to 2000
The wide striping feature increases the maximum stripe count from
160 to 2000. This patch fixes this limit in the manual.
Signed-off-by: Yu Jian <yujian@whamcloud.com>
Change-Id: I8b3496f3e71debc314d97669dbc8db81a5a4c9a4
Andreas Dilger [Thu, 2 Feb 2012 07:27:53 +0000 (00:27 -0700)]
LUDOC-11 upgrade: document 2.1 upgrade requirement
The 1.8->2.x upgrade section was referring only to Lustre 2.0, but
should refer to Lustre 2.x more generically.
Update the minimum 1.8 version for 2.1 interoperability to 1.8.6.
Remove statement that allows both 1.8 and 2.x servers to be running
at the same time, since this is not tested. Instead, require that
both the MDS and OSS nodes are upgraded to 2.x at the same time.
Remove references to ancient 1.4.x Lustre versions, and distinctions
that are only present for versions of Lustre 1.6.5 and older.
Signed-off-by: Andreas Dilger <adilger@whamcloud.com>
Change-Id: I94a41610f65e597accc773f534e518f4e87fcab0
Richard Henwood [Wed, 22 Feb 2012 18:23:25 +0000 (12:23 -0600)]
LUDOC-13 build: Disable diff in Makefile
If diff fails, the build is marked as failing. Make all now doesn't
have diff enabled until it has had the bugs worked out.
Added epub to clean.
Signed-off-by: Richard Henwood <rhenwood@whamcloud.com>
Change-Id: I11464045679ea02105f0baebeddc7d2a6f86d80c
Richard Henwood [Thu, 16 Feb 2012 20:49:05 +0000 (14:49 -0600)]
LUDOC-25: typo fix
tthat becomes that. The sentences simplified for clarity.
Signed-off-by: Richard Henwood <rhenwood@ywhamcloud.com>
Change-Id: I983fec8aa0c6db088ba802f61d360cab4bc26864
Richard Henwood [Thu, 16 Feb 2012 20:21:31 +0000 (15:21 -0500)]
Merge "LUDOC-32: build epub from manual."
Richard Henwood [Fri, 10 Feb 2012 21:31:13 +0000 (15:31 -0600)]
LUDOC-32: build epub from manual.
Makefile now contains the correct rules to build an epub version
of the manual.
Signed-off-by: Richard Henwood <rhenwood@ywhamcloud.com>
Change-Id: I5e126b137b535522c720fdac863562f194a2e17e
Jessica Popp [Tue, 14 Feb 2012 16:15:48 +0000 (11:15 -0500)]
Merge "LUDOC-13: enhanced diff to work with larger changes."
Richard Henwood [Fri, 10 Feb 2012 20:20:28 +0000 (14:20 -0600)]
LUDOC-13: enhanced diff to work with larger changes.
Significant changes were needed to work with multi-line changes
that included changes in markup between master and review manual.
NOTE: The resulting html may not be valid, but will probably render
in the browser.
Signed-off-by: Richard Henwood <rhenwood@whamcloud.com>
Change-Id: I60c724afca1ac6d89e3372666f9c7962efb73360
Andreas Dilger [Thu, 19 Jan 2012 15:31:30 +0000 (08:31 -0700)]
LUDOC-37 kernel: use /etc/modprobe.d/lustre.conf
Update the documentaion to store module parameters in the
/etc/modprobe.d/lustre.conf file to make the newer distro
modutils happy.
Early versions of modprobe did not care what filenames were
used in /etc/modprobe.d/, which lead to confusion if old
versions of files were located there (e.g. Lustre.orig or
Lustre~). Newer versions of modprobe (at least since FC12,
but possibly earlier) require module parameter files to have
a ".conf" suffix in order to be parsed.
The /etc/modprobe.d/ directory has been supported since at
least module-init-utils 3.2 (RHEL5) and may have been supported
before that time. This means that all supported distros can
use /etc/modprobe.d/lustre.conf for Lustre-specific parameters.
Signed-off-by: Andreas Dilger <adilger@whamcloud.com>
Change-Id: Ic885f610b3d9b16eb211d4a2d971930f53647bec
Richard Henwood [Tue, 7 Feb 2012 21:37:52 +0000 (15:37 -0600)]
LUDOC-26: update mdt.quota_type to mdd.quota_type.
Search and replaced with an addition comment to recored that mdt.quota
is the command for Lustre 1.6.5 thru until Lustre 2.0.
Signed-off-by: Richard Henwood <rhenwood@whamcloud.com>
Change-Id: I93f6a7de22d47b62a2e124ae19c953a2900430a2
Bobi Jam [Thu, 22 Dec 2011 08:20:38 +0000 (16:20 +0800)]
LUDOC-31 manual: add --servicenode option description
Add --servicenode option description for mkfs.lustre and tune.lustre.
Change XSL_REL in Makefile so that make gets correct install path of
different version of docbook5 XSL stylesheets package.
Signed-off-by: Bobi Jam <bobijam@whamcloud.com>
Change-Id: If92af7e0839928ddfeb966090d75796c93b8499e
Richard Henwood [Fri, 30 Dec 2011 21:31:23 +0000 (15:31 -0600)]
LUDOC-13: diff works for doc changes.
make diff now creates a annotated html file highlighting the differences between
master and review manual builds.
Signed-off-by: Richard Henwood <rhenwood@whamcloud.com>
Change-Id: Iec9a83b162697e17e894486c54090fbd406c2dff
Zhiqi Tao [Wed, 14 Dec 2011 07:00:14 +0000 (00:00 -0700)]
LUDOC-27 Update the Setting up a Lustre file system chapter to reflect the recent changes in mkfs.lustre
- flex_bg, huge_file and lazy_journal_init are enabled by default.
- On OSTs the number of inodes created for larger LUNs is increased.
Add a table to show the inode ratio to be considered
- Update the maximum OST size and the maximum file system size
- Fix a few spell errors
Signed-off-by: Zhiqi Tao <zhiqi@whamcloud.com>
Change-Id: Ifc4db56aac344278bc5aacaeac25cac4b17e8e59
Richard Henwood [Sun, 11 Dec 2011 18:44:43 +0000 (12:44 -0600)]
LUDOC-23: MDT/MDS space requirements updated for 2.x release.
inode allocation is reduced as it is unlikely that 4K is ever used. If more
space is needed, space will be allocated outside of the inode. Allocating space
outside the inode will incur a performance penalty.
Signed-off-by: Richard Henwood <rhenwood@whamcloud.com>
Change-Id: I0081d77c430fceb362f1e53d93eb60ce817a3a0b
Richard Henwood [Mon, 28 Nov 2011 20:57:04 +0000 (14:57 -0600)]
LUDOC-4 client stats file values description.
Description of the values returned by the command:
lctl get_param llite.*.stats.
Updated to include 2.2 stats from LU-334.
Signed-off-by: Richard Henwood <rhenwood@whamcloud.com>
Change-Id: I85f758dfcc0a4f76a280b96d50acf1bd0363562a
Richard Henwood [Tue, 1 Nov 2011 14:19:43 +0000 (10:19 -0400)]
Merge "LUDOC-8 Make Jenkins build manual using a Makefile."
Richard Henwood [Fri, 28 Oct 2011 14:43:19 +0000 (10:43 -0400)]
Merge "LUDOC-18 added entry for errno EDQUOT."
Richard Henwood [Mon, 24 Oct 2011 18:55:12 +0000 (13:55 -0500)]
LUDOC-8 Make Jenkins build manual using a Makefile.
This Makefile supports building on Mac,
Ubuntu 11.04 and RHEL6. TMP var is intended to be portable.
diff target is temporarily disabled.
Signed-off-by: Richard Henwood <rhenwood@whamcloud.com>
Change-Id: Iaf494b91725bc78c745a4df47e64c8725163e37d
Andreas Dilger [Wed, 17 Aug 2011 21:33:05 +0000 (15:33 -0600)]
LUDOC-11 Misc cleanups of examples and text
Clean up some examples seen in the manual while working on LUDOC-14.
Use "ost0" and "ost1" in examples, to match the actual OST indices
used, instead of "ost1" and "ost2". Same for "oss0" and "oss1", etc.
Use "lctl {get,set}_param" instead of direct /proc access in a few
places (there are a lot more that should be fixed).
Signed-off-by: Andreas Dilger <adilger@whamcloud.com>
Change-Id: Ibeb4e3318b6fbdb8a81283d5cfad14a69e27443b
Andreas Dilger [Wed, 17 Aug 2011 20:50:04 +0000 (14:50 -0600)]
LUDOC-14 Always use --index when formatting OSTs
To prepare users for changes that are upcoming in Lustre 2.3/2.4 for
the OSD restructuring project, the OST index should always be given
when formatting OSTs with mkfs.lustre. This is already accepted as
standard practice for Lustre users today, so reflect that in the
examples in the manual.
Change-Id: I41cc175dc4392950c4376b3643c3017f6b9b2fcc
Signed-off-by: Andreas Dilger <adilger@whamcloud.com>
Richard Henwood [Tue, 13 Sep 2011 14:54:16 +0000 (09:54 -0500)]
LUDOC-18 added entry for errno EDQUOT.
Documented error number 122: EDQUOT: this error occurs when an
operation fails because the user disk quota is exceeded. The
documented location of errno.h has been updated to:
/usr/include/asm-generic/errno.h
Signed-off-by: Richard Henwood <rhenwood@whamcloud.com>
Change-Id: I8d7b4583bffbad62a917448710268ffc3ef53769
Jessica Popp [Tue, 6 Sep 2011 15:54:55 +0000 (11:54 -0400)]
Merge "LUDOC-16 fix stale links."
Richard Henwood [Tue, 30 Aug 2011 18:27:14 +0000 (13:27 -0500)]
LUDOC-16 fix stale links.
Links now point to accurate and actively maintained targets.
Signed-off-by: Richard Henwood <rhenwood@whamcloud.com>
Change-Id: I3212ac2fb807108ca046b06ebfa7842474449127
Richard Henwood [Thu, 11 Aug 2011 15:35:28 +0000 (11:35 -0400)]
Merge "LUDOC-13 render diff of html manual to enhance reviewability."
Richard Henwood [Wed, 20 Jul 2011 18:01:47 +0000 (13:01 -0500)]
LUDOC-13 render diff of html manual to enhance reviewability.
Reviewing manual changes is challenging when only observing docbook
xml. This change provides code (./tools/diff.py) and a 'diff' make
target to generate a html page with annotated differences. An
example screenshot is attached to LUDOC-13.
Signed-off-by: Richard Henwood <rhenwood@whamcloud.com>
Change-Id: Ib19bae429235f9bf2b2b8d15a597baac8f12cc6e
Andreas Dilger [Mon, 25 Jul 2011 23:30:41 +0000 (17:30 -0600)]
LUDOC-11 debug: Fix malformed sentence
Fix incompletely edited sentence after review from Richard.
Change-Id: Ic9436d791104efec5c18d3ee5f2a36c7b859cf23
Signed-off-by: Andreas Dilger <adilger@whamcloud.com>
Andreas Dilger [Mon, 11 Jul 2011 16:30:14 +0000 (10:30 -0600)]
LUDOC-11 Minor improvements to debugging chapter
Fix formatting consistency of the debugging chapter.
Add a number of debug macros that were not being listed, and
improve the description and formatting of some others.
Update sample output to be consistent with what is generated
by modern Lustre tools.
Change-Id: Ie1276e49c784ccc6ee23c5609b996baa4ad57173
Signed-off-by: Andreas Dilger <adilger@whamcloud.com>
Andreas Dilger [Wed, 6 Jul 2011 18:28:24 +0000 (12:28 -0600)]
LUDOC-11 cleanups to Lustre limits table
The Lustre limits table was outdated in a few places, and not organized
in a logical manner. Consolidate the table and update to latest values,
and remove unknown characters in table.
Clarify some of the Lustre feature descriptions in this section.
Change-Id: I4ee903ccc8446f1c32e456bc6535e1af09e39379
Signed-off-by: Andreas Dilger <adilger@whamcloud.com>
Richard Henwood [Fri, 8 Jul 2011 14:41:37 +0000 (07:41 -0700)]
Merge "LUDOC-6 Add Makefile with check, pdf, html targets"
git://git.whamcloud.com / doc / manual.git / log