Commit Graph

1256 Commits

Author SHA1 Message Date
Kefu Chai
337172a4b0
Merge pull request #36536 from matthewoliver/pick_address_warning_doc_update
common/pick_address: support IPv4 and IPv6 dual stack mode

Reviewed-by: Kefu Chai <kchai@redhat.com>
2020-10-19 14:12:52 +08:00
Patrick Donnelly
cbcdb8eeeb
Merge PR #34702 into master
* refs/pull/34702/head:
	doc: Make time-related osd default values in documentation big-endian.

Reviewed-by: Kefu Chai <kchai@redhat.com>
2020-10-14 11:11:15 -07:00
Kefu Chai
585f6467ca
Merge pull request #37394 from rosinL/cleanup-queue-option
common/options: remove unavailable values of osd_op_queue

Reviewed-by: J. Eric Ivancich <ivancich@redhat.com>
Reviewed-by: Kefu Chai <kchai@redhat.com>
2020-10-14 16:08:04 +08:00
Matthew Oliver
9f75dfbf36 pick_address: Warn and continue when you find at least 1 IPv4 or IPv6 address
Currently if specify a single public or cluster network, yet have both
`ms bind ipv4` and `ms bind ipv6` set daemons crash when they can't find
both IPs from the same network:

    unable to find any IPv4 address in networks '2001:db8:11d::/120' interfaces ''

And rightly so, of course it can't find an IPv4 network in an IPv6
network.
This patch, adds a new helper method, networks_address_family_coverage,
that takes the list of networks and returns a bitmap of address families
supported.
We then check to see if we have enough networks defined and if you don't
it'll warn and then continue.

Also update the network-config-ref to mention having to define both
address family addresses for cluster and or public networks.

As well as a warning about `ms bind ipv4` being enabled by default which
is easy to miss, there by enabling dual stack when you may only be
expect single stack IPv6.

Thee is also a drive by to fix a `note` that wan't being displayed due
to missing RST syntax.

Signed-off-by: Matthew Oliver <moliver@suse.com>
Fixes: https://tracker.ceph.com/issues/46845
Fixes: https://tracker.ceph.com/issues/39711
2020-10-14 05:46:16 +00: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
luo rixin
ce2ea1d675 common/options: remove unavailable values of osd_op_queue
Signed-off-by: luo rixin <luorixin@huawei.com>
2020-10-10 09:28:17 +08:00
Anthony D'Atri
e7afd9017d
doc/rados: erasure-code-lrc corrections
doc/rados: erasure-code-lrc corrections

- Clarified / corrected jerasure recovery characterization cf. https://library.eecs.utk.edu/storage/125phpw0xFqAut-cs-07-603.pdf
- Capitalization
- Word choice:  OSDs are discrete / cardinal, so "fewer" instead of  "less"
- Reworked a few phrases to be less stilted

Signed-off-by: Anthony D'Atri <anthony.datri@gmail.com>
2020-09-28 23:42:10 -07:00
Anthony D'Atri
815263b583 doc/man: Add optional reweight-by-utilization args
doc/mgr: Grammar and wording for Prometheus labels
doc/rados: Spelling and clarity

Signed-off-by: Anthony D'Atri <anthony.datri@gmail.com>
2020-09-20 22:47:01 -07:00
Kefu Chai
266aa66aa9
Merge pull request #37252 from pponnuvel/spellcheck-docs
doc: Fixed a number of typos in documentation

Reviewed-by: Kefu Chai <kchai@redhat.com>
2020-09-19 11:07:52 +08:00
Patrick Donnelly
7eceaf45de
Merge PR #37202 into master
* refs/pull/37202/head:
	mon: allow overriding the initial mon_host

Reviewed-by: Neha Ojha <nojha@redhat.com>
2020-09-18 18:54:57 -07:00
Neha Ojha
8ba0a61a51
Merge pull request #35906 from gregsfortytwo/wip-stretch-mode
Add a new stretch mode for 2-site Ceph clusters

Reviewed-by: Josh Durgin <jdurgin@redhat.com>
2020-09-18 14:31:45 -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
Patrick Donnelly
ed3782e60a
mon: allow overriding the initial mon_host
This overrides what the CephContext believes to be the current quorum of
monitors (retrieved from other instances of the MonClient), introduced
by [1]. Tests need to be able to target a specific monitor for
exercising forwarding and other things.

[1] 731e2db9fb
Fixes: https://tracker.ceph.com/issues/47180
Signed-off-by: Patrick Donnelly <pdonnell@redhat.com>
2020-09-16 18:34:23 -07: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
Greg Farnum
9506d09e3b Merge remote-tracking branch 'origin/master' into wip-stretch-mode
Conflicts:
	src/include/ceph_features.h

