Commit Graph

53 Commits

Author SHA1 Message Date
Alfredo Deza
aa90ea25cf doc/rados/operations add a ref label to pool application
Signed-off-by: Alfredo Deza <adeza@redhat.com>
2017-08-16 08:20:01 -04:00
Alfredo Deza
e925b9f899 doc/rados/operations add newline after definition
Signed-off-by: Alfredo Deza <adeza@redhat.com>
2017-08-16 08:19:59 -04:00
Kefu Chai
f273712e1b doc: document bluestore compression settings
Signed-off-by: Kefu Chai <kchai@redhat.com>
2017-08-02 16:42:08 +08:00
Sage Weil
3de9f22ce0 Merge pull request #16423 from liewegas/wip-ls
mon: '* list' -> '* ls'

Reviewed-by: Kefu Chai <kchai@redhat.com>
2017-07-20 10:43:34 -05:00
Jason Dillaman
878d0b0c3f doc: document pool tags in rados pool operations doc
Signed-off-by: Jason Dillaman <dillaman@redhat.com>
2017-07-19 13:13:01 -04:00
Sage Weil
572a942f8f mon: 'auth list' -> 'auth ls'
Signed-off-by: Sage Weil <sage@redhat.com>
2017-07-19 12:33:14 -04:00
Sage Weil
dc7a2aaf7a erasure-code: ruleset-* -> crush-*
1) ruleset is an obsolete term, and
2) crush-{rule,failure-domain,...} is more descriptive.

Note that we are changing the names of the erasure code profile keys
from ruleset-* to crush-*.  We will update this on upgrade when the
luminous flag is set, but that means that during mon upgrade you cannot
create EC pools that use these fields.

When the upgrade completes (users sets require_osd_release = luminous)
existing ec profiles are updated automatically.

Signed-off-by: Sage Weil <sage@redhat.com>
2017-07-06 15:01:03 -04:00
Josh Durgin
bad606605a doc: update ec docs for overwrite support
Signed-off-by: Josh Durgin <jdurgin@redhat.com>
2017-04-19 17:45:43 -07:00
Sven Seeberg
804134a2bf renamed hit_set_grade_search_last_n to hit_set_search_last_n
Signed-off-by: Sven Seeberg <sseebergelverfeldt@suse.com>
2017-03-24 10:25:06 +01:00
Sage Weil
63bb2b7d45 doc: remove crash_replay_interval mentions
Signed-off-by: Sage Weil <sage@redhat.com>
2016-12-29 10:30:08 -05:00
Wido den Hollander
95ed04a536
doc: Add documentation about mon_allow_pool_delete before pool remove
Tell users they need to set this to true before Monitors will allow
pools to be removed.

Also update the Pending Release Notes so that users can find this change
there.

This was changed with commit 5d7f4ea

Signed-off-by: Wido den Hollander <wido@42on.com>
2016-11-23 12:18:21 +01:00
Barbora Ančincová
a9c0e7b789 Removed reference about pool ownership based on BZ#1368528
Signed-off-by: Bara Ancincova <bara@redhat.com>

https://bugzilla.redhat.com/show_bug.cgi?id=1368528

From email conversation with Sage and Sam:

I don't think it is used at all, and at a minimum it is
untested and undocumented and the implementation is alomst
certainly incomplete.

I definitely support removing any trace of it from the docs.

sage
2016-09-13 17:38:25 +05:30
Ken Dreyer
3c43185002 doc: more details for pool deletion
Prior to this change, the documention instructed administrators to
delete rulesets and users, but did not go into details regarding how to
do that.

Add example commands that admins may use to search for rulesets and
users that might reference the to-be-deleted pool.

Signed-off-by: Ken Dreyer <kdreyer@redhat.com>
2016-07-08 07:42:29 -06:00
Etienne Menguy
fa32bd3cb9 adding pg_num to pools documentation
Signed-off-by: Etienne Menguy <etienne.menguy@corp.ovh.com>
2016-04-13 13:25:30 +02:00
xiexingguo
ca50f42359 doc: batch small fixes, including typo, syntax etc.
Signed-off-by: xiexingguo <xie.xingguo@zte.com.cn>
2016-02-26 23:25:02 +08:00
Drunkard Zhang
593c1249d2 doc: rst style fix for pools document
Signed-off-by: Drunkard Zhang <gongfan193@gmail.com>
2015-12-07 10:45:03 +08:00
Mykola Golub
e6dcf1419a osd: store per pool scrub intervals in pool options
ceph osd pool set $POOL scrub_min_interval N
  ceph osd pool set $POOL scrub_max_interval N
  ceph osd pool set $POOL deep_scrub_interval N

If N > 0, this value is used for the pool instead of
the corresponding global parameter from the config
(osd_scrub_min_interval, osd_scrub_max_interval or
osd_deep_scrub_interval).

