Commit Graph

373 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
Sage Weil
77b9f4a562 Merge pull request #2529 from dachary/wip-doc-troubleshooting
documentation: fix bugous osd stop/start example
2014-09-19 14:40:47 -07: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
Loic Dachary
be97b7d5b8 documentation: fix bugous osd stop/start example
Signed-off-by: Loic Dachary <loic-201408@dachary.org>
2014-09-19 10:29:20 +02:00
John Wilkins
13b82ded62 Merge pull request #2473 from ceph/wip-doc-preflight
doc: Revised the Preflight Doc

Reviewed-by: John Wilkins <jowilkin@redhat.com>
2014-09-16 11:47:12 -07: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
Dan van der Ster
868b6b99fd doc: osd_backfill_scan_(min|max) are object counts
osd_backfill_scan_min and osd_backfill_scan_max set the number of
items grabbed during a single backfill scan, not an interval in
seconds. Correct the doc.

Signed-off-by: Dan van der Ster <daniel.vanderster@cern.ch>
2014-09-15 11:27:24 +02: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
1c8485e41e doc: Deleted redundant text string.
Signed-off-by: John Wilkins <jowilki@redhat.com>
2014-09-12 09:14:51 -07: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
John Wilkins
8569b93cba doc: Updated Keyring settings from comments and ceph-deploy defaults.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-09-02 11:37:33 -07:00
Loic Dachary
b6a97d83da documentation: disk thread ioprio options
Signed-off-by: Loic Dachary <loic-201408@dachary.org>
2014-09-02 19:08:00 +02: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
John Wilkins
7948e13b9d doc: Added sysctl max thread count discussion.
Fixes: #6142

Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-08-28 17:25:07 -07: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
John Wilkins
d817a6a336 doc: Minor changes.
Removed arch-related comments.
Added links to relevant docs.
Moved limitations to user management.

Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-08-25 11:03:42 -07:00
Loic Dachary
73733ddb48 documentation: update recovery config options defaults
So they match the values from config_opts.h

Signed-off-by: Loic Dachary <loic-201408@dachary.org>
2014-08-25 15:52:29 +02: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
4c651b7d0a doc: Restructured auth configuration reference.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-08-13 20:28:10 -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
4047660ce4 doc: Update doc from user feedback.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-07-25 09:55:28 -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
Stephen Jahl
586d3ee32c doc: Fixes a broken link on the rados deploy osd page.
Signed-off-by: Stephen Jahl <stephenjahl@gmail.com>
2014-07-12 09:04:22 -04: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
2e3302cc3e doc: Updated the example configuration.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-06-12 11:35:27 -07:00
John Wilkins
5a31df214f doc: Updated doc for more recent versions.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-06-12 11:34:41 -07: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
John Wilkins
d37ef6ab7f doc: Added additional background to address additional states.
Covers 1-node cluster issues, fewer OSDs than replicas, and
active + clean + inconsistent states in greater detail.

Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-06-10 17:44:02 -07:00