Commit Graph

287 Commits

Author SHA1 Message Date
João Eduardo Luís
362d370dd8 Merge pull request #1125 from ceph/wip-mon-docs
wip-mon-docs: Better explain required number of monitors & how to troubleshoot a monitor

Signed-off-by: Joao Eduardo Luis <joao.luis@inktank.com>
Reviewed-by: Loic Dachary <loic@dachary.org>
2014-03-18 22:26:34 +00:00
Sage Weil
5ec493600e Merge remote-tracking branch 'gh/firefly' 2014-03-13 15:15:49 -07:00
Florian Haas
27f06346e2 doc: fix formatting on PG recommendation
Previous commit (047287afbe) broke
formatting on the formula, and also made mixed formula and text oddly,
which on second thought didn't look too good.

Add the note about the power of two to the following paragraph
instead, in prose.

Signed-off-by: Florian Haas <florian@hastexo.com>
2014-03-13 11:35:20 +01:00
Florian Haas
047287afbe doc: Add "nearest power of two" to PG rule-of-thumb
Following an IRC discussion, it emerged that it would be helpful
to explain the merit of choosing a number of PGs per pool that is
a power of two, to keep PGs at roughly equal sizes in case of
PG splits.

See http://irclogs.ceph.widodh.nl/index.php?date=2014-03-12 for the
original discussion.

Signed-off-by: Florian Haas <florian@hastexo.com>
2014-03-12 19:51:27 +01:00
Sage Weil
c55da14a3d Merge pull request #1362 from dachary/wip-7548
doc: erasure coded pool developer and operations documentation

Reviewed-by: Sage Weil <sage@inktank.com>
2014-03-11 21:54:02 -07:00
Danny Al-Gaaf
72ee3389af doc: s/osd/OSD/ if not part of a command
First attempt to unify usage of OSD over rst files.

Signed-off-by: Danny Al-Gaaf <danny.al-gaaf@bisect.de>
2014-03-09 00:01:40 +01:00
Danny Al-Gaaf
a4cbb192ab rados/operations/control.rst: fix typo
Signed-off-by: Danny Al-Gaaf <danny.al-gaaf@bisect.de>
2014-03-08 11:13:52 +01: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
Joao Eduardo Luis
3ee71a5cb1 doc: troubleshooting-mons.rst: better document how to troubleshoot mons
Signed-off-by: Joao Eduardo Luis <joao.luis@inktank.com>
2014-02-24 17:22:01 +00:00
Loic Dachary
f6afe8cc6e Merge pull request #1199 from ceph/wip-doc-librados-intro
Wip doc librados intro

Reviewed-by: Dan Mick <dan.mick@inktank.com>
Reviewed-by: Loic Dachary <loic@dachary.org>
2014-02-12 17:25:42 +01:00
Loic Dachary
8533b6ac2e Merge pull request #1185 from ceph/wip-crush
crush: "vary_r" tunable

Reviewed-by: Loic Dachary <loic@dachary.org>
2014-02-11 23:42:53 +01:00
John Wilkins
2682b64c51 doc: Incorporated feed back from Loic and Dan.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-02-11 13:28:33 -08:00
Sage Weil
e3309bce03 doc/rados/operations/crush: describe new vary_r tunable
Signed-off-by: Sage Weil <sage@inktank.com>
2014-02-11 11:12:56 -08:00
Loic Dachary
cf2d71cef5 Merge pull request #1127 from dmsimard/log_links
Doc: Fix 404 broken links to logging and debug configuration

Reviewed-by: Josh Durgin <josh.durgin@inktank.com>
Reviewed-by: Loic Dachary <loic@dachary.org>
2014-02-09 00:33:42 +01:00
John Wilkins
8cb3dad548 doc: Added Python doc.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-02-07 15:49:00 -08:00
John Wilkins
22afd6ca1f doc: Added inline literal tag.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-02-07 15:48:45 -08:00
John Wilkins
aaa2799f83 doc: Adds Python to index and sets maxdepth to 2.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-02-07 15:47:40 -08:00
Dan Mick
0aa25b178d Some suggested changes, both errors and rewordings
Python and C code examples tweaked a bit

Signed-off-by: Dan Mick <dan.mick@inktank.com>
2014-02-06 16:54:47 -08:00
Loic Dachary
33b8ad810e common: add osd_pool_erasure_code_stripe_width
and document it.