Fixes: #13077
Signed-off-by: Mykola Golub <mgolub@mirantis.com>
2015-11-27 13:35:51 +02:00
MingXin Liu
738d64c7e4 Doc: add temperature related stuff in documents and test scripts
Signed-off-by: MingXin Liu <mingxinliu@ubuntukylin.com>
Reviewed-by: Li Wang <liwang@ubuntukylin.com>
2015-11-11 15:22:33 +08:00
Guang Yang
6b1e4a69c5 cleanup: make the pool setting GET decription point to SET description
Signed-off-by: Guang Yang yguang@yahoo-inc.com
2015-09-30 00:48:12 +00:00
Guang Yang
ef59f7c737 doc: update doc for with new pool settings
Signed-off-by: Guang Yang yguang@yahoo-inc.com
2015-09-30 00:48:01 +00:00
Sage Weil
216eef53e9 Revert "osd: new pool settings: scrub intervals"
This reverts commit 30810da4b5.

After some discussion we have decided it is better to build a generic
dictionary in pg_pool_t to store infrequently used per-pool properties.

Signed-off-by: Sage Weil <sage@redhat.com>
2015-09-25 14:01:19 -04:00
Mykola Golub
30810da4b5 osd: new pool settings: scrub intervals
ceph osd pool set $POOL scrub_min_interval N
 ceph osd pool set $POOL scrub_max_interval N
 ceph osd pool set $POOL deep_scrub_interval N

If N > 0, this value is used for the pool instead of
the corresponding global parameter from the config
(osd_scrub_min_interval, osd_scrub_max_interval or
osd_deep_scrub_interval).

Fixes: #13077
Signed-off-by: Mykola Golub <mgolub@mirantis.com>
2015-09-21 09:08:16 +03:00
Mykola Golub
48db7b16d4 osd: new pool flags: noscrub, nodeep-scrub
This allows to disable periodic scrub on per pool basis.

Fixes: #13076
Signed-off-by: Mykola Golub <mgolub@mirantis.com>
2015-09-21 09:08:16 +03:00
Mykola Golub
10235e3ff3 osd: refactor setting write_fadvise_dontneed pool flag
Handle together with other flags.

Signed-off-by: Mykola Golub <mgolub@mirantis.com>
2015-09-21 09:08:16 +03:00
John Spray
865708120f doc: remove references to default data/metadata pools
These haven't existed since 0.84 -- the cephfs documentation
was updated at the time, but there were also references in the
rados documentation.

Signed-off-by: John Spray <john.spray@redhat.com>
2015-09-11 16:46:52 +01:00
Li Wang
c1bd02c978 Merge pull request #4792 from kylinstorage/wip-writeback-throttling-for-cache-tiering
Wip writeback throttling for cache tiering

This patch is to do write back throttling for cache tiering, which is similar to what the Linux kernel does for  page cache write back.  A paramter 'cache_target_dirty_high_ratio'  (default 0.6) is introduced as the high speed flushing threshold, while leave the 'cache_target_dirty_ratio' (default 0.4) to represent the low speed  threshold. The flush speed is controlled by limiting the parallelism of flushing. The maximum parallelism under low speed is half of the parallelism under high speed. If there is at least one PG such that the dirty ratio beyond the high threshold, full speed mode is entered; If there is no PG such that dirty ratio beyond the low threshold, idle mode is entered; In other cases, slow speed mode is entered.

Signed-off-by: Mingxin Liu <mingxinliu@ubuntukylin.com>
Reviewed-by: Li Wang <liwang@ubuntukylin.com>
Suggested-by: Nick Fisk <nick@fisk.me.uk>
Tested-by: Kefu Chai <kchai@redhat.com>
2015-06-23 15:15:47 +08:00
Abhishek Lekshmanan
81eee9bd8c doc: explain about pgp num
Explain the significance of pgp num & how it differs from pg num.

Fixes: #10035
Reported-by: Loic Dachary <loic@dachary.org>
Signed-off-by: Abhishek Lekshmanan <abhishek.lekshmanan@ril.com>
2015-06-16 22:59:22 +05:30
liumingxin
7aba9476e6 Doc: add write back throttling stuff in document and test scripts
Signed-off-by: Mingxin Liu <mingxinliu@ubuntukylin.com>
Reviewed-by: Li Wang <liwang@ubuntukylin.com>
Suggested-by: Nick Fisk <nick@fisk.me.uk>
2015-06-03 15:57:14 +08:00
Ilya Dryomov
eb9dbef2fe doc: fix crush-ruleset-name param description
Specified crush-ruleset-name is required to exist, implicit creation is
going to happen only if crush-ruleset-name wasn't specified on the
command line.  While at it, pool-name is very much a required param.

Signed-off-by: Ilya Dryomov <idryomov@gmail.com>
2015-05-27 15:06:37 +03:00
Andy Allan
aaabd57205 doc: fix typo
Signed-off-by: Andy Allan <github@gravitystorm.co.uk>
2015-03-09 14:41:18 +00:00
Mykola Golub
8ab3c41db7 osd: new pool safeguard flags: nodelete, nopgchange, nosizechange
* nodelete - pool can't be deleted
* nopgchange - pool's pg and pgp num can't be changed
* nosizechange - pool's size and min size can't be changed

This is intended to help some poor admin to avoid a very bad day.

