Commit Graph

132 Commits

Author SHA1 Message Date
Dimitri Papadopoulos
7677651618
doc,man: typos found by codespell
Signed-off-by: Dimitri Papadopoulos <3234522+DimitriPapadopoulos@users.noreply.github.com>
2021-12-15 12:04:36 +01:00
Melissa
e6e0344981
doc/cephadm: deployment scenarios single host and isolated environment
This PR adds a deployment scenarios section to the cephadm docs to document the single-host-defaults flag, and explain how to deploy in an isolated environment.

Signed-off-by: Melissa Li <melissali@redhat.com>
2021-11-24 15:02:37 +01:00
Jos Collin
722f95e7ff
doc: update dev list and kernel client
Signed-off-by: Jos Collin <jcollin@redhat.com>
2021-11-09 16:38:12 +05:30
Sebastian Wagner
d9ec8eb7a8
doc/cephadm: Add lots of links to other chapters
Signed-off-by: Sebastian Wagner <sewagner@redhat.com>
2021-09-11 20:04:14 +02:00
Patrick Donnelly
4b1e101571
Merge PR #42295 into master
* refs/pull/42295/head:
	doc/cephfs: recover file system after recovering

Reviewed-by: Patrick Donnelly <pdonnell@redhat.com>
2021-07-21 13:13:43 -07:00
Ramana Raja
ffe5cfb687 doc/cephfs: recover file system after recovering
... monitor stores using OSDs. The steps are valid only to recover
single active MDS file systems.

Partially-fixes: https://tracker.ceph.com/issues/51341
Signed-off-by: Ramana Raja <rraja@redhat.com>
2021-07-16 17:20:35 -04:00
Sage Weil
01c006c2de Merge PR #42041 into master
* refs/pull/42041/head:
	mgr/restful: ignore min/max_size
	test/crush: drop min/max_size refs
	qa/workunits/mon/pool_ops: remove test for min/max_size check
	qa: scrub a few remaining mentions of ruleset
	qa/standalone/mon/osd-*: fix tests
	PendingReleaseNotes: note min/max_size removal
	mgr/dashboard: remove max/min_size and ruleset
	mon/OSDMonitor: fix calls to CrushTester
	crush: eliminate min_size and max_size
	test/cli/crushtool: reunumber rulesets in test maps
	crushtool: require min/max or num-rep for --test
	crush: remove last traces of 'ruleset'
	test/cli/crushtool: use 'id' instead of 'ruleset' in crush inputs
	crushtool: take --min-rep and --max-rep explicitly
	crush/CrushTester: drop --ruleset
	doc: scrub 'ruleset' from docs
	src/erasure-code: rule, not ruleset
	mon/OSDMonitor: remove check_crush_rule() callers
	mon/OSDMonitor: rule, not ruleset
	crushtool: remove check for overlapped ruels
	crush/CrushWrapper: get_osd_pool_default_crush_replicated_ruleset -> rule
	crush: remove find_rule()
	mon/OSDMonitor: use pool's crush rule directly
	osd/OSDMap: drop checks for ruleset == ruleid
	osd/OSDMap: use pool's crush rule_id directly
	mon/PGMap: use pool's crush_rule directly
	mon/OSDMonitor: remove crush ruleset->rule rewrite

Reviewed-by: Ernesto Puerta <epuertat@redhat.com>
Reviewed-by: Avan Thakkar <athakkar@redhat.com>
2021-07-14 14:38:59 -04:00
Kefu Chai
fd8d6b1a9f doc/rados/troubleshooting/log-and-debug: use ini to highlight code block
Signed-off-by: Kefu Chai <kchai@redhat.com>
2021-07-05 23:57:32 +08:00
Kefu Chai
42fd0ba6b8 doc/rados/troubleshooting/log-and-debug: document option using :confval:
* simpler this way.
* and drop non-existent options.

Signed-off-by: Kefu Chai <kchai@redhat.com>
2021-07-05 23:57:32 +08:00
Sage Weil
f95eb04411 crush: eliminate min_size and max_size
We don't use min/max_size for anything any more.  Switch to encoding it
universally as 1 and 100, and ignoring when we decode.  We keep it around
for backward compat when (re)encoding without the SERVER_QUINCY feature.

Drop the crush_rule_mask struct since the only variable piece now is the
type.

