LUDOC-394 manual: Add meaningful ref names under TroubleShootingRecovery.xml

This patch adds meaningful and proper reference name under file
TroubleShootingRecovery.xml

Signed-off-by: Arshad Hussain <arshad.hussain@aeoncomputing.com>
Change-Id: I939a50eff6f062cd58a16d66f51339608a194601
Reviewed-on: https://review.whamcloud.com/43355
Tested-by: jenkins <devops@whamcloud.com>
Reviewed-by: Andreas Dilger <adilger@whamcloud.com>

LUDOC-394 manual: Add meaningful ref names under LustreTuning.xml

This patch adds meaningful and proper reference name under file
LustreTuning.xml.

Signed-off-by: Arshad Hussain <arshad.hussain@aeoncomputing.com>
Change-Id: Ib0c904174535f3a9488984fc78b520ba5dcec8d9
Reviewed-on: https://review.whamcloud.com/43356
Tested-by: jenkins <devops@whamcloud.com>
Reviewed-by: Andreas Dilger <adilger@whamcloud.com>

LUDOC-394 manual: Add meaningful ref names under InstallingLustre.xml

This patch adds meaningful and proper reference name under file
InstallingLustre.xml

Signed-off-by: Arshad Hussain <arshad.hussain@aeoncomputing.com>
Change-Id: Iba960a961d20a2fecc80e3627d7e1280146a29b7
Reviewed-on: https://review.whamcloud.com/43357
Tested-by: jenkins <devops@whamcloud.com>
Reviewed-by: Andreas Dilger <adilger@whamcloud.com>

LUDOC-394 manual: Add meaningful ref names under UpgradingLustre.xml

This patch adds meaningful and proper reference name under file
UpgradingLustre.xml

Signed-off-by: Arshad Hussain <arshad.hussain@aeoncomputing.com>
Change-Id: I8fb80355cbdedd94fcd292f642ed4ee4a0a15892
Reviewed-on: https://review.whamcloud.com/43358
Tested-by: jenkins <devops@whamcloud.com>
Reviewed-by: Andreas Dilger <adilger@whamcloud.com>

LUDOC-11 proc: minor clarification of readahead params

Improve wording for max_read_ahead_mb and max_read_ahead_per_file_mb
to make it clear what each one is applied to.

Signed-off-by: Andreas Dilger <adilger@whamcloud.com>
Change-Id: Ic11a220499198c7bf3d1485d9ed62033c6ef0be3
Reviewed-on: https://review.whamcloud.com/43282
Tested-by: jenkins <devops@whamcloud.com>

LUDOC-373 manual: Add section on Lustre xattrs

This patch adds a section on lustre attrs

Signed-off-by: Arshad Hussain <arshad.hussain@aeoncomputing.com>
Change-Id: I29c888390490701b1bafbfc078a2d3ddcf3cb42c
Reviewed-on: https://review.whamcloud.com/42108
Tested-by: jenkins <devops@whamcloud.com>
Reviewed-by: Andreas Dilger <adilger@whamcloud.com>

LUDOC-394 manual: Add meaningful ref names under ConfiguringLustre.xml

Currently, the reference names are auto-generated and obscure
This patch adds meaningful and proper reference name under file
ConfiguringLustre.xml

Signed-off-by: Arshad Hussain <arshad.hussain@aeoncomputing.com>
Change-Id: Iea3660fe956aa680919751fc646e6925655e1ac5
Reviewed-on: https://review.whamcloud.com/42070
Tested-by: jenkins <devops@whamcloud.com>
Reviewed-by: Andreas Dilger <adilger@whamcloud.com>

LUDOC-488 fallocate: Add fallocate tuning information

This patch adds section on how to tune/enable/disable fallocate for
ldiskfs OSTs.

Signed-off-by: Arshad Hussain <arshad.hussain@aeoncomputing.com>
Change-Id: Ic4c2f8cdff188973cfe1aeb9aac322aa3c3bdb69
Reviewed-on: https://review.whamcloud.com/41711
Tested-by: jenkins <devops@whamcloud.com>
Reviewed-by: Andreas Dilger <adilger@whamcloud.com>

LUDOC-322 sec: reinstate Kerberos doc

This patch adds documentation for Kerberos support in Lustre. This is
adapted and updated from the original Lustre user manual.
This doc is added under the Managing Security in a Lustre File System
section.

Signed-off-by: Sebastien Buisson <sbuisson@ddn.com>
Change-Id: I430b99d2d11e034347021337b00e063158d7ef4f
Reviewed-on: https://review.whamcloud.com/41425
Tested-by: jenkins <devops@whamcloud.com>
Reviewed-by: Andreas Dilger <adilger@whamcloud.com>

LUDOC-458 setup: update ldiskfs MDT inode ratios

Update the documented MDT inode ratios for the current defaults
used by mkfs.lustre for ldiskfs since Lustre 2.10.

Signed-off-by: Andreas Dilger <adilger@whamcloud.com>
Change-Id: Iaf45a1f6d9c4084b6de2f408f7352be34325e017
Reviewed-on: https://review.whamcloud.com/41392
Tested-by: jenkins <devops@whamcloud.com>
Reviewed-by: Cliff White <cwhite@ddn.com>

LUDOC-460 quota: statfs functionality for project quota

Document the project quota functionality for "df"
and "lfs df" when being run on a directory with project
quota assigned. This will return the amount of space
available to that project rather the total filesystem
space, if the project quota limit is smaller.

Signed-off-by: Wang Shilong <wshilong@ddn.com>
Change-Id: I33097e508fd9801be63f6aeaa8fa1c6ea586a5ea
Reviewed-on: https://review.whamcloud.com/41412
Tested-by: jenkins <devops@whamcloud.com>
Reviewed-by: Andreas Dilger <adilger@whamcloud.com>

LUDOC-419 utils: document 'lfs df' flags

Document the options and flags for 'lfs df'.

Signed-off-by: Andreas Dilger <adilger@whamcloud.com>
Change-Id: I15f8d018d31005a87eb129b4510d386fd33ebbe5
Reviewed-on: https://review.whamcloud.com/41273
Tested-by: jenkins <devops@whamcloud.com>
Reviewed-by: johann peyrard <yoyz2k@yahoo.fr>

LUDOC-484 misc: add identity_flush documentation

Add a description of the mdt.*.identity_flush parameter.

Signed-off-by: Andreas Dilger <adilger@whamcloud.com>
Change-Id: I92b72e6a06bc0e31c2e27fa05aeec67b9c3ebbe5
Reviewed-on: https://review.whamcloud.com/41040
Tested-by: jenkins <devops@whamcloud.com>

LUDOC-462 mdt: doc for directory restripe and auto-split

Document for directory restripe and auto-split, which is implemented
in LU-11025.

Change-Id: If3b4781cad79eef0678bca98046e15255d150c88
Signed-off-by: Lai Siyao <lai.siyao@whamcloud.com>
Reviewed-on: https://review.whamcloud.com/41060
Reviewed-by: Andreas Dilger <adilger@whamcloud.com>
Tested-by: jenkins <devops@whamcloud.com>

LUDOC-11 misc: update URLs from http to https

