From: Zac Dover Date: Thu, 2 Sep 2021 19:22:38 +0000 (+1000) Subject: doc: rados/ceph-conf.rst bootstrap options X-Git-Tag: v17.1.0~955^2 X-Git-Url: http://git.apps.os.sepia.ceph.com/?a=commitdiff_plain;h=refs%2Fpull%2F43035%2Fhead;p=ceph.git doc: rados/ceph-conf.rst bootstrap options This is the editorial syntax and elegance PR for the "Bootstrap Options" section in the "Configuring Ceph" chapter of the RADOS Guide. Signed-off-by: Zac Dover --- diff --git a/doc/rados/configuration/ceph-conf.rst b/doc/rados/configuration/ceph-conf.rst index fc851d8f627ac..3e11bcc19ab05 100644 --- a/doc/rados/configuration/ceph-conf.rst +++ b/doc/rados/configuration/ceph-conf.rst @@ -67,10 +67,11 @@ daemon or process startup will proceed. Bootstrap options ----------------- -Because some configuration options affect the process's ability to -contact the monitors, authenticate, and retrieve the cluster-stored -configuration, they may need to be stored locally on the node and set -in a local configuration file. These options include: +Some configuration options affect the process's ability to contact the +monitors, to authenticate, and to retrieve the cluster-stored configuration. +For this reason, these options might need to be stored locally on the node, and +set by means of a local configuration file. These options include the +following: .. confval:: mon_host .. confval:: mon_host_override @@ -84,20 +85,19 @@ in a local configuration file. These options include: the monitor. Note that in most cases the default keyring location is in the data directory specified above. -In the vast majority of cases the default values of these are -appropriate, with the exception of the :confval:`mon_host` option that -identifies the addresses of the cluster's monitors. When DNS is used -to identify monitors a local ceph configuration file can be avoided -entirely. +In most cases, the default values of these options are suitable. There is one +exception to this: the :confval:`mon_host` option that identifies the addresses +of the cluster's monitors. When DNS is used to identify monitors, a local Ceph +configuration file can be avoided entirely. Skipping monitor config ----------------------- -Any process may be passed the option ``--no-mon-config`` to skip the -step that retrieves configuration from the cluster monitors. This is -useful in cases where configuration is managed entirely via -configuration files or where the monitor cluster is currently down but -some maintenance activity needs to be done. +Pass the option ``--no-mon-config`` to any process to skip the step that +retrieves configuration information from the cluster monitors. This is useful +in cases where configuration is managed entirely via configuration files, or +when the monitor cluster is down and some maintenance activity needs to be +done. .. _ceph-conf-file: