[LUDOC-317] document OST reserved space tunables Created: 11/Dec/15  Updated: 05/Oct/16  Resolved: 05/Oct/16

Status: Resolved
Project: Lustre Documentation
Component/s: None
Affects Version/s: None
Fix Version/s: None

Type: New Feature Priority: Minor
Reporter: Andreas Dilger Assignee: Lustre Manual Triage
Resolution: Fixed Votes: 0
Labels: None

Issue Links:
Blocker
is blocking LU-6910 Configurable values for OST reserved ... Resolved
Rank (Obsolete): 9223372036854775807

 Description   

Document the new OST free space tunables from http://review.whamcloud.com/15731 "LU-6910: osp: add procfs values for OST reserved size" in the user manual.

osp_pre_status=-ENOSPC is used to skip OST from object allocation.
The error was set when OST available space is less than 0.1% of total
OST size. This value is not configurable, so procfs files was
added:
reserved_mb_low - low watermark, if available space is less
		  than it, object allocation is stopped.
reserved_mb_high - highw watermark, if available space is more
		   than it, object allocation is enabled.

By default ~0.1% is reserved as low watermark. The high watermark
is twice bigger than the low by default.
High and low watermark could be changed by:
lctl set_param osp.lustre-OST0000-osc-MDT0000.reserved_mb_high=1024

When object allocation is disabled, a clients could appened to
existing files. And 0.1% is too low for them. For example, OST size
is 8TB, 0.1% is 8GB, if cluster has 1k clients, reserved space is
~8MB per client. The main reason of the patch is ability to increase
reserved space.


 Comments   
Comment by Andreas Dilger [ 11/Dec/15 ]

For details on how to submit changes to the manual, please see:

Comment by Gerrit Updater [ 11/Dec/15 ]

Alexander Boyko (alexander.boyko@seagate.com) uploaded a new patch: http://review.whamcloud.com/17560
Subject: LUDOC-317 proc: OST reserved size
Project: doc/manual
Branch: master
Current Patch Set: 1
Commit: cddc05720f42a77ee6a3c045dd53f9fbd1a956a6

Comment by Gerrit Updater [ 05/Oct/16 ]

Andreas Dilger (andreas.dilger@intel.com) merged in patch http://review.whamcloud.com/17560/
Subject: LUDOC-317 proc: OST reserved size
Project: doc/manual
Branch: master
Current Patch Set:
Commit: 862043c93966841745c57818fcf40bd86e31902e

Generated at Sat Feb 10 03:41:58 UTC 2024 using Jira 9.4.14#940014-sha1:734e6822bbf0d45eff9af51f82432957f73aa32c.