Change URLs in the manual to use https:// from http:// and update
those URLs to new targets where they no longer exist.

Since some of the URL updates are also related to cross-references
to labels within the document, update those labels to have useful
names, rather than the automatically-generated reference names.

Signed-off-by: Andreas Dilger <adilger@whamcloud.com>
Change-Id: Id3f195ceebbe269a10e3218835f855ff1d3ebbe5
Reviewed-on: https://review.whamcloud.com/39584
Reviewed-by: Peter Jones <pjones@whamcloud.com>
Tested-by: jenkins <devops@whamcloud.com>

LUDOC-477 sec: fix kernel version for client encryption

For distros explicitly listed in the doc, we use the embedded fscrypt
lib that we have copied and included in the Lustre source tree,
because these distros have not backported fscrypt v2.

Fixes: 1791cdb ("LUDOC-477 sec: doc for client-side encryption")
Signed-off-by: Sebastien Buisson <sbuisson@ddn.com>
Change-Id: I325438d29b765120aa58187730c33e08f8a8e340
Reviewed-on: https://review.whamcloud.com/41046
Tested-by: jenkins <devops@whamcloud.com>
Reviewed-by: Andreas Dilger <adilger@whamcloud.com>

LUDOC-457 proc: add new IO tunable parameters

Add descriptions for readcache_max_file_size, readcache_max_io_mb,
and writethrough_max_io_mb.  With DoM these parameters are applicable
to both the MDS and OSS, so change the description from "OSS Cache"
to "Server Cache".

Remove use of deprecated "obdfilter.*.*" parameter names.

Explain that some parameters do not apply to osd-zfs.

Wrap modified lines to be within 80 columns.

Signed-off-by: Andreas Dilger <adilger@whamcloud.com>
Change-Id: I09ae0dea50095ad2a3b74f0f0dfe5dfba537fdc3
Reviewed-on: https://review.whamcloud.com/40819
Tested-by: jenkins <devops@whamcloud.com>
Reviewed-by: Olaf Faaland-LLNL <faaland1@llnl.gov>

LUDOC-479 lnet: Clarify transmit and routing credits

Updated the explanation of transmit and routing credits to make
them more in line with what is actually implemented in the code.

Change-Id: I912f39167afb4e50271362ed41b7ec6475c96370
Signed-off-by: Amir Shehata <ashehata@whamcloud.com>
Reviewed-on: https://review.whamcloud.com/40143
Reviewed-by: Andreas Dilger <adilger@whamcloud.com>
Tested-by: jenkins <devops@whamcloud.com>

LUDOC-477 sec: doc for client-side encryption

This patch adds documentation for the client-side encryption
feature, as implemented by LU-12275.
This doc is added under the Managing Security in a Lustre File System
section.

Signed-off-by: Sebastien Buisson <sbuisson@ddn.com>
Change-Id: I7fac0591faef517f7e74d055d7845a94246b6ffc
Reviewed-on: https://review.whamcloud.com/39602
Reviewed-by: Andreas Dilger <adilger@whamcloud.com>
Tested-by: jenkins <devops@whamcloud.com>

LUDOC-467 quota: add ost pool quotas

Add documentation for ost pool quotas.

Change-Id: I6b2facc8eb4f10b4c3d232d1bad5b369b67f096e
Signed-off-by: Sergey Cheremencev <sergey.cheremencev@hpe.com>
Reviewed-on: https://review.whamcloud.com/38414
Tested-by: jenkins <devops@whamcloud.com>
Reviewed-by: Andreas Dilger <adilger@whamcloud.com>

LU-944 misc: update max_cached_mb reference

Fix a typo max_cache_mb -> max_cached_mb, and update the documented
default value from 3/4 of client RAM to 1/2, which has been the
case since 2.6.

Signed-off-by: Andreas Dilger <adilger@whamcloud.com>
Change-Id: Icfd269e18e52f6df27f681b4dc850d66023ebbe5
Reviewed-on: https://review.whamcloud.com/39825
Tested-by: jenkins <devops@whamcloud.com>
Reviewed-by: Vikentsi Lapa <vlapa@whamcloud.com>

LU-8066 misc: replace remaining /proc access with lctl

Replace most remaining parameter access references with calls to
"lctl get_param" or "lctl set_param", since these aprameters are
moved as needed to meet upstream kernel requirements.

The last few stragglers are in the output of specific tools that
will need to be fixed before their output will be correct.

Signed-off-by: Andreas Dilger <adilger@whamcloud.com>
Change-Id: I4bbd7bf1bcbe8dadf612daa4917af337d23ebbe5
Reviewed-on: https://review.whamcloud.com/39578
Reviewed-by: Ben Evans <beevans@whamcloud.com>
Tested-by: jenkins <devops@whamcloud.com>

LUDOC-11 setup: update limits for new releases

Update the filesystem limits based on recent changes.
- directory size limits for ldiskfs increase due to large_dir
- maximum OST size limits increase due to recent fixes
- reference ARM for large pages instead of ancient IA64

Add/improve related cross-reference label names, which improves
the visible URL names in the HTML version of the manual.

Signed-off-by: Andreas Dilger <adilger@dilger.ca>
Change-Id: I793b1a8a657bc3470f17c983a98404dcaf3ebbe5
Reviewed-on: https://review.whamcloud.com/39208
Reviewed-by: Andreas Dilger <adilger@whamcloud.com>
Tested-by: jenkins <devops@whamcloud.com>

LUDOC-11 misc: remove references for older Lustre

Remove references to Lustre 2.4 and earlier from the manual.
There were even places with referencs to Lustre 1.8 and 2.0.

The text still exists in earlier builds and in Git for reference.
This avoids confusing users with commands that no longer exist,
or highlighting features that are included with all releases.

Add conditions for Lustre 2.15 and 2.16 as they will be used soon.

Signed-off-by: Andreas Dilger <adilger@whamcloud.com>
Change-Id: I0786d88fcc2543f542b7a880bf042928fd3ebbe5
Reviewed-on: https://review.whamcloud.com/39511
Tested-by: jenkins <devops@whamcloud.com>

LUDOC-11 misc: fix vim footer formatting

Fix the formatting for the vim expandtab hint to avoid a warning.

Signed-off-by: Andreas Dilger <adilger@whamcloud.com>
Change-Id: Ia40dcf7f2fe2034ba5dc5d840ba4c6f1c93ebbe5
Reviewed-on: https://review.whamcloud.com/39593
Tested-by: jenkins <devops@whamcloud.com>

LUDOC-11 misc: unify header and add vim footer

Make the header sections consistent and wrapped at 80 columns.
The xmlns URLs cannot be changed to https or the markup breaks.

Add a vim footer to expand tabs into spaces for consistency.

Signed-off-by: Andreas Dilger <adilger@whamcloud.com>
Change-Id: Ib871575ba2ede8e73b35b4683abf35e5db3ebbe5
Reviewed-on: https://review.whamcloud.com/39582
Tested-by: jenkins <devops@whamcloud.com>

LUDOC-475 quota: notes about lfs commands

Update documentation according to changes in LU-1842.
Remove lsf commands quotachown, quotainv.
Update documentation according to changes in LU-5975.
Remove lsf commands quotacheck, quotaon, quotaoff.

