ceph/doc/dev
Laura Flores e2ce8ed1ff mgr: add read balancer support inside the balancer module
Read balancing may now be managed automatically via the balancer
manager module. Users may choose between two new modes: ``upmap-read``, which
offers upmap and read optimization simultaneously, or ``read``, which may be used
to only optimize reads. Existing balancer commands have also been added to
contain more information about read balancing.

Run the following commands to test the new automatic behavior:
`ceph balancer on` (on by default)
`ceph balancer mode <read|upmap-read>`
`ceph balancer status`

Run the following commands to test the new supervised behavior:
`ceph balancer off`
`ceph balancer mode <read|upmap-read>`
`ceph balancer eval` | `ceph balancer eval <pool-name>`
`ceph balancer eval-verbose` | `ceph balancer eval-verbose <pool-name>`
`ceph balancer optimize <plan-name>`
`ceph balancer show <plan-name>`
`ceph balancer eval <plan-name>`
`ceph balancer execute <plan-name>`

In the balancer module, there is also a new "self_test" function which tests
the module's basic functionality. This test can be triggered with the following
commands:
`ceph mgr module enable selftest`
`ceph mgr self-test module balancer`

Related Trello: https://trello.com/c/sWoKctzL/859-add-read-balancer-support-inside-the-balancer-module
Signed-off-by: Laura Flores <lflores@ibm.com>
2024-01-28 13:15:38 -06:00
..
ceph-volume
cephadm doc/dev/cephadm: describe advanced build options 2023-11-06 13:38:23 -05:00
crimson doc/dev/crimson: Improve crimson.rst 2023-05-22 05:08:44 -04:00
dashboard
developer_guide doc/dev/developer_guide: mention unit_test_summary.yaml & valgrind.yaml 2023-10-31 17:07:49 +05:30
mds_internals doc: Fix many spelling errors 2022-07-02 23:38:18 -04:00
osd_internals Merge pull request #52545 from Matan-B/wip-matanb-trim-61962 2023-11-01 12:09:44 -07:00
radosgw doc/dev/radosgw: describe the bucket index 2022-09-29 15:33:16 -04:00
balancer-design.rst mgr: add read balancer support inside the balancer module 2024-01-28 13:15:38 -06:00
blkin.rst doc: Fix many spelling errors 2022-07-02 23:38:18 -04:00
bluestore.rst
ceph_krb_auth.rst doc/dev: use underscores in config vars 2023-01-27 15:41:04 +07:00
cephfs-mirroring.rst doc/dev: Fix typos in files cephfs-mirroring.rst and deduplication.rst 2023-09-19 00:39:40 +02:00
cephfs-reclaim.rst
cephfs-snapshots.rst Merge pull request #47753 from mchangir/mon-disable-snap-id-allocation-for-fsmap-pools 2023-01-30 16:35:04 +05:30
cephx_protocol.rst doc: Fix many spelling errors 2022-07-02 23:38:18 -04:00
cephx.rst doc/dev/cephx: fix typo 2021-09-27 13:37:31 +01:00
config-key.rst
config.rst doc/dev/config: Replace invalid config debug-pg 2021-09-28 06:30:07 +01:00
context.rst
continuous-integration.rst doc/dev: Elaborate on boost .deb creation 2022-07-20 17:08:40 -04:00
corpus.rst cmake: add --progress flag to git submodule update commands 2023-10-31 23:14:49 +05:30
cpu-profiler.rst
cxx.rst
deduplication.rst doc/dev: Fix typos in files cephfs-mirroring.rst and deduplication.rst 2023-09-19 00:39:40 +02:00
delayed-delete.rst doc/dev: edit delayed-delete.rst 2022-07-11 01:33:51 +10:00
dev_cluster_deployment.rst doc/dev: fix "deploying dev cluster" link 2023-06-13 21:51:26 +10:00
development-workflow.rst
documenting.rst doc/dev: link to Dot User's Manual 2022-11-17 15:35:58 +10:00
dpdk.rst doc/dpdk: reword the root access part 2022-03-27 01:00:21 +08:00
encoding.rst doc: improve doc/dev/encoding.rst 2023-06-07 16:15:38 +02:00
erasure-coded-pool.rst
file-striping.rst
freebsd.rst
generatedocs.rst
health-reports.rst doc/dev: remove seqdiag assets 2023-07-05 03:37:10 +10:00
iana.rst
internals.rst
kubernetes.rst
libs.rst
logging.rst
logs.rst
macos.rst
mempool_accounting.rst doc/dev: improve wording and grammar of mempool page 2022-06-27 12:10:26 -05:00
messenger.rst
mon-bootstrap.rst doc/dev/mon-bootstrap: fix typo 2021-09-29 07:13:56 +01:00
mon-elections.rst doc/rados: edit t-mon "common issues" (3 of x) 2023-11-09 20:20:20 +10:00
mon-on-disk-formats.rst doc,man: typos found by codespell 2021-12-15 12:04:36 +01:00
mon-osdmap-prune.rst
msgr2.rst doc: Fix many spelling errors 2022-07-02 23:38:18 -04:00
network-encoding.rst doc/dev/encoding.txt: update per std::optional 2023-05-08 14:41:22 +00:00
network-protocol.rst doc: Fix many spelling errors 2022-07-02 23:38:18 -04:00
object-store.rst docs: warning and remove few docs section for Filestore 2023-04-20 05:01:53 +00:00
osd-class-path.rst
peering.rst doc/dev: add section on using the gen_state_diagram.py script 2022-02-10 09:12:05 -06:00
perf_counters.rst rgw: misc labeled op counters work 2023-10-12 15:46:08 -04:00
perf_histograms.rst doc: Fix many spelling errors 2022-07-02 23:38:18 -04:00
perf.rst
placement-group.rst
PlanningImplementation.txt
quick_guide.rst doc: Fix many spelling errors 2022-07-02 23:38:18 -04:00
rados-client-protocol.rst
rbd-diff.rst
rbd-export.rst
rbd-layering.rst
release-checklists.rst Merge pull request #55067 from yaarith/telemetry-pool-flags 2024-01-23 12:22:32 -06:00
release-process.rst docs: revised Distro Codemap, removed octopus, added reef 2023-10-25 15:05:56 -07:00
seastore.rst doc,man: typos found by codespell 2021-12-15 12:04:36 +01:00
sepia.rst
session_authentication.rst
testing.rst doc/dev: should be ./run-make-check.sh 2021-06-14 11:23:54 -05:00
versions.rst
vstart-ganesha.rst doc/dev/vstart-ganesha: update about RGW export 2021-08-06 19:12:57 +05:30
wireshark.rst
zoned-storage.rst doc: Fix many spelling errors 2022-07-02 23:38:18 -04:00