Signed-off-by: Sage Weil <sage@newdream.net>
2021-06-28 18:34:31 -04:00
Sage Weil
8976fcf476 doc: scrub 'ruleset' from docs
Signed-off-by: Sage Weil <sage@newdream.net>
2021-06-28 18:34:31 -04:00
Kefu Chai
5d431ce54d doc/rados/troubleshooting: highlight bash script with bash lexer
for better reading experience.

Signed-off-by: Kefu Chai <kchai@redhat.com>
2021-06-10 20:29:50 +08:00
mflehmig
00225dc531 doc/rados: Fix typo
Signed-off-by: Martin Flehmig <martin.flehmig@tu-dresden.de>
2021-05-17 14:42:12 +08:00
Satoru Takeuchi
7f9dad3eb5 doc: fix the procedure of recovery mon quorum using osd
`ceph-monstore-tool` expects mons names are sorted by ip adrress. However,
this is not always true after the following PR.

https://github.com/ceph/ceph/pull/22193

We can bypass this problem by using `--mon-ids` option.

Signed-off-by: Satoru Takeuchi <satoru.takeuchi@gmail.com>
2021-02-04 06:09:06 +00:00
Kefu Chai
09f1e7ffff
Merge pull request #38241 from Rethan/update_url_from_master_to_lastest
doc/dev: use http://docs.ceph.com/en/latest/ instead of /docs/master/ for docs

Reviewed-by: Laura Paduano <lpaduano@suse.com>
Reviewed-by: Kefu Chai <kchai@redhat.com>
Reviewed-by: Willem Jan Withagen <wjw@digiware.nl>
2020-11-27 14:00:12 +08:00
haoyixing
0e7e036aa7 doc/dev: use http://docs.ceph.com/en/latest/ instead of /docs/master/ for docs
Several links under http://docs.ceph.com/docs/master/ were unable to access.
Change them to http://docs.ceph.com/en/lastest so we can access them directly.

Signed-off-by: haoyixing <haoyixing@kuaishou.com>
2020-11-24 12:49:47 +08:00
Anthony D'Atri
8a47edfced
Merge branch 'master' into anthonyeleven/docs-14730 2020-11-23 09:31:29 -08:00
Anthony D'Atri
7fde53bbb1 doc/rados/operations: POOL_NEAR_FULL on OSD_NEAR_FULL
Fixes: https://tracker.ceph.com/issues/40579
Signed-off-by: Anthony D'Atri <anthony.datri@gmail.com>
2020-11-22 00:02:54 -08:00
Anthony D'Atri
84757fc202 doc/rados/troubleshooting: description of upgrade procedure - stopping/starting OSDs
Fixes: https://tracker.ceph.com/issues/14730
Signed-off-by: Anthony D'Atri <anthony.datri@gmail.com>
2020-11-19 23:39:42 -08:00
Anthony D'Atri
8a4c4cb393 doc/rados/troubleshooting: clarity and modernization
Signed-off-by: Anthony D'Atri <anthony.datri@gmail.com>
2020-10-12 10:22:16 -07:00
Ponnuvel Palaniyappan
d99d520493 doc: Fixed a number of typos in documentation
Signed-off-by: Ponnuvel Palaniyappan <pponnuvel@gmail.com>
2020-09-18 18:17:15 +01:00
David Zafman
bb5058074d doc: Add doc and PendingRealeaseNotes
Add help about new list_unfound fields in troubleshooting-pg.rst
Add info in PendingReleaseNotes

Signed-off-by: David Zafman <dzafman@redhat.com>
2020-09-16 16:40:10 -07:00
Robert Sander
1b42759e19 doc: remove references to ceph-deploy
The documentation still has many traces of ceph-deploy. This tool has
been deprecated with the Octopus release. This commit tries to remove
most of ceph-deploy occurences.

Signed-off-by: Robert Sander <r.sander@heinlein-support.de>
2020-09-02 21:14:36 +02:00
Kefu Chai
fe07df9f19 doc: always refernce terms in case sensitive mode
to silence warning from sphinx like:

ceph/doc/install/ceph-deploy/quick-start-preflight.rst:5: WARNING: term node not found in case sensitive match.made a reference to Node instead.

Signed-off-by: Kefu Chai <kchai@redhat.com>
2020-09-01 09:53:18 +08:00
Lenz Grimmer
03bb271e36 doc: Updated mailing list addresses
The "Community" chapter of the RADOS troubleshooting section
was still pointing to the old mailing list addresses.

