summaryrefslogtreecommitdiffstats
path: root/doc/mgr/localpool.rst
blob: 2812925caf30214f39067524c37f673ee474eb31 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
Local Pool Module
=================

.. mgr_module:: localpool

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:

.. confval:: subtree
.. confval:: failure_domain
.. confval:: pg_num
.. confval:: num_rep
.. confval:: min_size
.. confval:: prefix
   :default: by-$subtreetype-

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

.. mgr_module:: None