Signed-off-by: Vikentsi Lapa <vlapa@whamcloud.com>
Change-Id: If0b823cf436a8154588ff2056a50fbdb247ad977
Reviewed-on: https://review.whamcloud.com/39451
Tested-by: jenkins <devops@whamcloud.com>
Reviewed-by: Andreas Dilger <adilger@whamcloud.com>

LUDOC-11 misc: remove pre-2.5 conditional text

Remove conditional text in the manual for Lustre versions earlier
than 2.5.  It is unlikely that many of the changes in the newer
manual are relevant to such old releases, and they would be better
off using the old manual, if needed.

Signed-off-by: Andreas Dilger <adilger@whamcloud.com>
Change-Id: I82972511a5a53cae0170d37ec422e0ef2fa7dfce
Reviewed-on: https://review.whamcloud.com/38364
Tested-by: jenkins <devops@whamcloud.com>
Reviewed-by: James Nunez <jnunez@whamcloud.com>

LUDOC-469 hsm: correct description of NBR HSM policy

Correct the description of the Non-Blocking Restore HSM policy.

Signed-off-by: John L. Hammond <jhammond@whamcloud.com>
Change-Id: I0b58bcef3623cf19d067cfb64093176bc40c93ce
Reviewed-on: https://review.whamcloud.com/38497
Tested-by: jenkins <devops@whamcloud.com>
Reviewed-by: Aurelien Degremont <degremoa@amazon.com>
Reviewed-by: Andreas Dilger <adilger@whamcloud.com>

LU-10391 lnet: document the accept= parameter properly

The lnet "accept=" module parameter was incorrectly documented
as "acceptor" in the manual, even though that has never existed.

Add a subsection for the "accept" parameter, as well as the
"ip2nets" parameter to make the formatting more consistent with
the rest of this section.

Signed-off-by: Andreas Dilger <adilger@whamcloud.com>
Change-Id: I3a8d7d862172a3ced899aafbc0cff38ae73ebbe5
Reviewed-on: https://review.whamcloud.com/37699
Tested-by: jenkins <devops@whamcloud.com>
Reviewed-by: Aurelien Degremont <degremoa@amazon.com>
Reviewed-by: Serguei Smirnov <ssmirnov@whamcloud.com>
Reviewed-by: Joseph Gmitter <jgmitter@whamcloud.com>

LUDOC-465 misc: fix typo in --mode to be 0666

This trivial patch changes a typo for the --mode option
to use 'zero' instead of 'capital-O' in 0666.

Signed-off-by: Joseph Gmitter <jgmitter@whamcloud.com>
Change-Id: I1b9e5ed0b096f57d9713adf0a42405e9e2ea1036
Reviewed-on: https://review.whamcloud.com/37716
Tested-by: jenkins <devops@whamcloud.com>

LUDOC-465 foreign: Add foreign LOV/LMV documentation

Description of and usage information for the foreign
LOV/LMV format that has been introduced by patches
for LU-11376.

Signed-off-by: Bruno Faccini <bruno.faccini@intel.com>
Change-Id: Icf171598c52e49f2b5611c1861498baf8ec50aa6
Reviewed-on: https://review.whamcloud.com/37425
Tested-by: jenkins <devops@whamcloud.com>
Reviewed-by: Andreas Dilger <adilger@whamcloud.com>
Reviewed-by: Wang Shilong <wshilong@ddn.com>

LUDOC-11 misc: correct location/setting qos_threshold_rr

The parameter qos_threshold_rr has moved from /sys/fs/.../lov
to lod and, to set this parameter, the command 'lctl set_param'
command should be run on the MDS.  These two things need to be
corrected in the manual.

Change-Id: Ide6d809d2d36e36504d014fb511df82ada80d977
Signed-off-by: James Nunez <jnunez@whamcloud.com>
Reviewed-on: https://review.whamcloud.com/36695
Tested-by: jenkins <devops@whamcloud.com>
Reviewed-by: Andreas Dilger <adilger@whamcloud.com>

LUDOC-11 misc: fix typo in lru_size=clear command

Fix a small typo in the command to flush the xattr cache from the
client by cancelling the MDC locks.

Signed-off-by: Stephane Thiell <sthiell@stanford.edu>
Change-Id: I449a1471414ed3195f6cbb4bd21691a0470eff90
Reviewed-on: https://review.whamcloud.com/37153
Tested-by: jenkins <devops@whamcloud.com>
Reviewed-by: Joseph Gmitter <jgmitter@whamcloud.com>

LUDOC-441 lnet: Add Multi-Rail Routing Documentation

This patch adds the feature documentation for the LNet Health
based routing work landed in LU-11297.

Signed-off-by: Joseph Gmitter <jgmitter@whamcloud.com>
Change-Id: Id41cf9b16b142a0e6fb797b560a3a553714ff1fd
Reviewed-on: https://review.whamcloud.com/36573
Tested-by: jenkins <devops@whamcloud.com>

LUDOC-442 dne: directory creation by space/inode

This patch adds the feature documentation for the DNE
work landed under LU-11213 and LU-12624 in Lustre 2.13.

Signed-off-by: Joseph Gmitter <jgmitter@whamcloud.com>
Signed-off-by: Lai Siyao <lai.siyao@whamcloud.com>
Change-Id: Ie76e0fae1fed92e30ebf1a4451895615d5a9c7d2
Reviewed-on: https://review.whamcloud.com/36615
Tested-by: jenkins <devops@whamcloud.com>

LUDOC-436 sel: add self-extending layout documentation

This patch adds the feature documentation for the
Self-Extending Layout feature added in LU-10070.

Signed-off-by: Joseph Gmitter <jgmitter@whamcloud.com>
Signed-off-by: Vitaly Fertman <c17818@cray.com>
Change-Id: I22e7fab4dfc868374c288b1034ab5cbbb6f58367
Reviewed-on: https://review.whamcloud.com/36561
Tested-by: jenkins <devops@whamcloud.com>
Reviewed-by: Andreas Dilger <adilger@whamcloud.com>

LUDOC-432 pcc: Persistent Client Cache documentation

Description of and usage information for the Persistent Client
Cache (PCC) feature.

Change-Id: Ifdddeb7b0f82937426b74360658ab3ee6ccfd15d
Signed-off-by: Qian Yingjin <qian@ddn.com>
Reviewed-on: https://review.whamcloud.com/34769
Reviewed-by: Joseph Gmitter <jgmitter@whamcloud.com>
Tested-by: jenkins <devops@whamcloud.com>

LUDOC-456 misc: Update the xml ids in BenchmarkingTests.xml

This patch updates the xml:id for each section to be a meaningful
name.  Other pages using those ids were also updated accordingly.

The patch also reformats the code to adhere to the 80 cols limit.

Signed-off-by: Joseph Gmitter <jgmitter@whamcloud.com>
Change-Id: I2c880ef7657e4bd9287a2e2596d8dbdc461f8ebe
Reviewed-on: https://review.whamcloud.com/36047
Tested-by: jenkins <devops@whamcloud.com>
Reviewed-by: Andreas Dilger <adilger@whamcloud.com>

LUDOC-11 config: discourage on-board device cache

