Commit Graph

336 Commits

Author SHA1 Message Date
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
John Wilkins
29178d83ab doc: Cleanup of Add/Remove OSDs.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-11-20 19:29:31 -08:00
John Wilkins
634295d181 doc: Cleanup on Add/Remove monitor.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-11-20 19:28:27 -08:00
John Wilkins
72bba1f31d doc: Added fixes to osd reporting section.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-11-20 14:28:18 -08:00
Sage Weil
befe1e1eef Merge pull request #799 from ceph/wip-doc-install
Wip doc install

Reviewed-by: Neil Levine <neil.levine@inktank.com>
2013-11-06 07:57:23 -08:00
Jens-Christian Fischer
af1dee5a29 doc: clarify that mons must have qurorum during deploy
If multiple mons are specified in 'ceph-deploy new', but less than
those necessary for quorum are started with 'ceph-deploy mon create',
later steps (like 'ceph-deploy gatherkeys') will fail.
2013-10-23 14:40:32 +02:00
John Wilkins
8a36503879 doc: Moved CPU Profiler docs to dev.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-10-22 13:22:17 -07:00
John Wilkins
45d184602b doc: Removed references to Chef.
fixes: #6464

Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-10-18 11:12:43 -07:00
John Wilkins
2cc5805a14 doc: Removed underscore for consistency.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-10-14 10:31:51 -07:00
Loic Dachary
bf82ba90bc doc: disable cephx requires auth_supported = none
auth cluster required = none
    auth service required = none
    auth client required = none

is not enough to disable cephx if there is a

    auth_supported = cephx

line in the [global] section. It will produce the following error

    # ceph --id myself auth list
    2013-10-13 11:05:00.368638 7f812aea3700  0 librados: client.myself authentication error (1) Operation not permitted
    Error connecting to cluster: PermissionError

Changing the line to

    auth_supported = none

fixes the problem.

Signed-off-by: Loic Dachary <loic@dachary.org>
2013-10-13 11:18:27 +02:00
John Wilkins
f13cc684c6 doc: Fixed hyperlinks. Cleanup of old references to Chef.
fixes: #6493

Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-10-11 14:04:36 -07:00
John Wilkins
cb9ebd6f36 doc: Minor correction.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-10-10 14:31:37 -07:00
John Wilkins
fa909ad6ed doc: Update from wip-doc-quickstart branch.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-10-10 11:47:56 -07:00
John Wilkins
4fe01b1f1d doc: changed journal aio default to true.
fixes: #6389

Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-09-27 13:59:13 -07:00
John Wilkins
ac0faaa359 doc: Removed service ops language and added reference to operations.
fixes: #6374

Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-09-24 15:26:35 -07:00
John Wilkins
a39de7b1f0 doc: Made sysvinit and service sections parallel to upstart for clarity.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-09-17 14:03:34 -07:00
John Wilkins
e55d59f826 doc: Updated usage.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-09-16 18:57:46 -07:00
John Wilkins
0be2c87a54 doc: Removed --fs-type option and text.
fixes: #6326

Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-09-16 18:40:07 -07:00
Noah Watkins
b86c068669 hadoop: remove hadoop shim
The in-tree Hadoop shim was a combination of libcephfs wrapper, and the
bits to support Hadoop. This has been replaced by src/java that
implements generic libcephfs wrappers, and externally, the hadoop shim
(see docs).

Signed-off-by: Noah Watkins <noahwatkins@gmail.com>
2013-09-13 13:39:48 -07:00
John Wilkins
494aff6b52 doc: Syntax fixes to suppress gitbuilder warnings.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-09-09 15:27:57 -07:00
John Wilkins
95c0c6c915 doc: Syntax fixes to suppress gitbuilder warnings.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-09-09 15:27:36 -07: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
John Wilkins
3266862491 doc: Updated to accurately reflect that upstart applies to a single node.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-08-27 10:25:50 -07:00
John Wilkins
576dce03f0 doc: Clarified quorum requirements.
fixes: #5412

Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-08-21 11:01:48 -07:00
Sage Weil
68c1c70e1f Merge remote-tracking branch 'gh/next' 2013-08-19 12:41:54 -07:00
Danny Al-Gaaf
090e4c4a31 filestore-config-ref.rst: mark some filestore keys as deprecated
Marked the following keys as deprecated since v0.65:
- filestore flusher
- filestore flusher max fds
- filestore sync flush