Signed-off-by: Greg Farnum <gfarnum@redhat.com>
2020-09-15 02:25:07 +00:00
Greg Farnum
d02625331c Merge remote-tracking branch 'origin/master' into wip-stretch-mode 2020-09-14 02:32:19 +00:00
Sebastian Wagner
428125f8a4
Merge pull request #36946 from zdover23/wip-docs-36796-fix
doc/cephadm: Document mgr/cephadm/manage_etc_ceph_ceph_conf

Reviewed-by: Josh Durgin <jdurgin@redhat.com>
2020-09-07 10:48:27 +02:00
Kefu Chai
0f2489406a doc/dev: use prompt directive when appropriate
for 2 reasons:

* sphinx renders codeblock using python syntax highlighting by default,
  so it's not surprising that it highlight keywords like "export" in
  command line samples. so to render command line code blocks, we'd
  better specify the syntax explicitly for better rendering result.
* with the help of "prompt" directive, user is able to copy and paste
  the command without the prompt. for instance, with the default
  "::" directive, user will copy "$ ceph df", which is not very
  convenient, but with "prompt" directive, user only copies
  "ceph df".

Signed-off-by: Kefu Chai <kchai@redhat.com>
2020-09-05 00:03:52 +08:00
Zac Dover
29e8cbc49b doc/cephadm: managing ceph.conf
This commit repairs PR#36796, which was about
updating the configuration settings in ceph.conf
without touching the file directly.

That commit wasn't building because of a couple of
back quotes that were touching the word that followed
them. So much like the princess from The Princess and
The Pea is Sphinx. So careful must we always be.

Fixes: https://tracker.ceph.com/issues/47265
Signed-off-by: Zac Dover <zac.dover@gmail.com>
2020-09-04 07:31:13 +10: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
Zac Dover
99fa02f4a1 doc/rados: s/initial members/mon host
This changes an old string, "initial members"
to a current string, "mon host".

Fixes: https://tracker.ceph.com/issues/47116
Signed-off-by: Zac Dover <zac.dover@gmail.com>
2020-09-01 14:28:12 +10:00
Kefu Chai
253fd22896 doc: add sphinx.ext.mathjax for math-to-MathML rendering
Signed-off-by: Kefu Chai <kchai@redhat.com>
2020-09-01 09:53:18 +08:00
Kefu Chai
84e2808afb doc: fix broken hyper link
this link was broken in 1427905c47

Signed-off-by: Kefu Chai <kchai@redhat.com>
2020-09-01 09:53:18 +08: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
Sage Weil
dfd01d7653 blacklist -> blocklist
Signed-off-by: Sage Weil <sage@newdream.net>
Signed-off-by: Neha Ojha <nojha@redhat.com>
2020-08-24 19:53:08 +00:00
Kefu Chai
344d964b94
Merge pull request #36742 from hulksmaaash/patch-2
doc/rados: remove statement that ISA plugin only works on Intel chips