Recommend against any cache onboard internal HBA devices.

Signed-off-by: Andreas Dilger <adilger@whamcloud.com>
Change-Id: Ia34e2fffb9008b360343a27d4cf599ec6f3fe0ea
Reviewed-on: https://review.whamcloud.com/36168
Tested-by: jenkins <devops@whamcloud.com>
Reviewed-by: Joseph Gmitter <jgmitter@whamcloud.com>

LUDOC-455 mdt: Document the mdt readonly parameter

This patch adds documentation for the mdt.*.readonly
parameter added in LU-11811.

Signed-off-by: Joseph Gmitter <jgmitter@whamcloud.com>
Change-Id: I53cc58b54e54b0a198141d3944a4970e3f992ce7
Reviewed-on: https://review.whamcloud.com/36012
Reviewed-by: James Nunez <jnunez@whamcloud.com>
Reviewed-by: Andreas Dilger <adilger@whamcloud.com>
Tested-by: jenkins <devops@whamcloud.com>

LUDOC-11 misc: Update the xml ids in LustreMaintenance.xml

This patch updates the xml:id for each section to be a meaningful
name.  Other pages using those ids were also updated accordingly.

Signed-off-by: Joseph Gmitter <jgmitter@whamcloud.com>
Change-Id: I643500b38f213117ff29aeb8ef1270431672e38a
Reviewed-on: https://review.whamcloud.com/36015
Tested-by: jenkins <devops@whamcloud.com>
Reviewed-by: Andreas Dilger <adilger@whamcloud.com>

LUDOC-11 debug: fix went_back_in_time label

Move the went_back_in_time label from <title> to <section> so that
it appears in the table of contents.

Signed-off-by: Andreas Dilger <adilger@whamcloud.com>
Change-Id: Id14f19a9d31643d44038446b93edd944db6ca2fc
Reviewed-on: https://review.whamcloud.com/35996
Tested-by: jenkins <devops@whamcloud.com>

LUDOC-11 debug: add went_back_in_time label

Add a section label for the "went back in time" error message,
so that it can more easily be referenced by an error message
in the code (formerly a link to a bugzilla ticket).

Improve the description of the problem and reformat the text
to fit within 80 columns.

Signed-off-by: Andreas Dilger <adilger@dilger.ca>
Change-Id: I612cbd090cd695272009754364be53f65c3ebbe5
Reviewed-on: https://review.whamcloud.com/35954
Tested-by: jenkins <devops@whamcloud.com>
Reviewed-by: Joseph Gmitter <jgmitter@whamcloud.com>

LUDOC-450 manual: Fix typo

Fix spelling of significant

Change-Id: I8715103eac85324ae4f65f986264b30d0ad6a5f1
Signed-off-by: Nathaniel Clark <nclark@whamcloud.com>
Reviewed-on: https://review.whamcloud.com/35933
Tested-by: jenkins <devops@whamcloud.com>
Reviewed-by: Joseph Gmitter <jgmitter@whamcloud.com>

LUDOC-11 utilities: remove --count flag

The 'lfs setstripe' utility used to allow the user to set
the file stripe count using the "--count" option.  This
option was replaced with "--stripe-count".  Make this
update in the manual.

Change-Id: I782f59222ab3b606fec328b0973ab0c39ddb42fe
Signed-off-by: James Nunez <jnunez@whamcloud.com>
Reviewed-on: https://review.whamcloud.com/35872
Tested-by: jenkins <devops@whamcloud.com>
Reviewed-by: Joseph Gmitter <jgmitter@whamcloud.com>

LUDOC-405 quota: add default quota

Add documentation for default quota.

Change-Id: I63c3a7ea6d410e22c4d2706c294ea2cde2661fce
Signed-off-by: Hongchao Zhang <hongchao@whamcloud.com>
Reviewed-on: https://review.whamcloud.com/34720
Tested-by: jenkins <devops@whamcloud.com>
Reviewed-by: James Nunez <jnunez@whamcloud.com>
Reviewed-by: Joseph Gmitter <jgmitter@whamcloud.com>

LUDOC-449 misc: Use .png files instead of .svg

Some browsers are not displaying figures in the manual that are
using .svg format.  Since all other images are using .png format,
this patch addresses the few svg images that are in the figures
directory:
figures/File_Write.svg:  duplicate png exists; Unused - removed
figures/HSM_copytool.svg:  Converted to png and removed
figures/MDTs_Failover.svg: duplicate png exists;  Unused - removed
figures/Metadata_File.svg: duplicate png exists;  Unused - removed
figures/TBF_policy.svg:  Converted to png and removed

Signed-off-by: Joseph Gmitter <jgmitter@whamcloud.com>
Change-Id: I18132933d9bb51a73c084bf42cf2f59355cbef4e
Reviewed-on: https://review.whamcloud.com/35558
Tested-by: jenkins <devops@whamcloud.com>
Reviewed-by: James Nunez <jnunez@whamcloud.com>

LUDOC-448 config: improve limits description

Improve the description of number of objects per OST to reflect that
this increases with the number of MDTs in the filesystem.  Also
increase the maximum ldiskfs and ZFS filesystem sizes used today.

Increase RAM sizes for MDS and OSS nodes to reflect current usage.

Signed-off-by: Andreas Dilger <adilger@whamcloud.com>
Change-Id: Icbacfc42ca0faa0e5aeba8372f09ca48413ebbe5
Reviewed-on: https://review.whamcloud.com/35334
Reviewed-by: Joseph Gmitter <jgmitter@whamcloud.com>
Tested-by: jenkins <devops@whamcloud.com>

LUDOC-11 jobid: cover newer JobID functionality

Describe the complex JobID format-string functionality added in
2.12, the per-node JobID added in 2.8, and the per-session JobID
added in 2.13.

Signed-off-by: Andreas Dilger <adilger@whamcloud.com>
Change-Id: I863cac0d63482fd0b3ab4e10d4ba3a6b7f3ebbe5
Reviewed-on: https://review.whamcloud.com/35503
Tested-by: jenkins <devops@whamcloud.com>
Reviewed-by: Joseph Gmitter <jgmitter@whamcloud.com>

LUDOC-11 e2fsck: fix typo in description

Fix minor typo in description of e2fsck times.

Signed-off-by: Andreas Dilger <adilger@whamcloud.com>
Change-Id: Id5dd47d60f34fe5469d887c6640e48be296b1d97
Reviewed-on: https://review.whamcloud.com/35508
Tested-by: jenkins <devops@whamcloud.com>
Reviewed-by: Joseph Gmitter <jgmitter@whamcloud.com>

LUDOC-443 stripe: Add overstriping to manual

Add overstriping to Lustre manual.

Change-Id: If092cf0276e74400527b740dbb4e5b92a9ab489d
Signed-off-by: Patrick Farrell <pfarrell@whamcloud.com>
Reviewed-on: https://review.whamcloud.com/35324
Reviewed-by: Joseph Gmitter <jgmitter@whamcloud.com>
Tested-by: jenkins <devops@whamcloud.com>

LUDOC-382 Tag lfsck_query as lustre 2.9

Set condition on lfsck_query to be Lustre 2.9

