summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorMatthew Oliver <matt@oliver.net.au>2022-02-10 13:42:48 +1100
committerMatthew Oliver <matt@oliver.net.au>2022-07-21 13:35:24 +1000
commitbf4edefce4990a9c8c3f6a92696af37d840d2008 (patch)
treef9ebacd4cfb350dab7836a3c7a76bb6e0906ac85 /doc
parent57f17ace7c911b80587a03634346478b6ca432e8 (diff)
downloadswift-bf4edefce4990a9c8c3f6a92696af37d840d2008.tar.gz
DB Replicator: Add handoff_delete option
Currently the object-replicator has an option called `handoff_delete` which allows us to define the the number of replicas which are ensured in swift. Once a handoff node ensures that many successful responses it can go ahead and delete the handoff partition. By default it's 'auto' or rather the number of primary nodes. But this can be reduced. It's useful in draining full disks, but has to be used carefully. This patch adds the same option to the DB replicator and works the same way. But instead of deleting a partition it's done at the per DB level. Because it's done in the DB Replicator level it means the option is now available to both the Account and Container replicators. Change-Id: Ide739a6d805bda20071c7977f5083574a5345a33
Diffstat (limited to 'doc')
-rw-r--r--doc/source/config/account_server_config.rst25
-rw-r--r--doc/source/config/container_server_config.rst25
2 files changed, 44 insertions, 6 deletions
diff --git a/doc/source/config/account_server_config.rst b/doc/source/config/account_server_config.rst
index 241c3e9d6..f305c021b 100644
--- a/doc/source/config/account_server_config.rst
+++ b/doc/source/config/account_server_config.rst
@@ -170,9 +170,9 @@ ionice_priority None I/O scheduling priority of server
[account-replicator]
********************
-==================== ========================= ===============================
+==================== ========================= =====================================
Option Default Description
--------------------- ------------------------- -------------------------------
+-------------------- ------------------------- -------------------------------------
log_name account-replicator Label used when logging
log_facility LOG_LOCAL0 Syslog log facility
log_level INFO Logging level
@@ -256,7 +256,26 @@ ionice_priority None I/O scheduling priority of serve
Work only with ionice_class.
Ignored if IOPRIO_CLASS_IDLE
is set.
-==================== ========================= ===============================
+handoffs_only no When handoffs_only mode is enabled
+ the replicator will *only* replicate
+ from handoff nodes to primary nodes
+ and will not sync primary nodes
+ with other primary nodes.
+handoff_delete auto the number of replicas which are
+ ensured in swift. If the number
+ less than the number of replicas
+ is set, account-replicator
+ could delete local handoffs even
+ if all replicas are not ensured in
+ the cluster. The replicator would
+ remove local handoff account database
+ after syncing when the number of
+ successful responses is greater than
+ or equal to this number. By default
+ handoff partitions will be removed
+ when it has successfully replicated
+ to all the canonical nodes.
+==================== ========================= =====================================
*****************
[account-auditor]
diff --git a/doc/source/config/container_server_config.rst b/doc/source/config/container_server_config.rst
index 7961f50e8..6f7d6031a 100644
--- a/doc/source/config/container_server_config.rst
+++ b/doc/source/config/container_server_config.rst
@@ -175,9 +175,9 @@ ionice_priority None I/O scheduling priority of ser
[container-replicator]
**********************
-==================== =========================== =============================
+==================== =========================== =======================================
Option Default Description
--------------------- --------------------------- -----------------------------
+-------------------- --------------------------- ---------------------------------------
log_name container-replicator Label used when logging
log_facility LOG_LOCAL0 Syslog log facility
log_level INFO Logging level
@@ -266,7 +266,26 @@ ionice_priority None I/O scheduling priority of
Work only with ionice_class.
Ignored if IOPRIO_CLASS_IDLE
is set.
-==================== =========================== =============================
+handoffs_only no When handoffs_only mode is enabled
+ the replicator will *only* replicate
+ from handoff nodes to primary nodes
+ and will not sync primary nodes
+ with other primary nodes.
+handoff_delete auto the number of replicas which are
+ ensured in swift. If the number
+ less than the number of replicas
+ is set, container-replicator
+ could delete local handoffs even
+ if all replicas are not ensured in
+ the cluster. The replicator would
+ remove local handoff container database
+ after syncing when the number of
+ successful responses is greater than
+ or equal to this number. By default
+ handoff partitions will be removed
+ when it has successfully replicated
+ to all the canonical nodes.
+==================== =========================== =======================================
*******************
[container-sharder]