mirror of
https://github.com/ceph/ceph
synced 2025-02-23 02:57:21 +00:00
Merge pull request #40974 from tchaikov/wip-doc-more-conf-vals
doc/rados/configuration/mon-config-ref: use confval directive Reviewed-by: Josh Durgin <jdurgin@redhat.com>
This commit is contained in:
commit
fc1d1c7326
@ -210,7 +210,15 @@ class CephOption(Directive):
|
||||
desc = opt.get('fmt_desc') or opt.get('long_desc') or opt.get('desc')
|
||||
opt_default = opt.get('default')
|
||||
default = self.options.get('default', opt_default)
|
||||
rendered = self.template.render(opt=opt, desc=desc, default=default)
|
||||
try:
|
||||
rendered = self.template.render(opt=opt,
|
||||
desc=desc,
|
||||
default=default)
|
||||
except Exception as e:
|
||||
message = (f'Unable to render option "{name}": {e}. ',
|
||||
f'opt={opt}, desc={desc}, default={default}')
|
||||
raise self.error(message)
|
||||
|
||||
lineno = self.lineno - self.state_machine.input_offset - 1
|
||||
source = self.state_machine.input_lines.source(lineno)
|
||||
self.state_machine.insert_input(rendered.split('\n'), source)
|
||||
|
@ -324,6 +324,15 @@ To enable sharding and apply the Pacific defaults, stop an OSD and run
|
||||
.. confval:: bluestore_rocksdb_cf
|
||||
.. confval:: bluestore_rocksdb_cfs
|
||||
|
||||
Throttling
|
||||
==========
|
||||
|
||||
.. confval:: bluestore_throttle_bytes
|
||||
.. confval:: bluestore_throttle_deferred_bytes
|
||||
.. confval:: bluestore_throttle_cost_per_io
|
||||
.. confval:: bluestore_throttle_cost_per_io_hdd
|
||||
.. confval:: bluestore_throttle_cost_per_io_ssd
|
||||
|
||||
SPDK Usage
|
||||
==================
|
||||
|
||||
|
@ -167,7 +167,7 @@ maximize the impact of the mclock scheduler.
|
||||
|
||||
:Bluestore Throttle Parameters:
|
||||
We recommend using the default values as defined by
|
||||
``bluestore_throttle_bytes`` and ``bluestore_throttle_deferred_bytes``. But
|
||||
:confval:`bluestore_throttle_bytes` and :confval:`bluestore_throttle_deferred_bytes`. But
|
||||
these parameters may also be determined during the benchmarking phase as
|
||||
described below.
|
||||
|
||||
@ -183,7 +183,7 @@ correct bluestore throttle values.
|
||||
2. Install cbt and all the dependencies mentioned on the cbt github page.
|
||||
3. Construct the Ceph configuration file and the cbt yaml file.
|
||||
4. Ensure that the bluestore throttle options ( i.e.
|
||||
``bluestore_throttle_bytes`` and ``bluestore_throttle_deferred_bytes``) are
|
||||
:confval:`bluestore_throttle_bytes` and :confval:`bluestore_throttle_deferred_bytes`) are
|
||||
set to the default values.
|
||||
5. Ensure that the test is performed on similar device types to get reliable
|
||||
OSD capacity data.
|
||||
@ -195,8 +195,8 @@ correct bluestore throttle values.
|
||||
value is the baseline throughput(IOPS) when the default bluestore
|
||||
throttle options are in effect.
|
||||
9. If the intent is to determine the bluestore throttle values for your
|
||||
environment, then set the two options, ``bluestore_throttle_bytes`` and
|
||||
``bluestore_throttle_deferred_bytes`` to 32 KiB(32768 Bytes) each to begin
|
||||
environment, then set the two options, :confval:`bluestore_throttle_bytes` and
|
||||
:confval:`bluestore_throttle_deferred_bytes` to 32 KiB(32768 Bytes) each to begin
|
||||
with. Otherwise, you may skip to the next section.
|
||||
10. Run the 4KiB random write workload as before on the OSD(s) for 300 secs.
|
||||
11. Note the overall throughput from the cbt log files and compare the value
|
||||
@ -253,7 +253,7 @@ The other values for the built-in profiles include *balanced* and
|
||||
*high_recovery_ops*.
|
||||
|
||||
If there is a requirement to change the default profile, then the option
|
||||
``osd_mclock_profile`` may be set in the **[global]** or **[osd]** section of
|
||||
:confval:`osd_mclock_profile` may be set in the **[global]** or **[osd]** section of
|
||||
your Ceph configuration file before bringing up your cluster.
|
||||
|
||||
Alternatively, to change the profile during runtime, use the following command:
|
||||
|
@ -222,7 +222,7 @@ See the `Network Configuration Reference`_ for details.
|
||||
|
||||
Once you deploy a Ceph cluster, you **SHOULD NOT** change the IP addresses of
|
||||
monitors. However, if you decide to change the monitor's IP address, you
|
||||
must follow a specific procedure. See `Changing a Monitor's IP Address`_ for
|
||||
must follow a specific procedure. See :ref:`Changing a Monitor's IP address` for
|
||||
details.
|
||||
|
||||
Monitors can also be found by clients by using DNS SRV records. See `Monitor lookup through DNS`_ for details.
|
||||
@ -577,36 +577,10 @@ acceptable values.
|
||||
Client
|
||||
------
|
||||
|
||||
``mon_client_hunt_interval``
|
||||
|
||||
:Description: The client will try a new monitor every ``N`` seconds until it
|
||||
establishes a connection.
|
||||
|
||||
:Type: Double
|
||||
:Default: ``3.00``
|
||||
|
||||
|
||||
``mon_client_ping_interval``
|
||||
|
||||
:Description: The client will ping the monitor every ``N`` seconds.
|
||||
:Type: Double
|
||||
:Default: ``10.00``
|
||||
|
||||
|
||||
``mon_client_max_log_entries_per_message``
|
||||
|
||||
:Description: The maximum number of log entries a monitor will generate
|
||||
per client message.
|
||||
|
||||
:Type: Integer
|
||||
:Default: ``1000``
|
||||
|
||||
|
||||
``mon_client_bytes``
|
||||
|
||||
:Description: The amount of client message data allowed in memory (in bytes).
|
||||
:Type: 64-bit Integer Unsigned
|
||||
:Default: ``100ul << 20``
|
||||
.. confval:: mon_client_hunt_interval
|
||||
.. confval:: mon_client_ping_interval
|
||||
.. confval:: mon_client_max_log_entries_per_message
|
||||
.. confval:: mon_client_bytes
|
||||
|
||||
.. _pool-settings:
|
||||
|
||||
@ -617,258 +591,42 @@ Since version v0.94 there is support for pool flags which allow or disallow chan
|
||||
Monitors can also disallow removal of pools if appropriately configured. The inconvenience of this guardrail
|
||||
is far outweighed by the number of accidental pool (and thus data) deletions it prevents.
|
||||
|
||||
``mon_allow_pool_delete``
|
||||
.. confval:: mon_allow_pool_delete
|
||||
.. confval:: osd_pool_default_ec_fast_read
|
||||
.. confval:: osd_pool_default_flag_hashpspool
|
||||
.. confval:: osd_pool_default_flag_nodelete
|
||||
.. confval:: osd_pool_default_flag_nopgchange
|
||||
.. confval:: osd_pool_default_flag_nosizechange
|
||||
|
||||
:Description: Should monitors allow pools to be removed, regardless of what the pool flags say?
|
||||
|
||||
:Type: Boolean
|
||||
:Default: ``false``
|
||||
|
||||
|
||||
``osd_pool_default_ec_fast_read``
|
||||
|
||||
:Description: Whether to turn on fast read on the pool or not. It will be used as
|
||||
the default setting of newly created erasure coded pools if ``fast_read``
|
||||
is not specified at create time.
|
||||
|
||||
:Type: Boolean
|
||||
:Default: ``false``
|
||||
|
||||
|
||||
``osd_pool_default_flag_hashpspool``
|
||||
|
||||
:Description: Set the hashpspool flag on new pools
|
||||
:Type: Boolean
|
||||
:Default: ``true``
|
||||
|
||||
|
||||
``osd_pool_default_flag_nodelete``
|
||||
|
||||
:Description: Set the ``nodelete`` flag on new pools, which prevents pool removal.
|
||||
:Type: Boolean
|
||||
:Default: ``false``
|
||||
|
||||
|
||||
``osd_pool_default_flag_nopgchange``
|
||||
|
||||
:Description: Set the ``nopgchange`` flag on new pools. Does not allow the number of PGs to be changed.
|
||||
:Type: Boolean
|
||||
:Default: ``false``
|
||||
|
||||
|
||||
``osd_pool_default_flag_nosizechange``
|
||||
|
||||
:Description: Set the ``nosizechange`` flag on new pools. Does not allow the ``size`` to be changed.
|
||||
:Type: Boolean
|
||||
:Default: ``false``
|
||||
|
||||
For more information about the pool flags see `Pool values`_.
|
||||
For more information about the pool flags see :ref:`Pool values <setpoolvalues>`.
|
||||
|
||||
Miscellaneous
|
||||
=============
|
||||
|
||||
``mon_max_osd``
|
||||
|
||||
:Description: The maximum number of OSDs allowed in the cluster.
|
||||
:Type: 32-bit Integer
|
||||
:Default: ``10000``
|
||||
|
||||
|
||||
``mon_globalid_prealloc``
|
||||
|
||||
:Description: The number of global IDs to pre-allocate for clients and daemons in the cluster.
|
||||
:Type: 32-bit Integer
|
||||
:Default: ``10000``
|
||||
|
||||
|
||||
``mon_subscribe_interval``
|
||||
|
||||
:Description: The refresh interval (in seconds) for subscriptions. The
|
||||
subscription mechanism enables obtaining cluster maps
|
||||
and log information.
|
||||
|
||||
:Type: Double
|
||||
:Default: ``86400.00``
|
||||
|
||||
|
||||
``mon_stat_smooth_intervals``
|
||||
|
||||
:Description: Ceph will smooth statistics over the last ``N`` PG maps.
|
||||
:Type: Integer
|
||||
:Default: ``6``
|
||||
|
||||
|
||||
``mon_probe_timeout``
|
||||
|
||||
:Description: Number of seconds the monitor will wait to find peers before bootstrapping.
|
||||
:Type: Double
|
||||
:Default: ``2.00``
|
||||
|
||||
|
||||
``mon_daemon_bytes``
|
||||
|
||||
:Description: The message memory cap for metadata server and OSD messages (in bytes).
|
||||
:Type: 64-bit Integer Unsigned
|
||||
:Default: ``400ul << 20``
|
||||
|
||||
|
||||
``mon_max_log_entries_per_event``
|
||||
|
||||
:Description: The maximum number of log entries per event.
|
||||
:Type: Integer
|
||||
:Default: ``4096``
|
||||
|
||||
|
||||
``mon_osd_prime_pg_temp``
|
||||
|
||||
:Description: Enables or disables priming the PGMap with the previous OSDs when an ``out``
|
||||
OSD comes back into the cluster. With the ``true`` setting, clients
|
||||
will continue to use the previous OSDs until the newly ``in`` OSDs for
|
||||
a PG have peered.
|
||||
|
||||
:Type: Boolean
|
||||
:Default: ``true``
|
||||
|
||||
|
||||
``mon_osd_prime pg temp max time``
|
||||
|
||||
:Description: How much time in seconds the monitor should spend trying to prime the
|
||||
PGMap when an out OSD comes back into the cluster.
|
||||
|
||||
:Type: Float
|
||||
:Default: ``0.50``
|
||||
|
||||
|
||||
``mon_osd_prime_pg_temp_max_time_estimate``
|
||||
|
||||
:Description: Maximum estimate of time spent on each PG before we prime all PGs
|
||||
in parallel.
|
||||
|
||||
:Type: Float
|
||||
:Default: ``0.25``
|
||||
|
||||
|
||||
``mon_mds_skip_sanity``
|
||||
|
||||
:Description: Skip safety assertions on FSMap (in case of bugs where we want to
|
||||
continue anyway). Monitor terminates if the FSMap sanity check
|
||||
fails, but we can disable it by enabling this option.
|
||||
|
||||
:Type: Boolean
|
||||
:Default: ``False``
|
||||
|
||||
|
||||
``mon_max_mdsmap_epochs``
|
||||
|
||||
:Description: The maximum number of mdsmap epochs to trim during a single proposal.
|
||||
:Type: Integer
|
||||
:Default: ``500``
|
||||
|
||||
|
||||
``mon_config_key_max_entry_size``
|
||||
|
||||
:Description: The maximum size of config-key entry (in bytes)
|
||||
:Type: Integer
|
||||
:Default: ``65536``
|
||||
|
||||
|
||||
``mon_scrub_interval``
|
||||
|
||||
:Description: How often the monitor scrubs its store by comparing
|
||||
the stored checksums with the computed ones for all stored
|
||||
keys. (0 disables it. dangerous, use with care)
|
||||
|
||||
:Type: Seconds
|
||||
:Default: ``1 day``
|
||||
|
||||
|
||||
``mon_scrub_max_keys``
|
||||
|
||||
:Description: The maximum number of keys to scrub each time.
|
||||
:Type: Integer
|
||||
:Default: ``100``
|
||||
|
||||
|
||||
``mon_compact_on_start``
|
||||
|
||||
:Description: Compact the database used as Ceph Monitor store on
|
||||
``ceph-mon`` start. A manual compaction helps to shrink the
|
||||
monitor database and improve the performance of it if the regular
|
||||
compaction fails to work.
|
||||
|
||||
:Type: Boolean
|
||||
:Default: ``False``
|
||||
|
||||
|
||||
``mon_compact_on_bootstrap``
|
||||
|
||||
:Description: Compact the database used as Ceph Monitor store
|
||||
on bootstrap. Monitors probe each other to establish
|
||||
a quorum after bootstrap. If a monitor times out before joining the
|
||||
quorum, it will start over and bootstrap again.
|
||||
|
||||
:Type: Boolean
|
||||
:Default: ``False``
|
||||
|
||||
|
||||
``mon_compact_on_trim``
|
||||
|
||||
:Description: Compact a certain prefix (including paxos) when we trim its old states.
|
||||
:Type: Boolean
|
||||
:Default: ``True``
|
||||
|
||||
|
||||
``mon_cpu_threads``
|
||||
|
||||
:Description: Number of threads for performing CPU intensive work on monitor.
|
||||
:Type: Integer
|
||||
:Default: ``4``
|
||||
|
||||
|
||||
``mon_osd_mapping_pgs_per_chunk``
|
||||
|
||||
:Description: We calculate the mapping from placement group to OSDs in chunks.
|
||||
This option specifies the number of placement groups per chunk.
|
||||
|
||||
:Type: Integer
|
||||
:Default: ``4096``
|
||||
|
||||
|
||||
``mon_session_timeout``
|
||||
|
||||
:Description: Monitor will terminate inactive sessions stay idle over this
|
||||
time limit.
|
||||
|
||||
:Type: Integer
|
||||
:Default: ``300``
|
||||
|
||||
|
||||
``mon_osd_cache_size_min``
|
||||
|
||||
:Description: The minimum amount of bytes to be kept mapped in memory for osd
|
||||
monitor caches.
|
||||
|
||||
:Type: 64-bit Integer
|
||||
:Default: ``134217728``
|
||||
|
||||
|
||||
``mon_memory_target``
|
||||
|
||||
:Description: The amount of bytes pertaining to OSD monitor caches and KV cache
|
||||
to be kept mapped in memory with cache auto-tuning enabled.
|
||||
|
||||
:Type: 64-bit Integer
|
||||
:Default: ``2147483648``
|
||||
|
||||
|
||||
``mon_memory_autotune``
|
||||
|
||||
:Description: Autotune the cache memory used for OSD monitors and KV
|
||||
database.
|
||||
|
||||
:Type: Boolean
|
||||
:Default: ``True``
|
||||
|
||||
.. confval:: mon_max_osd
|
||||
.. confval:: mon_globalid_prealloc
|
||||
.. confval:: mon_subscribe_interval
|
||||
.. confval:: mon_stat_smooth_intervals
|
||||
.. confval:: mon_probe_timeout
|
||||
.. confval:: mon_daemon_bytes
|
||||
.. confval:: mon_max_log_entries_per_event
|
||||
.. confval:: mon_osd_prime_pg_temp
|
||||
.. confval:: mon_osd_prime_pg_temp_max_time
|
||||
.. confval:: mon_osd_prime_pg_temp_max_estimate
|
||||
.. confval:: mon_mds_skip_sanity
|
||||
.. confval:: mon_max_mdsmap_epochs
|
||||
.. confval:: mon_config_key_max_entry_size
|
||||
.. confval:: mon_scrub_interval
|
||||
.. confval:: mon_scrub_max_keys
|
||||
.. confval:: mon_compact_on_start
|
||||
.. confval:: mon_compact_on_bootstrap
|
||||
.. confval:: mon_compact_on_trim
|
||||
.. confval:: mon_cpu_threads
|
||||
.. confval:: mon_osd_mapping_pgs_per_chunk
|
||||
.. confval:: mon_session_timeout
|
||||
.. confval:: mon_osd_cache_size_min
|
||||
.. confval:: mon_memory_target
|
||||
.. confval:: mon_memory_autotune
|
||||
|
||||
.. _Paxos: https://en.wikipedia.org/wiki/Paxos_(computer_science)
|
||||
.. _Monitor Keyrings: ../../../dev/mon-bootstrap#secret-keys
|
||||
@ -880,7 +638,5 @@ Miscellaneous
|
||||
.. _Monitoring a Cluster: ../../operations/monitoring
|
||||
.. _Monitoring OSDs and PGs: ../../operations/monitoring-osd-pg
|
||||
.. _Bootstrapping a Monitor: ../../../dev/mon-bootstrap
|
||||
.. _Changing a Monitor's IP Address: ../../operations/add-or-rm-mons#changing-a-monitor-s-ip-address
|
||||
.. _Monitor/OSD Interaction: ../mon-osd-interaction
|
||||
.. _Scalability and High Availability: ../../../architecture#scalability-and-high-availability
|
||||
.. _Pool values: ../../operations/pools/#set-pool-values
|
||||
|
@ -179,6 +179,9 @@ scrubbing operations.
|
||||
Operations
|
||||
==========
|
||||
|
||||
.. confval:: osd_op_num_shards
|
||||
.. confval:: osd_op_num_shards_hdd
|
||||
.. confval:: osd_op_num_shards_ssd
|
||||
.. confval:: osd_op_queue
|
||||
.. confval:: osd_op_queue_cut_off
|
||||
.. confval:: osd_client_op_priority
|
||||
@ -285,8 +288,8 @@ queues within Ceph. First, requests to an OSD are sharded by their
|
||||
placement group identifier. Each shard has its own mClock queue and
|
||||
these queues neither interact nor share information among them. The
|
||||
number of shards can be controlled with the configuration options
|
||||
``osd_op_num_shards``, ``osd_op_num_shards_hdd``, and
|
||||
``osd_op_num_shards_ssd``. A lower number of shards will increase the
|
||||
:confval:`osd_op_num_shards`, :confval:`osd_op_num_shards_hdd`, and
|
||||
:confval:`osd_op_num_shards_ssd`. A lower number of shards will increase the
|
||||
impact of the mClock queues, but may have other deleterious effects.
|
||||
|
||||
Second, requests are transferred from the operation queue to the
|
||||
@ -303,11 +306,11 @@ the impact of mClock, we want to keep as few operations in the
|
||||
operation sequencer as possible. So we have an inherent tension.
|
||||
|
||||
The configuration options that influence the number of operations in
|
||||
the operation sequencer are ``bluestore_throttle_bytes``,
|
||||
``bluestore_throttle_deferred_bytes``,
|
||||
``bluestore_throttle_cost_per_io``,
|
||||
``bluestore_throttle_cost_per_io_hdd``, and
|
||||
``bluestore_throttle_cost_per_io_ssd``.
|
||||
the operation sequencer are :confval:`bluestore_throttle_bytes`,
|
||||
:confval:`bluestore_throttle_deferred_bytes`,
|
||||
:confval:`bluestore_throttle_cost_per_io`,
|
||||
:confval:`bluestore_throttle_cost_per_io_hdd`, and
|
||||
:confval:`bluestore_throttle_cost_per_io_ssd`.
|
||||
|
||||
A third factor that affects the impact of the mClock algorithm is that
|
||||
we're using a distributed system, where requests are made to multiple
|
||||
|
@ -1608,6 +1608,10 @@ options:
|
||||
default: false
|
||||
services:
|
||||
- mon
|
||||
fmt_desc: Compact the database used as Ceph Monitor store on
|
||||
``ceph-mon`` start. A manual compaction helps to shrink the
|
||||
monitor database and improve the performance of it if the regular
|
||||
compaction fails to work.
|
||||
with_legacy: true
|
||||
# trigger leveldb compaction on bootstrap
|
||||
- name: mon_compact_on_bootstrap
|
||||
@ -1616,6 +1620,10 @@ options:
|
||||
default: false
|
||||
services:
|
||||
- mon
|
||||
fmt_desc: Compact the database used as Ceph Monitor store
|
||||
on bootstrap. Monitors probe each other to establish
|
||||
a quorum after bootstrap. If a monitor times out before joining the
|
||||
quorum, it will start over and bootstrap again.
|
||||
with_legacy: true
|
||||
# compact (a prefix) when we trim old states
|
||||
- name: mon_compact_on_trim
|
||||
@ -1624,6 +1632,7 @@ options:
|
||||
default: true
|
||||
services:
|
||||
- mon
|
||||
fmt_desc: Compact a certain prefix (including paxos) when we trim its old states.
|
||||
with_legacy: true
|
||||
- name: mon_osdmap_full_prune_enabled
|
||||
type: bool
|
||||
@ -1683,6 +1692,8 @@ options:
|
||||
type: size
|
||||
level: advanced
|
||||
desc: The minimum amount of bytes to be kept mapped in memory for osd monitor caches.
|
||||
fmt_desc: The minimum amount of bytes to be kept mapped in memory for osd
|
||||
monitor caches.
|
||||
default: 128_M
|
||||
services:
|
||||
- mon
|
||||
@ -1692,6 +1703,8 @@ options:
|
||||
level: basic
|
||||
desc: The amount of bytes pertaining to osd monitor caches and kv cache to be kept
|
||||
mapped in memory with cache auto-tuning enabled
|
||||
fmt_desc: The amount of bytes pertaining to OSD monitor caches and KV cache
|
||||
to be kept mapped in memory with cache auto-tuning enabled.
|
||||
default: 2_G
|
||||
services:
|
||||
- mon
|
||||
@ -1702,6 +1715,8 @@ options:
|
||||
type: bool
|
||||
level: basic
|
||||
desc: Autotune the cache memory being used for osd monitors and kv database
|
||||
fmt_desc: Autotune the cache memory used for OSD monitors and KV
|
||||
database.
|
||||
default: true
|
||||
services:
|
||||
- mon
|
||||
@ -1712,6 +1727,7 @@ options:
|
||||
type: int
|
||||
level: advanced
|
||||
desc: worker threads for CPU intensive background work
|
||||
fmt_desc: Number of threads for performing CPU intensive work on monitor.
|
||||
default: 4
|
||||
services:
|
||||
- mon
|
||||
@ -1720,6 +1736,8 @@ options:
|
||||
type: int
|
||||
level: dev
|
||||
desc: granularity of PG placement calculation background work
|
||||
fmt_desc: We calculate the mapping from placement group to OSDs in chunks.
|
||||
This option specifies the number of placement groups per chunk.
|
||||
default: 4096
|
||||
services:
|
||||
- mon
|
||||
@ -1762,6 +1780,8 @@ options:
|
||||
type: int
|
||||
level: advanced
|
||||
desc: close inactive mon client connections after this many seconds
|
||||
fmt_desc: Monitor will terminate inactive sessions stay idle over this
|
||||
time limit.
|
||||
default: 5_min
|
||||
services:
|
||||
- mon
|
||||
@ -1770,6 +1790,9 @@ options:
|
||||
type: float
|
||||
level: dev
|
||||
desc: subscribe interval for pre-jewel clients
|
||||
fmt_desc: The refresh interval (in seconds) for subscriptions. The
|
||||
subscription mechanism enables obtaining cluster maps
|
||||
and log information.
|
||||
default: 1_day
|
||||
services:
|
||||
- mon
|
||||
@ -1972,6 +1995,10 @@ options:
|
||||
type: bool
|
||||
level: dev
|
||||
desc: minimize peering work by priming pg_temp values after a map change
|
||||
fmt_desc: Enables or disables priming the PGMap with the previous OSDs when an ``out``
|
||||
OSD comes back into the cluster. With the ``true`` setting, clients
|
||||
will continue to use the previous OSDs until the newly ``in`` OSDs for
|
||||
a PG have peered.
|
||||
default: true
|
||||
services:
|
||||
- mon
|
||||
@ -1980,6 +2007,8 @@ options:
|
||||
type: float
|
||||
level: dev
|
||||
desc: maximum time to spend precalculating PG mappings on map change (seconds)
|
||||
fmt_desc: How much time in seconds the monitor should spend trying to prime the
|
||||
PGMap when an out OSD comes back into the cluster.
|
||||
default: 0.5
|
||||
services:
|
||||
- mon
|
||||
@ -1989,6 +2018,8 @@ options:
|
||||
level: advanced
|
||||
desc: calculate all PG mappings if estimated fraction of PGs that change is above
|
||||
this amount
|
||||
fmt_desc: Maximum estimate of time spent on each PG before we prime all PGs
|
||||
in parallel.
|
||||
default: 0.25
|
||||
services:
|
||||
- mon
|
||||
@ -1998,6 +2029,7 @@ options:
|
||||
level: advanced
|
||||
desc: number of PGMaps stats over which we calc the average read/write throughput
|
||||
of the whole cluster
|
||||
fmt_desc: Ceph will smooth statistics over the last ``N`` PG maps.
|
||||
default: 6
|
||||
services:
|
||||
- mgr
|
||||
@ -2335,6 +2367,7 @@ options:
|
||||
type: bool
|
||||
level: advanced
|
||||
desc: allow pool deletions
|
||||
fmt_desc: Should monitors allow pools to be removed, regardless of what the pool flags say?
|
||||
default: false
|
||||
services:
|
||||
- mon
|
||||
@ -2354,6 +2387,7 @@ options:
|
||||
long_desc: This setting caps how many new clients can authenticate with the cluster
|
||||
before the monitors have to perform a write to preallocate more. Large values
|
||||
burn through the 64-bit ID space more quickly.
|
||||
fmt_desc: The number of global IDs to pre-allocate for clients and daemons in the cluster.
|
||||
default: 10000
|
||||
services:
|
||||
- mon
|
||||
@ -2566,6 +2600,7 @@ options:
|
||||
type: int
|
||||
level: advanced
|
||||
desc: max number of FSMaps/MDSMaps to store
|
||||
fmt_desc: The maximum number of mdsmap epochs to trim during a single proposal.
|
||||
default: 500
|
||||
services:
|
||||
- mon
|
||||
@ -2581,6 +2616,7 @@ options:
|
||||
type: int
|
||||
level: advanced
|
||||
desc: max number of OSDs in a cluster
|
||||
fmt_desc: The maximum number of OSDs allowed in the cluster.
|
||||
default: 10000
|
||||
services:
|
||||
- mon
|
||||
@ -2589,6 +2625,7 @@ options:
|
||||
type: float
|
||||
level: advanced
|
||||
desc: timeout for querying other mons during bootstrap pre-election phase (seconds)
|
||||
fmt_desc: Number of seconds the monitor will wait to find peers before bootstrapping.
|
||||
default: 2
|
||||
services:
|
||||
- mon
|
||||
@ -2597,6 +2634,7 @@ options:
|
||||
type: size
|
||||
level: advanced
|
||||
desc: max bytes of outstanding client messages mon will read off the network
|
||||
fmt_desc: The amount of client message data allowed in memory (in bytes).
|
||||
default: 100_M
|
||||
services:
|
||||
- mon
|
||||
@ -2605,6 +2643,7 @@ options:
|
||||
type: size
|
||||
level: advanced
|
||||
desc: max bytes of outstanding mon messages mon will read off the network
|
||||
fmt_desc: The message memory cap for metadata server and OSD messages (in bytes).
|
||||
default: 400_M
|
||||
services:
|
||||
- mon
|
||||
@ -2629,6 +2668,7 @@ options:
|
||||
type: int
|
||||
level: advanced
|
||||
desc: max cluster log entries per paxos event
|
||||
fmt_desc: The maximum number of log entries per event.
|
||||
default: 4096
|
||||
services:
|
||||
- mon
|
||||
@ -2773,6 +2813,9 @@ options:
|
||||
type: secs
|
||||
level: advanced
|
||||
desc: frequency for scrubbing mon database
|
||||
fmt_desc: How often the monitor scrubs its store by comparing
|
||||
the stored checksums with the computed ones for all stored
|
||||
keys. (0 disables it. dangerous, use with care)
|
||||
default: 1_day
|
||||
services:
|
||||
- mon
|
||||
@ -2789,6 +2832,7 @@ options:
|
||||
type: int
|
||||
level: advanced
|
||||
desc: max keys per on scrub chunk/step
|
||||
fmt_desc: The maximum number of keys to scrub each time.
|
||||
default: 100
|
||||
services:
|
||||
- mon
|
||||
@ -2815,6 +2859,7 @@ options:
|
||||
type: size
|
||||
level: advanced
|
||||
desc: Defines the number of bytes allowed to be held in a single config-key entry
|
||||
fmt_desc: The maximum size of config-key entry (in bytes)
|
||||
default: 64_K
|
||||
services:
|
||||
- mon
|
||||
@ -2925,6 +2970,9 @@ options:
|
||||
type: bool
|
||||
level: advanced
|
||||
desc: skip sanity checks on fsmap/mdsmap
|
||||
fmt_desc: Skip safety assertions on FSMap (in case of bugs where we want to
|
||||
continue anyway). Monitor terminates if the FSMap sanity check
|
||||
fails, but we can disable it by enabling this option.
|
||||
default: false
|
||||
services:
|
||||
- mon
|
||||
@ -3441,6 +3489,8 @@ options:
|
||||
type: float
|
||||
level: advanced
|
||||
default: 3
|
||||
fmt_desc: The client will try a new monitor every ``N`` seconds until it
|
||||
establishes a connection.
|
||||
with_legacy: true
|
||||
# send logs every N seconds
|
||||
- name: mon_client_log_interval
|
||||
@ -3454,6 +3504,7 @@ options:
|
||||
type: float
|
||||
level: advanced
|
||||
default: 10
|
||||
fmt_desc: The client will ping the monitor every ``N`` seconds.
|
||||
with_legacy: true
|
||||
# fail if we don't hear back
|
||||
- name: mon_client_ping_timeout
|
||||
@ -3480,6 +3531,8 @@ options:
|
||||
type: int
|
||||
level: advanced
|
||||
default: 1000
|
||||
fmt_desc: The maximum number of log entries a monitor will generate
|
||||
per client message.
|
||||
with_legacy: true
|
||||
- name: mon_client_directed_command_retry
|
||||
type: int
|
||||
@ -3910,6 +3963,9 @@ options:
|
||||
type: bool
|
||||
level: advanced
|
||||
desc: set ec_fast_read for new erasure-coded pools
|
||||
fmt_desc: Whether to turn on fast read on the pool or not. It will be used as
|
||||
the default setting of newly created erasure coded pools if ``fast_read``
|
||||
is not specified at create time.
|
||||
default: false
|
||||
services:
|
||||
- mon
|
||||
@ -4063,6 +4119,7 @@ options:
|
||||
type: bool
|
||||
level: advanced
|
||||
desc: set nodelete flag on new pools
|
||||
fmt_desc: Set the ``nodelete`` flag on new pools, which prevents pool removal.
|
||||
default: false
|
||||
services:
|
||||
- mon
|
||||
@ -4072,6 +4129,7 @@ options:
|
||||
type: bool
|
||||
level: advanced
|
||||
desc: set nopgchange flag on new pools
|
||||
fmt_desc: Set the ``nopgchange`` flag on new pools. Does not allow the number of PGs to be changed.
|
||||
default: false
|
||||
services:
|
||||
- mon
|
||||
@ -4081,6 +4139,7 @@ options:
|
||||
type: bool
|
||||
level: advanced
|
||||
desc: set nosizechange flag on new pools
|
||||
fmt_desc: Set the ``nosizechange`` flag on new pools. Does not allow the ``size`` to be changed.
|
||||
default: false
|
||||
services:
|
||||
- mon
|
||||
@ -4348,6 +4407,9 @@ options:
|
||||
- name: osd_op_num_shards
|
||||
type: int
|
||||
level: advanced
|
||||
fmt_desc: The number of shards allocated for a given OSD. Each shard has its own processing queue.
|
||||
PGs on the OSD are distributed evenly in the shard. This setting overrides _ssd and _hdd if
|
||||
non-zero.
|
||||
default: 0
|
||||
flags:
|
||||
- startup
|
||||
@ -4355,6 +4417,7 @@ options:
|
||||
- name: osd_op_num_shards_hdd
|
||||
type: int
|
||||
level: advanced
|
||||
fmt_desc: the number of shards allocated for a given OSD (for rotational media).
|
||||
default: 5
|
||||
see_also:
|
||||
- osd_op_num_shards
|
||||
@ -4364,6 +4427,7 @@ options:
|
||||
- name: osd_op_num_shards_ssd
|
||||
type: int
|
||||
level: advanced
|
||||
fmt_desc: the number of shards allocated for a given OSD (for solid state media).
|
||||
default: 8
|
||||
see_also:
|
||||
- osd_op_num_shards
|
||||
|
Loading…
Reference in New Issue
Block a user