Reviewed-by: Kefu Chai <kchai@redhat.com>
2020-08-21 18:26:46 +08:00
Robbie Williamson
ccee814ffc doc/rados: remove statement that ISA plugin only works on Intel chips
ISA-L supports aarch64 (Arm), not just Intel processors, as does Ceph (see #32171).

Signed-off-by: Robbie Williamson <robbie.williamson@arm.com>
2020-08-21 08:32:53 +08:00
Kefu Chai
9dd16638ea doc/mgr/diskprediction: add a configuration section
also link to monitoring, as diskprediction cannot function without
enabling monitoring.

Signed-off-by: Kefu Chai <kchai@redhat.com>
2020-08-19 11:08:39 +08:00
Kefu Chai
9127866a6c doc/mgr/diskprediction.rst: remove references to diskprediction_cloud
since https://www.diskprophet.com is not accessible anymore, and this
feature is not available at the time of writing. let's drop the related
document.

Fixes: https://tracker.ceph.com/issues/46863
Signed-off-by: Kefu Chai <kchai@redhat.com>
2020-08-19 11:08:39 +08:00
Zac Dover
e4e9d87810 doc/rados: remove upgrade auth disable
This commit removes a recommendation to disable
authentication before performing an upgrade.

Fixes: https://tracker.ceph.com/issues/30630
Signed-off-by: Zac Dover <zac.dover@gmail.com>
2020-08-06 01:48:11 +10:00
zdover23
2343ea4baf
Merge pull request #32410 from zdover23/wip-doc-pg-repair
doc/rados/operations: document pg repairing practices
2020-08-01 12:07:12 +10:00
Greg Farnum
0a86fe281d doc: describe stretch mode for users and developers
Signed-off-by: Greg Farnum <gfarnum@redhat.com>
2020-07-21 17:59:15 +00:00
Zac Dover
bce4dc2635 doc/rados: remove a redundant "a" from a sentence
This commit changes the (not quite) sentence "Once
you have a deployed a Ceph Storage Cluster, you may
begin operating your cluster." to "Once you have
deployed a Ceph Storage Cluster, you may begin
operating your cluster."

Fixes: https://tracker.ceph.com/issues/46554
Signed-off-by: Zac Dover <zac.dover@gmail.com>
2020-07-16 18:39:08 +10:00
Benoît Knecht
535b103d18 doc/rados: Fix osd_scrub_during_recovery default value
Since 8dca17c, `osd_scrub_during_recovery` defaults to `false`, but the
documentation was still stating that its default value is `true`.

Fixes: https://tracker.ceph.com/issues/46531
Signed-off-by: Benoît Knecht <bknecht@protonmail.ch>
2020-07-14 14:01:23 +02:00
Greg Farnum
6a5c595770 doc: user docs on configuring mon elections
Signed-off-by: Greg Farnum <gfarnum@redhat.com>
2020-07-08 04:26:03 +00:00
David Zafman
02686e4cc8
Merge pull request #35514 from dzafman/wip-41564
mon: Warn when too many reads are repaired on an OSD

Reviewed-by: Josh Durgin <jdurgin@redhat.com>
Reviewed-by: Neha Ojha <nojha@redhat.com>
2020-06-17 10:18:04 -07:00
David Zafman
661996d434 mgr: Warn when too many reads are repaired on an OSD
Include test case
Configurable by setting mon_osd_warn_num_repaired (default 10)
Ignore new health warning with random eio injection test

Fixes: https://tracker.ceph.com/issues/41564

Signed-off-by: David Zafman <dzafman@redhat.com>
2020-06-16 17:45:27 -07: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
zdover23
e503942ffc
Merge pull request #35187 from CodingSpiderFox/patch-3
doc: Introduce the concept of a pool before talking about it.
2020-06-09 23:10:05 +10:00
Sebastian Wagner
cdec26d6af
Merge pull request #35124 from jmolmo/wip-doc-update-devices
doc: New section in device management

Reviewed-by: Kefu Chai <kchai@redhat.com>
Reviewed-by: Sebastian Wagner <sebastian.wagner@suse.com>
2020-06-02 12:47:54 +02:00
Kefu Chai
4c12f7556e
Merge pull request #34714 from alfredosola/patch-1
doc/rados: fix a typo in troubleshooting-mon.rst

Reviewed-by: Kefu Chai <kchai@redhat.com>
2020-06-02 12:54:14 +08:00
Juan Miguel Olmo Martínez
e0257273dd
doc: New section in device management
A new section to describe the command used to blink lights in physical devices

Signed-off-by: Juan Miguel Olmo Martínez <jolmomar@redhat.com>
2020-05-27 15:42:19 +02:00
CodingSpiderFox
d80f158954 doc: Introduce the concept of a pool before talking about it.
Signed-off-by: CodingSpiderFox <codingspiderfox@gmail.com>
2020-05-21 22:34:31 +02:00
CodingSpiderFox
0e8cc431b6 doc: clarify WAL in bluestore-config-ref.rst
Signed-off-by: CodingSpiderFox <codingspiderfox@gmail.com>
2020-05-21 10:50:58 +02:00
Sebastian Wagner
f0f86ce8ba doc/cephadm: accessing the admin socket
Signed-off-by: Sebastian Wagner <sebastian.wagner@suse.com>
2020-05-19 15:45:03 +02:00
Nathan Cutler
cde2bce385 doc: fix TCMalloc spelling
The google/tcmalloc page on GitHub refers to "TCMalloc", not
"tc_malloc".

Signed-off-by: Nathan Cutler <ncutler@suse.com>
2020-05-13 13:59:56 +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
Zac Dover
445214a89b doc/rados/operations: document pg repairing practices
This commit adds some basic commands for diagnosing
broken placement groups and repairing them.

Signed-off-by: Zac Dover <zac.dover@gmail.com>
2020-04-27 00:25:39 +08:00
Igor Fedotov
70839d99dd
Merge pull request #33065 from ifed01/wip-ifed-spurious-readerr-alert
os/bluestore: introduce health alert on spurious read errors.

Reviewed-by: Josh Durgin <jdurgin@redhat.com>
Signed-off-by: Igor Fedotov <ifedotov@suse.com>
2020-04-23 11:32:25 +03:00
Kefu Chai
0c2f0bde8a
Merge pull request #34483 from dabukalam/master
doc/rados: Remove obsolete placement group note from EC pool creation

Reviewed-by: Kefu Chai <kchai@redhat.com>
2020-04-23 15:33:06 +08:00