From 6a067e30ee51d3ea9874e3ce18670c39edfd665b Mon Sep 17 00:00:00 2001 From: Alex Auvolat Date: Thu, 7 Sep 2023 13:49:12 +0200 Subject: doc: documentation of rebalance repair --- doc/book/operations/durability-repairs.md | 10 ++++++++++ 1 file changed, 10 insertions(+) (limited to 'doc/book/operations/durability-repairs.md') diff --git a/doc/book/operations/durability-repairs.md b/doc/book/operations/durability-repairs.md index 498c8fda..33130952 100644 --- a/doc/book/operations/durability-repairs.md +++ b/doc/book/operations/durability-repairs.md @@ -91,6 +91,16 @@ is definitely lost, then there is no other choice than to declare your S3 object as unrecoverable, and to delete them properly from the data store. This can be done using the `garage block purge` command. +## Rebalancing data directories + +In [multi-HDD setups](@/documentation/operations/multi-hdd.md), to ensure that +data blocks are well balanced between storage locations, you may run a +rebalance operation using `garage repair rebalance`. This is usefull when +adding storage locations or when capacities of the storage locations have been +changed. Once this is finished, Garage will know for each block of a single +possible location where it can be, which can increase access speed. This +operation will also move out all data from locations marked as read-only. + # Metadata operations -- cgit v1.2.3 From eb972a8422e19e1eaf69281571f4e52f9c7794ff Mon Sep 17 00:00:00 2001 From: Alex Auvolat Date: Thu, 7 Sep 2023 14:48:36 +0200 Subject: doc: update multi-hdd section --- doc/book/operations/durability-repairs.md | 1 - 1 file changed, 1 deletion(-) (limited to 'doc/book/operations/durability-repairs.md') diff --git a/doc/book/operations/durability-repairs.md b/doc/book/operations/durability-repairs.md index 33130952..b0d2c78a 100644 --- a/doc/book/operations/durability-repairs.md +++ b/doc/book/operations/durability-repairs.md @@ -124,4 +124,3 @@ in your cluster, you can run one of the following repair procedures: - `garage repair versions`: checks that all versions belong to a non-deleted object, and purges any orphan version - `garage repair block_refs`: checks that all block references belong to a non-deleted object version, and purges any orphan block reference (this will then allow the blocks to be garbage-collected) - -- cgit v1.2.3