Commit Graph

379 Commits

Author SHA1 Message Date
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
John Wilkins
b7f6147c36 doc: Added background discussion to clock settings.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-06-10 17:42:21 -07:00
John Wilkins
e057f38ab8 Merge pull request #1926 from nereocystis/librados-write-full
doc: Use write_full for C++ example
2014-06-06 14:33:38 -07:00
Kevin Dalley
e31d3fe024 doc: Descrption => Description
Correct spelling error.

Signed-off-by: Kevin Dalley <kevin@kelphead.org>
2014-06-05 17:10:42 -07:00
Kevin Dalley
0ca43d834c doc: Use write_full for C++ example
Latest version of librados uses write_full when writing entire object.

Should the documentation mention that the method "write" used to serve
this function.

Signed-off-by: Kevin Dalley <kevin@kelphead.org>
2014-06-05 16:48:21 -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
Harpreet Dhillon
692f998914 doc: Fixes broken hyperlinks 2014-05-28 15:12:46 -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
Loic Dachary
ffbb69fd9e Merge pull request #1867 from dachary/wip-8324
documentation: update pid file description

Reviewed-by: Florent Flament <florent.flament@cloudwatt.com>
2014-05-28 12:15:57 +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
641732d59c documentation: update pid file description
The pid file behavior changed over time and the description is misleading.

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

Signed-off-by: Loic Dachary <loic@dachary.org>
2014-05-25 11:05:10 +02: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
Florent Flament
99b9682790 documentation: update osd pool default size from 2 to 3.
Fixes: #7725

Signed-off-by: Florent Flament <florent.flament@cloudwatt.com>
2014-05-22 14:14:56 +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
4ef7fa9f30 Merge pull request #1731 from dynamike67/patch-2
doc: Changed the java code example
2014-05-09 10:33:33 -07:00
John Wilkins
49033e8cd5 Merge pull request #1732 from dynamike67/master
doc: Added Java Example
2014-05-09 10:22:15 -07:00
Guang Yang
f9a91f2b62 Update doc to reflect the bahavior change for filestore_merge_threshold setting.
Signed-off-by: Guang Yang (yguang@yahoo-inc.com)
2014-05-07 09:41:36 +00: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
Alfredo Deza
82a3668e7c Merge pull request #1629 from ceph/wip-die-mkcephfs
remove mkcephfs (merge post-firefly?)

Reviewed-by:  Alfredo Deza <alfredo.deza@inktank.com>
2014-04-30 13:52:00 -04:00
Michael Riederer
27ec495a00 Added Java Example 2014-04-28 09:07:54 +02:00
dynamike67
8f64b5c100 Update librados-intro.rst 2014-04-27 15:42:26 +02:00
dynamike67
998b365c3c Changed the java code example 2014-04-27 14:15:58 +02: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
John Wilkins
0d964bc65d doc: Added new cache tiering doc to index/TOC.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-04-22 17:30:52 -07:00
John Wilkins
44e4e3d59b doc: Added new cache tiering doc to main docs.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-04-22 17:30:26 -07:00
Dmitry Smirnov
f22e2e9a02 spelling corrections 2014-04-17 12:43:30 +10:00
Sage Weil
084db49ed3 remove mkcephfs
Fixes: #7552
Signed-off-by: Sage Weil <sage@inktank.com>
2014-04-08 14:34:15 -07:00
John Wilkins
4b66868e6f doc: Removed --stable arg and replaced with --release arg for ceph-deploy.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-04-07 15:49:09 -07:00
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
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