Commit Graph

173 Commits

Author SHA1 Message Date
Loic Dachary
9c825ec2c4 documentation: revise placement group number guide
When a cluster has few OSDs (less than 50) propose a preselection of
values: as long as the number of placement groups is not too small nor
too large, it won't make much of a difference anyway.

Users of small clusters tend to blindly apply the (OSD*100)/(pool size)
formula and worry about chosing a wrong value because they do not
understand the tradeoffs. The preselection will hopefully save them from
this uncertainty.

Add an explanation of how placement groups relate to OSDs, CRUSH and
pools to help understand the tradeoffs. Explain the
tradeoffs (durability, distribution and resource usages) with examples.

Signed-off-by: Loic Dachary <loic-201408@dachary.org>
Reviewed-by: Gerben Meijer <infernix@gmail.com>
Reviewed-by: Laurent Guerby <laurent@guerby.net>
2014-09-23 16:54:50 +02:00
Loic Dachary
639c9818fe documentation: explain ceph osd reweight vs crush weight
Using the wording from Gregory Farnum at
http://lists.ceph.com/pipermail/ceph-users-ceph.com/2014-June/040961.html

Signed-off-by: Loic Dachary <loic-201408@dachary.org>
2014-09-19 17:19:41 +02:00
John Wilkins
9a65b39022 doc: Fixed broken hyperlink.
Signed-off-by: John Wilkins <jowilki@redhat.com>
2014-09-16 11:28:19 -07:00
Sage Weil
47124f394c Merge pull request #2482 from dachary/wip-erasure-code-documentation
erasure code documentation

Reviewed-by: Sage Weil <sage@redhat.com>
2014-09-15 15:23:16 -07:00
Stephen Jahl
d32b4286de doc: Added bucket management commands to ops/crush-map
Describes the CLI for adding and removing buckets, in addition to the
'moving' instructions which were already present.

Signed-off-by: Stephen Jahl <stephenjahl@gmail.com>
2014-09-14 10:41:16 -04:00
Loic Dachary
d446a65654 documentation: jerasure plugin is sub section of erasure code profile
Signed-off-by: Loic Dachary <loic-201408@dachary.org>
2014-09-14 01:01:51 +02:00
Loic Dachary
4fb3e29279 documentation: isa plugin is sub section of erasure code profile
Signed-off-by: Loic Dachary <loic-201408@dachary.org>
2014-09-14 01:01:51 +02: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
Stephen Jahl
b8a1ec08a1 doc: fixes a formatting error on ops/crush-map
Signed-off-by: Stephen Jahl <stephenjahl@gmail.com>
2014-09-13 15:31:53 -04: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
John Wilkins
ed62ae58cd Merge pull request #2322 from ceph/wip-doc-authentication
doc: Refactored authentication docs.

Reviewed-by: John Wilkins <john.wilkins@inktank.com>
2014-09-02 11:40:22 -07:00
John Wilkins
c2443b9584 doc: Provided additional detail on daemon-specific caps syntax.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-09-02 11:38:16 -07:00
Loic Dachary
9fac072380 documentation: add the mark_unfound_lost delete option
Signed-off-by: Loic Dachary <loic-201408@dachary.org>
2014-09-01 00:42:19 +02:00
Loic Dachary
177202e4df erasure-code: lowercase LRC plugin name
So that all erasure code plugins are lowercase.

Signed-off-by: Loic Dachary <loic-201408@dachary.org>
2014-08-31 12:51:03 +02:00
Loic Dachary
734ae88ef0 erasure-code: LRC plugin documentation
Signed-off-by: Loic Dachary <loic-201408@dachary.org>
2014-08-29 19:39:57 +02:00
Loic Dachary
b0fd48158b erasure-code: locally repairable code plugin
Recursively apply erasure code techniques so that recovering from the
loss of some chunks only require a subset of the available chunks, most
of the time.

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

Signed-off-by: Loic Dachary <loic@dachary.org>
2014-08-29 19:38:57 +02:00
Wido den Hollander
e9a05b8a44 doc: Update docs about OSD benchmark syntax 2014-08-28 08:18:16 +02:00
Wido den Hollander
a087f03111 Revert "doc: Update docs about OSD benchmark syntax"
This reverts commit 36f15c3026.