Change-Id: I7240344433dfae3f11ca7a010dccec5320bdbcea
Signed-off-by: Nathaniel Clark <nclark@whamcloud.com>
Reviewed-on: https://review.whamcloud.com/35319
Reviewed-by: Joseph Gmitter <jgmitter@whamcloud.com>
Tested-by: jenkins <devops@whamcloud.com>

LUDOC-444: Fix typo "completely quite" to quiescent

Change "completely quite" to quiescent.

Change-Id: I7ebc2e86ead4499b4dd271f2a9ca3fbd942c4857
Signed-off-by: Nathaniel Clark <nclark@whamcloud.com>
Reviewed-on: https://review.whamcloud.com/35316
Tested-by: jenkins <devops@whamcloud.com>
Reviewed-by: Joseph Gmitter <jgmitter@whamcloud.com>

LUDOC-445 fix minor typo

Fix verb tense.

Change-Id: Id457f986f9f0c8b3c3e6d2590ade53c790357275
Signed-off-by: Nathaniel Clark <nclark@whamcloud.com>
Reviewed-on: https://review.whamcloud.com/35297
Reviewed-by: Joseph Gmitter <jgmitter@whamcloud.com>
Tested-by: Jenkins

LUDOC-440 lsom: Update examples description

This patch updates the introductory sentence to LSoM to state that
it can be used in various vender offerings, rather than calling
out specific vendor tools.

Signed-off-by: Joseph Gmitter <jgmitter@whamcloud.com>
Change-Id: I678c4f15ebe6781785cd8e8251cc9858358ef674
Reviewed-on: https://review.whamcloud.com/35142
Tested-by: Jenkins
Reviewed-by: Peter Jones <pjones@whamcloud.com>

LUDOC-435 quotas: Update project quotas requirements

This patch adds specific notes in the project quota documentation
to explicitly state that a patched server is required and that
patchless servers do not support project quotas.

The patch also removes the quota enabling instructions for Lustre
versions older than 2.4.

Signed-off-by: Joseph Gmitter <jgmitter@whamcloud.com>
Change-Id: Iaaa602012b244c225605ffe458e63634a7f9e40a
Reviewed-on: https://review.whamcloud.com/34516
Tested-by: Jenkins
Reviewed-by: Wang Shilong <wshilong@ddn.com>
Reviewed-by: Andreas Dilger <adilger@whamcloud.com>

LUDOC-431 lnet: doc for asymmetrical route checking

This patch adds documentation for the asymmetrical route checking
feature, as implemented by LU-11894.
This doc is added under the Configuring LNet via lnetctl section of
the Configuring Lustre Networking chapter.

Signed-off-by: Sebastien Buisson <sbuisson@ddn.com>
Change-Id: Ia3214528b2bd3ae3e62dc40c06ce1b3ed565e2f3
Reviewed-on: https://review.whamcloud.com/34120
Reviewed-by: Amir Shehata <ashehata@whamcloud.com>
Tested-by: Jenkins
Reviewed-by: Olaf Weber <olaf.weber@hpe.com>
Reviewed-by: Joseph Gmitter <jgmitter@whamcloud.com>

LUDOC-434 misc: fix Lustre version in few places

Lustre version was not properly set in a few places.

Signed-off-by: Sebastien Buisson <sbuisson@ddn.com>
Change-Id: Ib1b19da67853719627d36e8d9ecb4cd747249739
Reviewed-on: https://review.whamcloud.com/34469
Tested-by: Jenkins
Reviewed-by: Joseph Gmitter <jgmitter@whamcloud.com>

LUDOC-429 sec: doc for SELinux status checking

This patch adds documentation for the SELinux status checking feature,
as implemented by LU-8955.
This doc is added under the Managing Security in a Lustre File System
section.

Signed-off-by: Sebastien Buisson <sbuisson@ddn.com>
Change-Id: I20ef77b14ae6515fa759f4b47a36f6b16b8eb93f
Reviewed-on: https://review.whamcloud.com/34083
Tested-by: Jenkins
Reviewed-by: Joseph Gmitter <jgmitter@whamcloud.com>

LU-11874 rpc: Update command to persisently set brw_size

This patch updates the large bulk IO (16MB RPC) section
to use set_param -P in persistently setting brw_size
and max_pages_per_rpc as the current conf_param command
does not work with wildcards.

Signed-off-by: Joseph Gmitter <jgmitter@whamcloud.com>
Change-Id: I1cfec45a032b3bc4bf97c14ef6db2a3f0901194f
Reviewed-on: https://review.whamcloud.com/34193
Tested-by: Jenkins
Reviewed-by: Andreas Dilger <adilger@whamcloud.com>
Reviewed-by: James Simmons <uja.ornl@yahoo.com>
Reviewed-by: Stephan Thiell <sthiell@stanford.edu>

LUDOC-430 nodemap: doc for 'default' nodemap

This patch adds documentation about the 'default' nodemap.
This doc is added under the Mapping UIDs and GIDs with Nodemap
chapter.

Signed-off-by: Sebastien Buisson <sbuisson@ddn.com>
Change-Id: I9ae21cc4ae321f804f950a9a05e48f1df91c9dc0
Reviewed-on: https://review.whamcloud.com/34089
Tested-by: Jenkins
Reviewed-by: James Nunez <jnunez@whamcloud.com>
Reviewed-by: Joseph Gmitter <jgmitter@whamcloud.com>

LUDOC-11 misc: Update custom styles with 'l2D' for 2.13

This patch updates the custom style sheets with 'l2D' to
be used for content added in the Lustre 2.13 release.

Signed-off-by: Joseph Gmitter <jgmitter@whamcloud.com>
Change-Id: I288519c5231e9732b99f7b3d5f20c93979225e7c
Reviewed-on: https://review.whamcloud.com/34096
Tested-by: Jenkins

LUDOC-428 sec: doc for Lustre isolation

This patch adds documentation for the Lustre isolation feature,
by using the 'fileset' parameter on nodemap as submitted for
LU-7846.
This doc is added under the Managing Security in a Lustre File System
section.

Signed-off-by: Sebastien Buisson <sbuisson@ddn.com>
Change-Id: I8ed1fe754f65a7aa58a8bbc053f4c5167588b6b0
Reviewed-on: https://review.whamcloud.com/34062
Tested-by: Jenkins
Reviewed-by: Andreas Dilger <adilger@whamcloud.com>
Reviewed-by: Joseph Gmitter <jgmitter@whamcloud.com>

LUDOC-402 lsom: Lazy Size on MDT documentation

Description of and usage information for the Lazy Size on
MDT feature.

Change-Id: Iad3d1349be871fba7dda1f92931cd8162da44886
Signed-off-by: James Nunez <jnunez@whamcloud.com>
Reviewed-on: https://review.whamcloud.com/33899
Tested-by: Jenkins
Reviewed-by: Andreas Dilger <adilger@whamcloud.com>

LUDOC-396 lnet: Add LNet Health Documentation

This patch adds the feature documentation for LNet Health,
implemented in LU-9120.

The patch also changes tabs to two spaces throughout the file.