Signed-off-by: Loic Dachary <loic@dachary.org>
2014-02-05 20:40:14 +01:00
David Moreau Simard
b90570f3dc Fix 404 broken links to logging and debug configuration
Signed-off-by: David Moreau Simard <dmsimard@iweb.com>
2014-01-24 10:41:46 -05:00
Josh Durgin
28af392bc3 Merge pull request #1116 from jcsp/doc_toofull
Reviewed-by: Josh Durgin <josh.durgin@inktank.com>
2014-01-23 22:43:43 -08:00
Joao Eduardo Luis
9792500af4 doc: add-or-rm-mons.rst: better explanation on number of monitors
Signed-off-by: Joao Eduardo Luis <joao.luis@inktank.com>
2014-01-22 12:26:41 +00:00
John Wilkins
ed2decb149 doc: Fixed end string from '' to `` to stop warnings. Enforced 80 char line.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-01-21 11:51:15 -08:00
John Spray
6bee1885a9 Docs: Add backfill_toofull to list of PG states
Signed-off-by: John Spray <john.spray@inktank.com>
2014-01-21 11:50:00 +00:00
John Wilkins
ad203d5988 doc: Fixed ruleset typo.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-01-17 13:33:48 -08:00
John Wilkins
3194d66d23 doc: Fixed keyring command and updated for current conventions.
fixes: #6692

Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-01-16 11:36:39 -08:00
Sage Weil
2b36761b81 mon: favor 'mds set max_mds' over 'mds set_max_mds'
Signed-off-by: Sage Weil <sage@inktank.com>
2014-01-15 19:02:23 -08:00
John Wilkins
9615645372 doc: Added python example of handle, and closing session examples.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-01-13 12:40:47 -08:00
John Wilkins
54e588c84b doc: Modified doc examples to use rados_create2.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-01-13 11:20:24 -08:00
John Wilkins
7d5674cf78 doc: Added librados introduction doc. Still wip.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-01-07 17:11:29 -08:00
John Wilkins
33e78a4ad9 doc: Updated terminology. Added librados intro to index.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-01-07 17:11:01 -08:00
John Wilkins
d110c913c1 doc: Removed dash from --dmcrypt option.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-01-03 14:37:23 -08:00
Loic Dachary
dd81858ca6 mon: implement --osd-pool-default-crush-replicated-ruleset
--osd-pool-default-crush-replicated-ruleset replaces
--osd-pool-default-crush-rule

If --osd-pool-default-crush-rule is set it takes precedence over
--osd-pool-default-crush-replicated-ruleset and a deprecation warning is
displayed.

The CrushWrapper::get_osd_pool_default_crush_replicated_ruleset helper is
used to implement this behaviour.

Signed-off-by: Loic Dachary <loic@dachary.org>
2013-12-27 00:13:47 +01:00
Loic Dachary
2a7fcc35b8 osd: use CrushWrapper::add_simple_ruleset
Replace the manually crafted ruleset in OSDMap::build_simple_crush_map*
with calls to add_simple_ruleset. The generated ruleset do not have the
same behavior but that presumably do not cause any backward
compatibility problem because they are only created when a new cluster
is being initialized.

The prototypes of OSDMap::build_simple* are modified to allow for a
return code and display of a human readable error message.

The --osd-min-rep and --osd-max-rep configuration options are removed :
they were only used in the code that was removed.

Signed-off-by: Loic Dachary <loic@dachary.org>
2013-12-27 00:13:47 +01:00
Sage Weil
d0f14dfa64 mon: warn if crush has non-optimal tunables
Allow warning to be disabled via ceph.conf.  Link to the docs from the
warning detail.  Add a section to the docs specifically about what to do
about the warning.

Signed-off-by: Sage Weil <sage@inktank.com>
2013-12-18 08:35:24 -08:00
scuttlemonkey
85a024a6bd Merge pull request #865 from ceph/wip-doc-build-cluster
Wip doc build cluster
2013-12-10 10:14:59 -08:00
Sage Weil
e829859291 doc/rados/operations/crush: fix more
Signed-off-by: Sage Weil <sage@inktank.com>
2013-12-03 22:46:37 -08:00
Sage Weil
7709a10f52 doc/rados/operations/crush: fix rst
Signed-off-by: Sage Weil <sage@inktank.com>
2013-12-03 22:18:50 -08:00
Sage Weil
3f1352ff38 doc/rados/operations/crush-map: describe crush locations, hook
Signed-off-by: Sage Weil <sage@inktank.com>
2013-12-02 21:48:54 -08:00
John Wilkins
a5eda4fcc3 doc: Updated scrub defaults and added note about deep scrubbing.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-12-02 15:26:19 -08:00
Sage Weil
f50371f081 Merge remote-tracking branch 'gh/next' 2013-11-30 13:44:27 -08:00
Loic Dachary
371dc71e12 doc: fix formatting typo in mon configuration
Signed-off-by: Loic Dachary <loic@dachary.org>
Reviewed-by: Josh Durgin <josh.durgin@inktank.com>
2013-11-26 09:44:47 -08:00
Loic Dachary
00ee9a5289 doc: improve ceph-mon usage, fix ceph tell examples
The ceph-mon command usage is updated to document all of the ceph-mon
specific options.

The ceph tell usage examples for log and debug are using a deprecated syntax.

Signed-off-by: Loic Dachary <loic@dachary.org>
Reviewed-by: Josh Durgin <josh.durgin@inktank.com>
2013-11-26 09:44:45 -08:00
John Wilkins
740d406e37 doc: Clarified description on scrub load threshold.
fixes: #6735

Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-11-22 15:49:16 -08:00
John Wilkins
e8ccb91fd3 Merge branch 'master' of https://github.com/ceph/ceph 2013-11-22 15:16:18 -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
John Wilkins
dceaef439d doc: PG splitting added to docs.
fixes: #6727

Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-11-22 15:14:46 -08:00
John Wilkins
d39676b164 doc: Took out "future" reference to namespaces.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-11-22 15:13:49 -08:00
John Wilkins
9a55d89250 doc: Clarification of terms.
fixes: #6749

Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-11-22 12:59:40 -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