Updated to point to the new ceph.io addresses.

Signed-off-by: Lenz Grimmer <lgrimmer@suse.com>
2020-06-11 17:32:45 +02:00
Alfredo Sola
2fce0ff513 doc/rados: fix a typo in troubleshooting-mon.rst
Signed-off-by: Alfredo Sola <5412907+alfredosola@users.noreply.github.com>
2020-05-03 11:19:57 +08:00
John Law
c2c069f2b4 doc: Fix inconsistency in logging settings
This patch fixes inconsistency in logging settings with options, namely `log_flush_on_exit` and `log_to_stderr`. This patch also adds `log_to_file` to the section.

Signed-off-by: John Law <johnlaw.po@gmail.com>
2020-03-29 03:14:45 +02:00
Nathan Cutler
58ea553b2d doc: adjust for mon_status changes in octopus
In octopus, we no longer have "ceph mon_status", but we do have
"ceph tell mon.<id> mon_status", so reflect this in the docs.

Signed-off-by: Nathan Cutler <ncutler@suse.com>
2020-03-03 22:47:07 +01:00
Kefu Chai
75f4765f2f doc: update mondb recovery script
to note that we also need to add mgr's key to monitor's keyring

Signed-off-by: Kefu Chai <kchai@redhat.com>
2020-02-10 17:38:28 +08:00
Kefu Chai
4b3df5a850 ceph-monstore-tool: rename mon-ids in initial monmap
when ceph-mon starts, it checks to see if it's listed in the monmap, if
not it complains
```
no public_addr or public_network specified, and mon.a not present in
monmap or ceph.conf.
```
then bails out. normally, the monitor will try to rename its name in
monmap when performing "mkfs", but in our case, we are merely using the
"mkfs" monmap for passing the monmap built by ceph-monstore-tools, and
we don't actually go through the "mkfs" process. so, ceph-mon won't
rename when booting up.

in this change, user is allowed to specify the mon-ids in command line
when rebuilding mondb, the default mon-ids would be a,b,c,... if not
specified.

Signed-off-by: Kefu Chai <kchai@redhat.com>
2020-02-10 17:38:28 +08:00
Neha
75b4707ca9 doc/rados: update osd_min_pg_log_entries
update docs to match 0db140c15c

Signed-off-by: Neha Ojha <nojha@redhat.com>
2020-01-22 19:15:11 +00:00
Zac Dover
9c1216cd69 doc: s/achieve/achieves (Fixed a verb disagreement)
This bug changes a clause of the form "When x remains in y status
and never achieve a z status" to a clause of the form "When x remains
in y status and never achieves a  z status".

The change is one of "achieve" to "achieves".

Signed-off-by: Zac Dover <zac.dover@gmail.com>
2019-12-06 02:16:01 +10:00
Sage Weil
7b988e9fe1 doc: remove all pg_num arguments to 'osd pool create'
Also, update the dicussion about pg_num and pool creation, with a reference
to the autoscaler.

Signed-off-by: Sage Weil <sage@redhat.com>
2019-09-22 16:58:33 -05:00
Patrick Donnelly
e7a7cf429e
doc: filesystem to file system
"Filesystem" is not a word (although fairly common in use).

Signed-off-by: Patrick Donnelly <pdonnell@redhat.com>
2019-09-10 08:43:28 -07:00
Hannes von Haugwitz
65c6425489 doc: update mondb recovery script
- be specific about stopped OSDs
- add missing '--no-mon-config' option
- fix indent of here script delimiting identifier
- use $host variable in for loop

Signed-off-by: Hannes von Haugwitz <hannes@vonhaugwitz.com>
2019-06-12 17:16:25 +02:00
Abhishek Lekshmanan
b21c96ec69 doc: rgw: fix the default value of usage log setting
Fixes: http://tracker.ceph.com/issues/37856
Signed-off-by: Abhishek Lekshmanan <abhishek@suse.com>
2019-01-10 11:13:33 +01:00
James McClune
ca05e45696 doc: broken link on troubleshooting-mon page
Fixes: https://tracker.ceph.com/issues/37451

This fix involves adding :ref: labels to the add-or-rm-mons.rst
page. I also added :ref: labels for other headings within
add-or-rm-mons.rst (for future reference).