Signed-off-by: Joseph Gmitter <jgmitter@whamcloud.com>
Change-Id: I50fcb2ceb7f35e7b423a817bb19087763ba9906a
Reviewed-on: https://review.whamcloud.com/33630
Tested-by: Jenkins
Reviewed-by: Amir Shehata <ashehata@whamcloud.com>
Reviewed-by: Jian Yu <yujian@whamcloud.com>
Reviewed-by: Andreas Dilger <adilger@whamcloud.com>

LUDOC-423 misc: Add space between link end and 'repository'

This patch inserts a space between the link and the word
'repository' in several places.

Signed-off-by: Joseph Gmitter <jgmitter@whamcloud.com>
Change-Id: Iad039c0f202a2e7036fcad250d3042be51a75ad6
Reviewed-on: https://review.whamcloud.com/33851
Tested-by: Jenkins

LUDOC-422 dom: Fix bad DoM link

This patch fixes a link to the DoM section of the manual.

Signed-off-by: Joseph Gmitter <jgmitter@whamcloud.com>
Change-Id: Iebc608233b0d35ec011e313ce2ace2a727e2d3ea
Reviewed-on: https://review.whamcloud.com/33819
Tested-by: Jenkins

LU-11638 admin: debug space management/missing objects

Improve troubleshooting section - formatting, improve incorrect
content, update to newer descriptions of how the MDS and OSS
precreate objects, and what they now do if there is a problem.

Improve the description of free space management.  Add example usage
of "open_files" and "lsof" and "lfs df" and "lfs df -i" output.

Improve Jira search description, and update the URL for the
lustre-discuss mailing list.

Fix some cross-references to be more descriptive (lots more could
be done in this area).

Signed-off-by: Andreas Dilger <adilger@whamcloud.com>
Change-Id: I19dadb826d2fcf5e298f04a4c660c7a8857995c9
Reviewed-on: https://review.whamcloud.com/33629
Reviewed-by: Joseph Gmitter <jgmitter@whamcloud.com>
Tested-by: Jenkins

LU-8066 misc: replace /proc with "lctl get/set_param"

Replace most remaining references to /proc or /sys with equivalent
"lctl get_param" or "lctl set_param" usage.  Discourage direct
use of /proc and /sys values from user scripts.

The description of l_getidentity and associated parameters was
duplicated in multiple places, differentiate the l_getidentity
documentation from the parameter interface for identity_upcall
and identity_info.  Add in descriptions of the identity_expire
and identity_acquire_expire parameters as well.

Add better descriptions of the debug masks, adding in missing
mask values.  Replace use of sysctl for setting and getting
the debug mask with lctl.

Rename a few section labels to give them human-readable names.

Signed-off-by: Andreas Dilger <adilger@whamcloud.com>
Change-Id: I69e27511563a948f2148d9d39480f83a0f67eca6
Reviewed-on: https://review.whamcloud.com/33686
Tested-by: Jenkins
Reviewed-by: James Simmons <uja.ornl@yahoo.com>
Reviewed-by: Ben Evans <bevans@cray.com>
Reviewed-by: Joseph Gmitter <jgmitter@whamcloud.com>

LUDOC-395 dne: striped directory migration documentation

This patch adds documentation for the manual striped
directory supported added by LU-4684.

Signed-off-by: Joseph Gmitter <jgmitter@whamcloud.com>
Change-Id: Ib04f8e1860dfc8d383bd7910a44965de00b5b9b3
Reviewed-on: https://review.whamcloud.com/33550
Reviewed-by: Andreas Dilger <adilger@whamcloud.com>
Tested-by: Jenkins

LUDOC-377 misc: cleanup of root squash settings

Specify how to retrieve root squash settings using
lctl get_param and also document the set_param option
in addition to the conf_param settings already described.

Adds a note to mention nodemaps as an alternative.

Signed-off-by: Joseph Gmitter <joseph.gmitter@intel.com>
Change-Id: I753296f097b0006b084e8e0e7e11c369df3105ee
Reviewed-on: https://review.whamcloud.com/27954
Tested-by: Jenkins
Reviewed-by: Andreas Dilger <adilger@whamcloud.com>

LUDOC-11 misc: Correct version number for condition l2C

The release number for l2C is wrong in the PDF style sheet,
incorrectly having 2.11 instead of 2.12.

Signed-off-by: Joseph Gmitter <jgmitter@whamcloud.com>
Change-Id: Id7fce45e06d9019f76b9c204ae152ff92ed530a8
Reviewed-on: https://review.whamcloud.com/33613
Tested-by: Jenkins

LUDOC-399 dom: improve description of inode limits

Fix one typo in the MDT inode size description (current default is
2KB/inode instead of old 4KB/inode) value.

Clarify the description of DoM usage and limits.

Signed-off-by: Andreas Dilger <adilger@whamcloud.com>
Change-Id: I42259e45fdbfb2e8541745ce4f794c2b123ebbe5
Reviewed-on: https://review.whamcloud.com/33562
Tested-by: Jenkins
Reviewed-by: Stephan Thiell <sthiell@stanford.edu>
Reviewed-by: Mike Pershin <mpershin@whamcloud.com>
Reviewed-by: Joseph Gmitter <jgmitter@whamcloud.com>

LU-8541 ldlm: describe lru_max_age better

Add a descripton of the LDLM lru_max_age parameter, including
the (new in 2.11) ability to specify a suffix of "s" to indicate
the units are in seconds.

Improve the description and formatting of lru_size as well.

Signed-off-by: Andreas Dilger <adilger@whamcloud.com>
Change-Id: I70d1193cb5096dd1139ba85d45ab26566209c2ff
Reviewed-on: https://review.whamcloud.com/33406
Reviewed-by: James Simmons <uja.ornl@yahoo.com>
Reviewed-by: Joseph Gmitter <jgmitter@whamcloud.com>
Tested-by: Jenkins

LUDOC-11 misc: remove some 'l23' conditions add 'l2C'

Remove many of the old Lustre 2.3 annotations from the manual,
since there are few, if any, users working with such old versions
of Lustre, and they can always reference an older version of the
manual.

Improve content in affected sections of the manual.

Add the 'l2C' condition for the Lustre 2.12 release.  This is needed
to document the new RPC checksum types added to the 2.12 release.

Signed-off-by: Andreas Dilger <adilger@whamcloud.com>
Change-Id: I8d10c6451899a470a12600452bc905ad0b545889
Reviewed-on: https://review.whamcloud.com/33378
Tested-by: Jenkins
Reviewed-by: Joseph Gmitter <jgmitter@whamcloud.com>

LUDOC-11 osc: document tunable parameters

Add or improve the documentation for the OSC RPC parameters:
  osc.*.{checksums,checksum_type,max_dirty_mb,max_pages_per_rpc,
         max_rpcs_in_flight}

Add documetation for the llite readahead parameters:
  llite.*.{max_read_ahead_mb,max_read_ahead_per_file_mb,
           max_read_ahead_whole_mb}

Clean up the existing parameter sections to be more consistent.

Signed-off-by: Andreas Dilger <adilger@whamcloud.com>
Change-Id: Ieaf09e175456b7a60d3fbd3a3ec5d020fb4d98e3
Reviewed-on: https://review.whamcloud.com/33375
Tested-by: Jenkins

LUDOC-11 lfs: use a more realistic PFL layout