Commit included submodule change which was not supposed to happen.
2014-08-28 08:16:03 +02:00
Wido den Hollander
36f15c3026 doc: Update docs about OSD benchmark syntax 2014-08-28 08:12:30 +02:00
John Wilkins
cef1299379 doc: Added links. Clarified namespace comments. Added limitations.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-08-25 11:04:36 -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
David Moreau Simard
2c2748519d Doc: Add config option to turn off crush update
Signed-off-by: David Moreau Simard <dmsimard@iweb.com>
2014-08-22 10:55:55 -04:00
John Wilkins
5e8eae725f doc: Removed cephx intro. Moved details to user management, config, and architecture.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-08-13 20:30:04 -07:00
John Wilkins
3aa3e96b10 doc: Removed cephx guide. Replaced by user management.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-08-13 20:29:08 -07:00
John Wilkins
aac6aa2a42 doc: Removed auth intro and auth docs and added user management to index.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-08-13 20:28:43 -07:00
John Wilkins
118ae72609 doc: Created a new User Management doc to replace authentication.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-08-13 20:27:00 -07:00
John Wilkins
71cb4d3c0d doc: Removed Debian reference from Upstart.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-08-07 15:30:43 -07: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
John Wilkins
1f9c7324a0 doc: Add additional hyperlink to Cache Tiering defaults.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-07-25 09:55:52 -07:00
John Wilkins
4fe07925e4 doc: Updated mon doc per feedback. Fixed hyperlinks.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-07-24 16:00:52 -07:00
Abhishek Lekshmanan
d0892831f9 doc: fix a few typos in rados docs
Signed-off-by: Abhishek Lekshmanan <abhishek.lekshmanan@gmail.com>
2014-07-09 11:15:08 +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
John Wilkins
94c8f70ea6 doc: Made mention of "incomplete" status.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-06-11 16:11:47 -07:00
Loic Dachary
5569d40bb4 documentation: add osd erasure-code-profile {set,rm,get,ls}
And a link from rados/operations.

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

Reported-by: Kenneth Waegeman <Kenneth.Waegeman@UGent.be>
Signed-off-by: Loic Dachary <loic@dachary.org>
2014-06-03 14:53:56 +02: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
0cc9ade824 doc: Updated monitor output and added usage calc explanations.
Fixes: #4948

Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-06-02 16:03:31 -07: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
John Wilkins
86754cc78c doc: Added more discussion of new CRUSH types.
Fixes: #7727

Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-06-02 14:40:27 -07:00
John Wilkins
cabb8f066d doc: Added a section for ceph df.
Fixes: #8281

Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-06-02 12:21:42 -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 Spray
2815e4d1af doc: Fix cache tier docs
The instructions for 'osd tier add' were plain
wrong, claiming that the cache mode could
be passed as a third argument.

Signed-off-by: John Spray <john.spray@inktank.com>
2014-05-28 12:21:37 +01:00
Loic Dachary
d14dfac2c2 Merge pull request #1856 from dachary/wip-pg-documentation
documentation: adapt PG formula for erasure coded pools

Reviewed-By: Christophe Courtaut <christophe.courtaut@gmail.com>
2014-05-28 12:19:29 +02:00
John Wilkins
d4e8119833 doc: Added primary affinity. Some minor rewrap edits.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-05-27 11:17:37 -07:00
Loic Dachary
ab0db34eaa documentation: adapt PG formula for erasure coded pools
Signed-off-by: Loic Dachary <loic@dachary.org>
2014-05-23 07:25:37 +02:00
John Wilkins
b082fd68b6 doc: Minor edit.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-05-14 00:13:41 -07:00
John Wilkins
ca833bd543 doc: Added clarifying text to CRUSH add command.
Fixes: #8322

Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-05-14 00:02:09 -07:00
John Wilkins
e68422b388 Merge pull request #1769 from ceph/wip-doc-cache-tier
doc: Support for cache tiering.
2014-05-05 15:26:27 -07:00
John Wilkins
d726251f3d doc: Fix hyperlink to CRUSH maps.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-04-22 17:36:46 -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