]> git.apps.os.sepia.ceph.com Git - ceph.git/commitdiff
doc/man: Add optional reweight-by-utilization args 37268/head
authorAnthony D'Atri <aad@Lovecraft.local>
Mon, 21 Sep 2020 00:37:58 +0000 (17:37 -0700)
committerAnthony D'Atri <aad@Lovecraft.local>
Mon, 21 Sep 2020 05:47:01 +0000 (22:47 -0700)
doc/mgr: Grammar and wording for Prometheus labels
doc/rados: Spelling and clarity

Signed-off-by: Anthony D'Atri <anthony.datri@gmail.com>
doc/man/8/ceph.rst
doc/mgr/prometheus.rst
doc/rados/configuration/bluestore-config-ref.rst
doc/rados/configuration/network-config-ref.rst

index 715e667dac1fa63c3bc3e45391979925e89e90bf..ec06fe356b0be2fef26e9fd56980e723789b1abf 100644 (file)
@@ -1193,12 +1193,14 @@ Usage::
        ceph osd reweight-by-pg {<int[100-]>} {<poolname> [<poolname...]}
        {--no-increasing}
 
-Subcommand ``reweight-by-utilization`` reweight OSDs by utilization
-[overload-percentage-for-consideration, default 120].
+Subcommand ``reweight-by-utilization`` reweights OSDs by utilization.  It only reweights
+outlier OSDs whose utilization exceeds the average, eg. the default 120%
+limits reweight to those OSDs that are more than 20% over the average.
+[overload-threshold, default 120 [max_weight_change, default 0.05 [max_osds_to_adjust, default 4]]] 
 
 Usage::
 
-       ceph osd reweight-by-utilization {<int[100-]>}
+       ceph osd reweight-by-utilization {<int[100-]> {<float[0.0-]> {<int[0-]>}}}
        {--no-increasing}
 
 Subcommand ``rm`` removes osd(s) <id> [<id>...] from the OSD map.
index 87296be391471de29032959bfabe51b88c9abdbb..6fcb292f98fa4ed10bc6d320e8bc4d525da7f09d 100644 (file)
@@ -241,8 +241,8 @@ Example configuration
 ---------------------
 
 This example shows a single node configuration running ceph-mgr and
-node_exporter on a server called ``senta04``. Note that this requires to add the
-appropriate instance label to every ``node_exporter`` target individually.
+node_exporter on a server called ``senta04``. Note that this requires one
+to add an appropriate and unique ``instance`` label to each ``node_exporter`` target.
 
 This is just an example: there are other ways to configure prometheus
 scrape targets and label rewrite rules.
index 027444616cd6fa6e8b9c347710c6bf420a2b13a0..96a95d571734b5fae0f27ef6477cbe69b4802404 100644 (file)
@@ -141,7 +141,7 @@ automatically manage these within the space of ``block``.
 Automatic Cache Sizing
 ======================
 
-Bluestore can be configured to automatically resize it's caches when TCMalloc
+Bluestore can be configured to automatically resize its caches when TCMalloc
 is configured as the memory allocator and the ``bluestore_cache_autotune``
 setting is enabled.  This option is currently enabled by default.  Bluestore
 will attempt to keep OSD heap memory usage under a designated target size via
index 80c6480a7e1994c551d3e69eb4412b86e5372a7f..efbd55b3194b4d955491a4ae7ddaed4fba409082 100644 (file)
@@ -17,7 +17,10 @@ improvement with a second "cluster" network in a large cluster.
 
 It is possible to run a Ceph Storage Cluster with two networks: a public
 (front-side) network and a cluster (back-side) network.  However, this approach
-complicates network configuration (both hardware and software) and does not usually have a significant impact on overall performance.  For this reason, we generally recommend that dual-NIC systems either be configured with two IPs on the same network, or bonded.
+complicates network configuration (both hardware and software) and does not usually
+have a significant impact on overall performance.  For this reason, we recommend
+that for resilience and capacity dual-NIC systems either active/active bond
+these interfaces or implemebnt a layer 3 multipath strategy with eg. FRR.
 
 If, despite the complexity, one still wishes to use two networks, each
 :term:`Ceph Node` will need to have more than one NIC. See `Hardware