Don't use an example for "lfs setstripe" that explicitly sets an
index of 0, since this will cause an imbalance in the OST usage,
and is not a good example for users to follow.

Create the PFL layout with a more typical configuration.

Signed-off-by: Andreas Dilger <adilger@whamcloud.com>
Change-Id: Ic7ca6d1b25760d1292c7ac2cfb3c11497c2efa52
Reviewed-on: https://review.whamcloud.com/33367
Tested-by: Jenkins
Reviewed-by: Joseph Gmitter <jgmitter@whamcloud.com>

LUDOC-414 utils: document the lfs data_version command

Update the lfs utility synopsis and table with a description of the
lfs data_version command.

Signed-off-by: Nikitas Angelinas <nangelinas@cray.com>
Change-Id: Id6c474dfdd8d8b5884b220768fbf59294a2efd86
Reviewed-on: https://review.whamcloud.com/33200
Tested-by: Jenkins
Reviewed-by: Andreas Dilger <adilger@whamcloud.com>
Reviewed-by: Joseph Gmitter <jgmitter@whamcloud.com>

LUDOC-412 misc: Update byte prefixes to use IEC

This patch fixes binary prefixes used when referencing
storage size to the IEC definitions:
1024    Ki  kibi
1024^2  Mi  mebi
1024^3  Gi  gibi
1024^4  Ti  tebi
1024^5  Pi  pebi
1024^6  Ei  exbi
1024^7  Zi  zebi
1024^8  Yi  yobi

Signed-off-by: Joseph Gmitter <jgmitter@whamcloud.com>
Change-Id: I3fac1dc28e96c34d286f9b14e8cd2b46acb87f53
Reviewed-on: https://review.whamcloud.com/33075
Tested-by: Jenkins
Reviewed-by: Andreas Dilger <adilger@whamcloud.com>

LUDOC-11 config: Improve writeconf description

Improve the description of the "tunefs.lustre --writeconf" command.

Signed-off-by: Andreas Dilger <adilger@whamcloud.com>
Change-Id: I96df1d566b83b118ef58ea17cffd1b6fad12fc24
Reviewed-on: https://review.whamcloud.com/32886
Reviewed-by: Joseph Gmitter <jgmitter@whamcloud.com>
Tested-by: Jenkins

LUDOC-249 migrate: Improve lfs_migrate documentation

List the new method of max_create_count=0 for disabling the MDS to
create new objects on OSTs during migration.  This avoids issues
when using "deactivate" where the OST objects were not being deleted
as objects are being moved off of the OST.

Separate the directory migration from the data migration more clearly.

Signed-off-by: Andreas Dilger <adilger@whamcloud.com>
Change-Id: Ic8fa99271d8d543ec93ddac3917c8a7cad49973b
Reviewed-on: https://review.whamcloud.com/32882
Tested-by: Jenkins
Reviewed-by: Joseph Gmitter <jgmitter@whamcloud.com>

LU-11181 mdt: include DoM in inode ratio discussion

Reference Data-on-MDT in the discussion about ldiskfs inode ratios.
We default to 2KB/inode on the MDT, but with DoM we may want to
change this to 64KB/inode or higher, depending on the average size
of small files stored on the MDT.

Also mention that "lfs df -i" and "df -i" will limit the reported
available inode count to the total number of available inodes on
the OSTs.

Signed-off-by: Andreas Dilger <adilger@whamcloud.com>
Change-Id: I53c4d35129ffb5c7732771a6ddab3aa723758872
Reviewed-on: https://review.whamcloud.com/32887
Tested-by: Jenkins
Reviewed-by: Joseph Gmitter <jgmitter@whamcloud.com>

LUDOC-371 config: Add lctl 'clear_conf' documentation.

The new lctl command "clear_conf" is added to allow
administartors to clear configuration files by removing
SKIP records. The old configuration files are backed up.

Signed-off-by: Arshad Hussain <arshad.hussain@seagate.com>
Signed-off-by: Vladimir Saveliev <vladimir.saveliev@seagate.com>
Change-Id: Iacc52127b0b93e736430cc13d4c9c852eac8dc2d
Seagate-bug-id: MRP-2091
Reviewed-on: https://review.whamcloud.com/26083
Tested-by: Jenkins
Reviewed-by: Arshad Hussain <arshad.super@gmail.com>
Reviewed-by: Joseph Gmitter <jgmitter@whamcloud.com>

LUDOC-11 misc: URL cleanup

This patch cleans up all links from hpdd.intel.com to
whamcloud.com.  The patch also changes the URL for
the 'make push' target of the Makfile for those using
'make push' to push changes.

Signed-off-by: Joseph Gmitter <jgmitter@whamcloud.com>
Change-Id: I7560b6c6397897a85ce731642709d80cd1cde20c
Reviewed-on: https://review.whamcloud.com/32729
Tested-by: Jenkins
Reviewed-by: Andreas Dilger <adilger@whamcloud.com>

LUDOC-379: Ladvise Lockahead

Correct errors in lockahead documentation.

Change-Id: I833b782c437d5429bca365207d05df21d625eb26
Signed-off-by: Patrick Farrell <paf@cray.com>
Reviewed-on: https://review.whamcloud.com/32436
Tested-by: Jenkins
Reviewed-by: Joseph Gmitter <joseph.gmitter@intel.com>

LUDOC-379: Ladvise Lockahead

Add documentation for lockahead feature.

Change-Id: I40225ef8c50f9f44e41d3ddbe4d700a9b02b1994
Signed-off-by: Patrick Farrell <paf@cray.com>
Reviewed-on: https://review.whamcloud.com/32331
Tested-by: Jenkins
Reviewed-by: Joseph Gmitter <joseph.gmitter@intel.com>

LUDOC-403 acl: Update link for POSIX ACL paper

This patch updates the link to the POSIX ACL paper by SuSe Labs.

The patch also refactors the source file to adhere to coding
standards, namely the 80 col limit and appropriate section names.

Signed-off-by: Joseph Gmitter <joseph.gmitter@intel.com>
Change-Id: I6898eb389fb22e545ec768d0697681cfb36a7c73
Reviewed-on: https://review.whamcloud.com/32312
Tested-by: Jenkins
Reviewed-by: James Nunez <james.a.nunez@intel.com>

LUDOC-385 dom: fix figure to match description

The figure describes 4MB OST stripe_size, but the diagram shows five
blocks within the "4MB" range on the OSTs, with the first 1MB block
being (correctly) sparse because of the DoM component.  Fix this to
show the proper 4MB range on the OST objects.

Also, show the MB offset of each OST stripe as "4, 8, 4N" rather than
"2, 3, N" to better explain how Lustre striping works.

Signed-off-by: Andreas Dilger <andreas.dilger@intel.com>
Change-Id: I1b9487c4b19cecbdc738744381166968373ebbe5
Reviewed-on: https://review.whamcloud.com/32263
Tested-by: Jenkins
Reviewed-by: Joseph Gmitter <joseph.gmitter@intel.com>

LUDOC-328 tbf: add UID/GID based policy to NRS-TBF section