Fixes: #9792 (but in a different way than it was proposed there)
Signed-off-by: Mykola Golub <mgolub@mirantis.com>
2015-01-19 21:50:28 +02:00
cholcombe973
a198deea5f Modifying the docs to add the Get pool commands to match the CLI.
Signed-off-by: Chris Holcombe <chris.holcombe@nebula.com>
2014-12-08 16:10:38 -08:00
Loic Dachary
c44bdb1dc9 erasure-code: document pool operations
A short introduction to the first time user of an erasure coded pool.
It includes a reminder of how it relates to cache tiering and links to
define new profiles with an example.

There was examples in the developer documentation but the operator
expects to find such a guide in the rados operations chapter.

http://tracker.ceph.com/issues/9970 Fixes: #9970

Signed-off-by: Loic Dachary <ldachary@redhat.com>
2014-11-10 14:47:56 +01:00
Loic Dachary
75f0fb2693 documentation: erasure code profile update
The plugins are made a sub-section of the erasure code profile
section. The k and m parameters are removed from erasure code profile
documentation. They were added for simplicity in the first version
because there was only one plugin. But they should really be in the
plugin documentation.

Signed-off-by: Loic Dachary <loic-201408@dachary.org>
2014-09-14 01:01:21 +02:00
John Wilkins
4ad1106eda doc: Clean up syntax.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-09-08 11:24:28 -07:00
Loic Dachary
d848a40040 Merge pull request #2138 from xiaoxichen/fix_crush_ruleset
mon/OSDMonitor : Use user provided ruleset for replicated pool

Reviewed-by: Loic Dachary <loic-201408@dachary.org>
2014-08-25 00:50:23 +02:00
Xiaoxi Chen
bf9726a294 mon/OSDMonitor : Use user provided ruleset for replicated pool
When creating a replicated pool, currently ceph ignore the ruleset
name provided by user but use a global default ruleset.

This patch fix this bug, so the rulset specified by
ceph osd pool create replicated
can be properly set.

Signed-off-by: Xiaoxi Chen <xiaoxi.chen@intel.com>
2014-08-07 16:43:12 +08:00
Abhishek Lekshmanan
1682e62eeb doc: typo s/loose/lose
Signed-off-by: Abhishek Lekshmanan <abhishek.lekshmanan@gmail.com>
2014-08-05 10:35:03 +05:30
George Ryall
66a5f3b9ea doc: Fixed Typo in pools documentation - replaced '-' with '_' in example set-quota comands. 2014-06-20 17:54:47 +01:00
Loic Dachary
8ff4edda73 documentation: update osd pool create erasure
The properties are replaced with erasure code profiles. Remove the
reference to properties and the documentation of each erasure-code
related property.

Signed-off-by: Loic Dachary <loic@dachary.org>
2014-06-03 13:47:32 +02:00
John Wilkins
9c32cb2685 doc: Added usage for pool quotas.
Fixes: #5653

Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-06-02 15:31:45 -07:00
Kevin Dalley
2da2699925 doc: update pools documentation
set=>get in "Get Pool Values"
grep for 'replicated size', not 'rep size'

Signed-off-by: Kevin Dalley <kevin@kelphead.org>
2014-05-29 14:56:06 -07:00
John Wilkins
6902e22408 doc: Added cache tiering settings to ceph osd pool set.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-04-22 17:31:57 -07:00
Loic Dachary
724ad02584 doc: update the operator create pool reference
Include erasure code information. A choice is made to display properties
that should be documented as part of the erasure code plugin
interface (erasure-code-k for instance). However, there only is one
plugin at the moment. Furthermore, erasure-code-k and erasure-code-m are
the two properties that the system administrator will want to tweak when
playing with erasure coded pools for the first time. It is probably
better to document them in a very visible place for this reason.

http://tracker.ceph.com/issues/7548 refs #7548

Signed-off-by: Loic Dachary <loic@dachary.org>
2014-03-04 12:23:52 +01:00
Sage Weil
f50371f081 Merge remote-tracking branch 'gh/next' 2013-11-30 13:44:27 -08:00
John Wilkins
fc5789da01 doc: Added commentary to configure pg defaults. Clarified size commentary.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-11-22 15:15:41 -08:00
Joao Eduardo Luis
7c6d43cf5b doc: rados: operations: pools: document 'osd pool set foo hashpspool'
Signed-off-by: Joao Eduardo Luis <joao.luis@inktank.com>
2013-11-22 02:49:27 +00:00
Sage Weil
8a65ae8e17 doc/rados/operations/pools: remove experimental note about pg splitting
Signed-off-by: Sage Weil <sage@inktank.com>
2013-08-30 15:41:02 -07:00
Alexandre Marangone
cd96dbe25b Fix important in documentation
Use of .. important: instead of .. important:: resulting in content
not being displayed.

Signed-off-by: Alexandre Marangone <alexandre.marangone@inktank.com>
2013-03-20 21:15:08 -07:00
Alexandre Marangone
330515780e Fix notes in documentation
Use of .. note: instead of .. note:: resulting in content not
being displayed

Signed-off-by: Alexandre Marangone <alexandre.marangone@inktank.com>
2013-03-20 21:10:55 -07:00