RepoMirrors/ceph
1
0
Fork 0
mirror of https://github.com/ceph/ceph synced 2025-02-15 14:58:01 +00:00
Code Issues Packages Projects Releases Wiki Activity

doc/cephadm: break mon section into sections

Browse Source 
This PR breaks the "Deploy Additional Monitors" section
of the cephadm documentation into several subsections
whose titles spotlight the matter under discussion in
those respective subsections.

inb4: Another PR is on deck that rewrites the sentences
in this chapter of the cephadm documentation. I'd like
to get this chapter broken up into these subsections before
I rewrite those sentences. So I'm hoping for no grammatical
mission creep on this one. The grammar and clarity updates
are coming.

Signed-off-by: Zac Dover <zac.dover@gmail.com>
This commit is contained in:
Zac Dover 2021-03-16 01:03:06 +10:00
parent fcf8fbcb6e
commit 25d9429d66
1 changed files with 17 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

33
doc/cephadm/mon.rst
View File

@ -4,8 +4,8 @@ MON Service
.. _deploy_additional_monitors: .. _deploy_additional_monitors:
Deploying additional monitors (beyond the default three) Deploying additional monitors
======================================================== -----------------------------
A typical Ceph cluster has three or five monitor daemons that are spread A typical Ceph cluster has three or five monitor daemons that are spread
across different hosts. We recommend deploying five monitors if there are across different hosts. We recommend deploying five monitors if there are
@ -29,7 +29,7 @@ manual administration of the ceph monitor daemons is not necessary.
needed, as new hosts are added to the cluster. needed, as new hosts are added to the cluster.
Designating a Particular Subnet for Monitors Designating a Particular Subnet for Monitors
============================================ --------------------------------------------
To designate a particular IP subnet for use by ceph monitor daemons, use a To designate a particular IP subnet for use by ceph monitor daemons, use a
command of the following form, including the subnet's address in `CIDR`_ command of the following form, including the subnet's address in `CIDR`_
@ -49,18 +49,18 @@ Cephadm deploys new monitor daemons only on hosts that have IP addresses in
the designated subnet. the designated subnet.
Changing the number of monitors from the default Changing the number of monitors from the default
================================================ ------------------------------------------------
* If you want to adjust the default of 5 monitors, run this command: If you want to adjust the default of 5 monitors, run this command:
.. prompt:: bash # .. prompt:: bash #
ceph orch apply mon *<number-of-monitors>* ceph orch apply mon *<number-of-monitors>*
Deploying monitors only to specific hosts Deploying monitors only to specific hosts
========================================= -----------------------------------------
* To deploy monitors on a specific set of hosts, run this command: To deploy monitors on a specific set of hosts, run this command:
.. prompt:: bash # .. prompt:: bash #
@ -69,11 +69,10 @@ Deploying monitors only to specific hosts
Be sure to include the first (bootstrap) host in this list. Be sure to include the first (bootstrap) host in this list.
Using Host Labels Using Host Labels
================= -----------------
* You can control which hosts the monitors run on by making use of You can control which hosts the monitors run on by making use of host labels.
host labels. To set the ``mon`` label to the appropriate To set the ``mon`` label to the appropriate hosts, run this command:
hosts, run this command:
.. prompt:: bash # .. prompt:: bash #
@ -109,12 +108,14 @@ Using Host Labels
ceph orch apply mon label:mon ceph orch apply mon label:mon
Deploying Monitors Manually See also :ref:`host labels <orchestrator-host-labels>`.
===========================
* You can explicitly specify the IP address or CIDR network for each monitor Deploying Monitors on a Particular Network
and control where it is placed. To disable automated monitor deployment, run ------------------------------------------
this command:
You can explicitly specify the IP address or CIDR network for each monitor and
control where each monitor is placed. To disable automated monitor deployment,
run this command:
.. prompt:: bash # .. prompt:: bash #