From bb3b832024857a67a7447119d54178adfa384b4a Mon Sep 17 00:00:00 2001 From: Alex Auvolat Date: Fri, 11 Jul 2025 13:27:17 +0200 Subject: [PATCH 1/2] doc: fix scrub tranquility command --- doc/book/operations/durability-repairs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/book/operations/durability-repairs.md b/doc/book/operations/durability-repairs.md index fdf163e2..8a307c84 100644 --- a/doc/book/operations/durability-repairs.md +++ b/doc/book/operations/durability-repairs.md @@ -42,7 +42,7 @@ You may pause an ongoing scrub using `garage repair scrub pause`, but note that the scrub will resume automatically 24 hours later as Garage will not let your cluster run without a regular scrub. If the scrub procedure is too intensive for your servers and is slowing down your workload, the recommended solution -is to increase the "scrub tranquility" using `garage repair scrub set-tranquility`. +is to increase the "scrub tranquility" using `garage worker set scrub-tranquility`. A higher tranquility value will make Garage take longer pauses between two block verifications. Of course, scrubbing the entire data store will also take longer. From 0a45317b3bc9fcbb177b1af5f4ea54b22b0a239b Mon Sep 17 00:00:00 2001 From: Alex Auvolat Date: Fri, 11 Jul 2025 13:30:03 +0200 Subject: [PATCH 2/2] doc: fix link to k2v spec --- doc/book/reference-manual/features.md | 2 +- doc/book/reference-manual/k2v.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/book/reference-manual/features.md b/doc/book/reference-manual/features.md index 481aef01..a74b1467 100644 --- a/doc/book/reference-manual/features.md +++ b/doc/book/reference-manual/features.md @@ -129,5 +129,5 @@ related to objects stored in an S3 bucket. In the context of our research project, [Aérogramme](https://aerogramme.deuxfleurs.fr), K2V is used to provide metadata and log storage for operations on encrypted e-mail storage. -Learn more on the specification of K2V [here](https://git.deuxfleurs.fr/Deuxfleurs/garage/src/branch/k2v/doc/drafts/k2v-spec.md) +Learn more on the specification of K2V [here](https://git.deuxfleurs.fr/Deuxfleurs/garage/src/commit/f8be15c37db857e177d543de7be863692628d567/doc/drafts/k2v-spec.md) and on how to enable it in Garage [here](@/documentation/reference-manual/k2v.md). diff --git a/doc/book/reference-manual/k2v.md b/doc/book/reference-manual/k2v.md index c01f641e..f8e003d9 100644 --- a/doc/book/reference-manual/k2v.md +++ b/doc/book/reference-manual/k2v.md @@ -16,7 +16,7 @@ the `k2v` feature flag enabled can be obtained from our download page under with `-k2v` (example: `v0.7.2-k2v`). The specification of the K2V API can be found -[here](https://git.deuxfleurs.fr/Deuxfleurs/garage/src/branch/main/doc/drafts/k2v-spec.md). +[here](https://git.deuxfleurs.fr/Deuxfleurs/garage/src/commit/f8be15c37db857e177d543de7be863692628d567/doc/drafts/k2v-spec.md). This document also includes a high-level overview of K2V's design. The K2V API uses AWSv4 signatures for authentification, same as the S3 API.