Update NRS-TBF policy section to reflect UID/GID based TBF
policy:
- format: uid={uid} or gid={gid} or uid={uid}&gid={gid}
- Lustre-commit: e0cdde123c14729a340cf937cf9580be7c9dd9c1
- Lustre-change: http://review.whamcloud.com/27608

Change-Id: I49302f35bb6fae3de9410a8b84940aa8df7b0ca7
Signed-off-by: Emoly Liu <emoly.liu@intel.com>
Reviewed-on: https://review.whamcloud.com/31769
Tested-by: Jenkins
Reviewed-by: Joseph Gmitter <joseph.gmitter@intel.com>

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>

LUDOC-11 misc: minor tweak to NFS export doc

Mention that Lustre can also be exported by NFS Ganesha.

Signed-off-by: Andreas Dilger <andreas.dilger@intel.com>
Change-Id: I4e22ac1223409780293dde641f982e6fd5f36f76
Reviewed-on: https://review.whamcloud.com/31934
Tested-by: Jenkins
Reviewed-by: Joseph Gmitter <joseph.gmitter@intel.com>

LUDOC-161 zfs: Backup/Restore of ZFS backend filesystems

This patch documents how to backup/restore ZFS backend
filesystems at the file system level using 'tar'.  The
existing section on backing up an OST or MDT at the
filesystem level was updated to capture zfs.  Also, a
section has been added to discuss migrating between ZFS
and ldiskfs backends using the filesystem level
backup/restore process.

This work has landed to master under LU-7585.

Signed-off-by: Joseph Gmitter <joseph.gmitter@intel.com>
Change-Id: I20619e42c7313657599788a23caf4e867f714db6
Reviewed-on: https://review.whamcloud.com/30172
Reviewed-by: James Nunez <james.a.nunez@intel.com>
Tested-by: Jenkins

LUDOC-368 lnet:  Dynamic Discovery documentation

This patch adds documentation for the dynamic peer discovery
feature added in Lustre 2.11.0 by LU-9480.

Documentation is added to the LNet configuration section of the
manual.

Also, this patch does some refactoring of the affected
ConfiguringLNet.xml content file to use descriptive XML
ID tags instead of random integer strings as well as
fixing numerous 80 column length style issues in the
file.

Signed-off-by: Joseph Gmitter <joseph.gmitter@intel.com>
Change-Id: Iba9644f5777f0930bac7d0583072e651d04a222a
Reviewed-on: https://review.whamcloud.com/31735
Reviewed-by: Amir Shehata <amir.shehata@intel.com>
Tested-by: Jenkins
Reviewed-by: James Nunez <james.a.nunez@intel.com>

LUDOC-384 flr: File Level Redundancy (FLR) Documenation

This patch creates the initial documentation for the File
Level Redundancy (FLR) feature introduced by LU-9771 in the
Lustre 2.11.0 release.

The FLR feature allows for storing of the same data on
multiple OSTs for a variety of possible benefits and use
cases.

Signed-off-by: Joe Gmitter <joseph.gmitter@intel.com>
Signed-off-by: Jian Yu <jian.yu@intel.com>
Change-Id: I4c4ccb9e5c90144f4686e3853d56ebee459cee70
Reviewed-on: https://review.whamcloud.com/31657
Tested-by: Jenkins
Reviewed-by: Jinshan Xiong <jinshan.xiong@gmail.com>
Reviewed-by: James Nunez <james.a.nunez@intel.com>

LUDOC-328 tbf: add HTC strategy to NRS-TBF section

Update NRS-TBF policy section to reflect Hard Token Compensation
(HTC) strategy:
- meet realtime requirement with a new rule option "realtime=1"
- Lustre-commit: d11fa2c279593634cf6c4196b413a6d285b24e10
- Lustre-change: http://review.whamcloud.com/26087

Change-Id: I07ece7bd3022351a7f71d1ba9cfd2193d8261ccd
Signed-off-by: Emoly Liu <emoly.liu@intel.com>
Reviewed-on: https://review.whamcloud.com/31628
Tested-by: Jenkins
Reviewed-by: Joseph Gmitter <joseph.gmitter@intel.com>

LUDOC-391 audit: doc for Lustre Audit with Changelogs

This patch adds the documentation for the Lustre Audit with Changelogs
feature created in LU-9727.
This doc is added under the Lustre Monitoring section, along with
the Changelogs documentation.

Signed-off-by: Sebastien Buisson <sbuisson@ddn.com>
Change-Id: Ief72f277f148d226b462f18a06efe59e832fc065
Reviewed-on: https://review.whamcloud.com/30821
Tested-by: Jenkins
Reviewed-by: James Nunez <james.a.nunez@intel.com>
Reviewed-by: Joseph Gmitter <joseph.gmitter@intel.com>

LUDOC-385 dom: Initial Data on MDT (DoM) Documentation

This patch creates the initial Data on MDT (DoM)
documenation for the feature work added in LU-3285.
A new section in the manual is created specifally for DoM.

Signed-off-by: Joseph Gmitter <joseph.gmitter@intel.com>
Change-Id: I79baeb5639e3399f4f5ad8837e48c8dac78c00fd
Reviewed-on: https://review.whamcloud.com/30148
Tested-by: Jenkins
Reviewed-by: James Nunez <james.a.nunez@intel.com>

LUDOC-11 misc: update filesystem limits

Move Lustre filesystem limits out of "ldiskfs formatting options"
into its own section, since it also reflects limits for ZFS targets.
This change has a large amount of indent churn, but minimal content.

Other changes include:
- ldiskfs MDT journals can be up to 4GB by default
- ldiskfs OST filesystems can be at least 256TiB in size
- correct OST inode ratio table max inode count for 256TiB size
- correct OST inode ratio table to be "under 10GiB" instead of over
- increase maximum filesystem size to be "at least 1EB" for ldikfs

Clean up formatting in this section to wrap at 80 columns.

Signed-off-by: Andreas Dilger <andreas.dilger@intel.com>
Change-Id: Iae39e103e5b4d721ff987fb8c1d0b6294f07782d
Reviewed-on: https://review.whamcloud.com/30806
Tested-by: Jenkins
Reviewed-by: Joseph Gmitter <joseph.gmitter@intel.com>

LUDOC-305 maintenance: handling full/failed OSTs

Improve documentation related to handling full or failing OSTs.

Describe the "osp.*.max_create_count" parameter, and using it to
disable object creation on an OST, rather than deactivating the
OST completely.

Differentiate between disabling an OST for space balancing reasons
and a failing OST.  Add references to QOS space balancing and also
degraded mode for OSTs.

Use "lctl set_param osp.*.active=0" to deactivate the OST rather
than "lctl deactivate", since that is easier for users and they
are functionally equivalent.

Describe the use of "mkfs.lustre --replace" to replace failed OSTs,
rather than the need to backup/restore/binary edit OST config files.

Use proper names for affected sections and cross references, so
that the auto-generated URLs for these sections are useful.

Line-wrap modified sections of text.

Signed-off-by: Andreas Dilger <andreas.dilger@intel.com>
Change-Id: I4f253966f463ca1a83d0c7c4efcb22dfc02b6e3f
Reviewed-on: https://review.whamcloud.com/30864
Tested-by: Jenkins
Reviewed-by: Joseph Gmitter <joseph.gmitter@intel.com>