mirror of
https://github.com/ceph/ceph
synced 2025-01-06 19:20:49 +00:00
21d68cf137
Ceph config option names may use spaces, underscores, or by one reference hyphens as interstitial separators. Most usage within the doc tree uses underscores, though example conf files and especially structured lists of options mostly use spaces. Mostly. Underscores help differentiate the config names from surrounding text, and moreover facilitate scripting, grep, awk, etc and match their form in src/common/options.cc. This PR conforms these occurrences of option names to use interstitial underscores instead of spaces. Fixes: https://tracker.ceph.com/issues/48301 Signed-off-by: Anthony D'Atri <anthony.datri@gmail.com>
38 lines
1.4 KiB
ReStructuredText
38 lines
1.4 KiB
ReStructuredText
Local Pool Module
|
|
=================
|
|
|
|
The *localpool* module can automatically create RADOS pools that are
|
|
localized to a subset of the overall cluster. For example, by default, it will
|
|
create a pool for each distinct ``rack`` in the cluster. This can be useful for
|
|
deployments where it is desirable to distribute some data locally and other data
|
|
globally across the cluster. One use-case is measuring performance and testing
|
|
behavior of specific drive, NIC, or chassis models in isolation.
|
|
|
|
Enabling
|
|
--------
|
|
|
|
The *localpool* module is enabled with::
|
|
|
|
ceph mgr module enable localpool
|
|
|
|
Configuring
|
|
-----------
|
|
|
|
The *localpool* module understands the following options:
|
|
|
|
* **subtree** (default: `rack`): which CRUSH subtree type the module
|
|
should create a pool for.
|
|
* **failure_domain** (default: `host`): what failure domain we should
|
|
separate data replicas across.
|
|
* **pg_num** (default: `128`): number of PGs to create for each pool
|
|
* **num_rep** (default: `3`): number of replicas for each pool.
|
|
(Currently, pools are always replicated.)
|
|
* **min_size** (default: none): value to set min_size to (unchanged from Ceph's default if this option is not set)
|
|
* **prefix** (default: `by-$subtreetype-`): prefix for the pool name.
|
|
|
|
These options are set via the config-key interface. For example, to
|
|
change the replication level to 2x with only 64 PGs, ::
|
|
|
|
ceph config set mgr mgr/localpool/num_rep 2
|
|
ceph config set mgr mgr/localpool/pg_num 64
|