Signed-off-by: James McClune <jmcclune@mcclunetechnologies.net>
2018-12-07 23:15:43 -05:00
Kefu Chai
0966f43d98
Merge pull request #24896 from tchaikov/wip-librados-cleanup
librados,rpm,deb: various fixes to address librados3 transition and cleanups in librados

Reviewed-by: Josh Durgin <jdurgin@redhat.com>
2018-11-08 10:19:57 -08:00
Kefu Chai
0e5bdd9d56 librados: remove rados_tmap_*
we have switched from tmap to omap long ago.

but keep the server side implementation around, in case ancient
client is still using these tmap APIs.

also, tmap_update() is kept, because librbd is using it for v1 image
backward compatibility.

Signed-off-by: Kefu Chai <kchai@redhat.com>
2018-11-07 14:05:25 -08:00
songweibin
1965088130 doc/rados: correct osd path in troubleshooting-mon.rst
Signed-off-by: songweibin <song.weibin@zte.com.cn>
2018-11-07 15:05:41 +08:00
Sage Weil
b29e4470ac Merge PR #24249 into master
* refs/pull/24249/head:
	doc/rados/troubleshooting-mon: update mondb recovery script

Reviewed-by: Kefu Chai <kchai@redhat.com>
2018-10-12 16:29:28 -05:00
Sage Weil
b371771383 doc/rados/troubleshooting-mon: update mondb recovery script
- some cleanup (e.g., use $ms throughput)
- behave if the local host is in the $hosts list (use $ms.remote)
- be clear about updating all mons
- mon.0 -> mon.foo

Signed-off-by: Sage Weil <sage@redhat.com>
2018-10-11 11:35:31 -05:00
Sage Weil
3a4af5df51 doc/rados/troubleshooting: update notes on rebuilding mon db
- those old pg settings are no longer lost as they go in the OSDMap now
- add a note about pools that were mid-create

Signed-off-by: Sage Weil <sage@redhat.com>
2018-10-10 08:47:22 -05:00
James McClune
43540c3eb3
doc: updated cluster map reference link
Updated cluster map reference link in rados/troubleshooting/troubleshooting-mon.rst
Fixes: https://tracker.ceph.com/issues/36336

Signed-off-by: James McClune <jmcclune@mcclunetechnologies.net>
2018-10-07 21:48:31 -04:00
xie xingguo
85ba2f0a82 osd/PrimaryLogPG: s/list_missing/list_unfound/
Also:
- Do not print **offset** until specified
- Count missing objects correctly (used to be primary's local missing)

Signed-off-by: xie xingguo <xie.xingguo@zte.com.cn>
2018-09-06 09:52:20 +08:00
James McClune
19aa4b8445
doc: updated troubleshooting OSDs documentation
Restructured OSD event descriptions for better clarification.
Added a link to the write() system call reference.

Signed-off-by: James McClune <jmcclune@mcclunetechnologies.net>
2018-08-10 15:18:19 -04:00
James McClune
1b9f24a5c5
doc: cleaned up troubleshooting OSDs documentation
Fixed grammar in Troubleshooting OSDs documentation. 
Added code markup for debugging slow request commands.

Signed-off-by: James McClune <jmcclune@mcclunetechnologies.net>
2018-08-09 22:43:17 -04:00
Bryan Stillwell
791b00daa1 doc: Multiple spelling fixes
I ran a lot of the docs through aspell and found a number of spelling problems.

Signed-off-by: Bryan Stillwell <bstillwell@godaddy.com>
2018-08-09 14:51:25 -06:00
Sage Weil
6090545cc7 Merge PR #22433 into master
* refs/pull/22433/head:
	common/config: Add description to (near)full ratio settings

Reviewed-by: David Zafman <dzafman@redhat.com>
Reviewed-by: Sage Weil <sage@redhat.com>
2018-08-06 08:57:03 -05:00
Nathan Cutler
73124c8df8 doc: cleanup: prune Argonaut-specific verbiage
Also drop all release-specific upgrading instructions (they only go up to
Firefly, anyway - none of the current releases are covered).

Note that all of this verbiage I am removing here can still be accessed
on docs.ceph.com via e.g. http://docs.ceph.com/docs/firefly/

Signed-off-by: Nathan Cutler <ncutler@suse.com>
2018-07-17 12:20:01 +02:00