Signed-off-by: Danny Al-Gaaf <danny.al-gaaf@bisect.de>
2013-08-19 20:56:48 +02:00
Danny Al-Gaaf
a846294533 auth-config-ref.rst: fix signature keys
Fix names of cephx signature keys.

Signed-off-by: Danny Al-Gaaf <danny.al-gaaf@bisect.de>
2013-08-19 10:33:37 +02:00
Sage Weil
ae7436ffb5 Merge pull request #479 from devoid/fix-5797
Document unstable nature of CephFS
2013-08-17 10:09:01 -07:00
John Wilkins
50cc2efccf doc: Removed old mkcephfs references.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-08-16 17:31:43 -07:00
John Wilkins
16f4bd51f0 doc: Updated APT script for dumpling.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-08-16 17:27:16 -07:00
John Wilkins
e97100db50 doc: Removed mkcephfs references. Did a bit of clean-up work.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-08-16 17:26:25 -07:00
Scott Devoid
9f1ad4db54 Document unstable nature of CephFS
- Add note to docs indicating that CephFS is not recommended for
  production datasets.
- Add note to docs indicating that running CephFS with multiple MDS
  servers is not currently recommended.

This fixes issue #5797 http://tracker.ceph.com/issues/5797

Signed-off-by: Scott Devoid <devoid@anl.gov>
2013-08-15 14:01:32 -05:00
John Wilkins
2e9c25f5ae doc: fixing reported bug in CRUSH map example.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-08-05 14:48:38 -07:00
Alfredo Deza
1cd6e2e3f3 fix invalid cluster naming in example
Signed-off-by: Alfredo Deza <alfredo@deza.pe>
2013-08-05 10:16:54 -07:00
Sage Weil
4bf4d92a8b doc: radosgw needs 'mon = allow rw' to create its own pools
Fixes: #5674
Signed-off-by: Sage Weil <sage@inktank.com>
Reviewed-by: Yehuda Sadeh <yehuda@inktank.com>
2013-07-19 10:04:40 -07:00
Dan Mick
e4d063b082 ceph-rest-api manpage
Signed-off-by: Dan Mick <dan.mick@inktank.com>
2013-07-10 20:58:51 -07:00
Gary Lowell
5511daf345 doc: public network statement needed on new monitors.
When using ceph-deploy to create a new monitor on a host that is not
in the initial set of hosts defined by the ceph-deploy new command,
a "public network" statement needs to be added to the ceph.conf file.
Fixes #5195.

Signed-off-by: Gary Lowell  <gary.lowell@inktank.com>
2013-06-26 06:27:17 -07:00
John Wilkins
97f1322cdb doc: Updated deployment preflight.
fixes: #5266

Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-06-18 14:26:30 -07:00
John Wilkins
f851c5d47f doc: Update for usage and index tags.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-06-14 16:54:36 -07:00
John Wilkins
4a79fabd41 doc: Update for usage. Index tags.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-06-14 16:54:14 -07:00
John Wilkins
20e68b748b doc: Updated for glossary usage. Index tags.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-06-14 16:53:56 -07:00
John Wilkins
44bf35a2cb doc: Updated index tags.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-06-14 16:53:20 -07:00
John Wilkins
a529882a5b doc: Updated index tags.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-06-14 16:52:46 -07:00
John Wilkins
2be167010e doc: Minor updates.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-06-14 16:06:59 -07:00
John Wilkins
b3a143d977 doc: Minor updates for usage.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-06-14 16:06:06 -07:00
John Wilkins
3f3ad61fae doc: Fixed :term" syntax.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-06-11 12:10:52 -07:00
John Wilkins
dea8c2d188 doc: Updated for glossary terms and added indexing.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-06-07 09:51:05 -07:00
John Wilkins
8e24328d88 doc: Added indexing and did a bit of cleanup.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-06-07 09:50:03 -07:00
John Wilkins
5c30844762 doc: Updated with glossary terms.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-06-06 17:35:02 -07:00
John Wilkins
8e13b38c27 doc: Updated with glossary terms.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-06-06 17:29:02 -07:00
John Wilkins
7116de3592 doc: Correction and index tags.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-06-06 17:27:34 -07:00
John Wilkins
ae5aeb1c06 doc: Updates for glossary terms.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-06-06 17:26:51 -07:00