From 2448eb771381318c5dd9f5516c606685156a3040 Mon Sep 17 00:00:00 2001 From: Alex Auvolat Date: Thu, 5 Oct 2023 15:29:55 +0200 Subject: [PATCH] upgrade doc: fixes and precisions --- doc/book/working-documents/migration-09.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/doc/book/working-documents/migration-09.md b/doc/book/working-documents/migration-09.md index b277bb9b..8d403580 100644 --- a/doc/book/working-documents/migration-09.md +++ b/doc/book/working-documents/migration-09.md @@ -25,7 +25,7 @@ The following are **breaking changes** in Garage v0.9 that require your attentio The migration steps are as follows: 1. Disable API and web access. You may do this by stopping your reverse proxy or by commenting out - the `api_bind_addr` values in your `config.toml` file. + the `api_bind_addr` values in your `config.toml` file and restarting Garage. 2. Do `garage repair --all-nodes --yes tables` and `garage repair --all-nodes --yes blocks`, check the logs and check that all data seems to be synced correctly between nodes. If you have time, do additional checks (`versions`, `block_refs`, etc.) @@ -62,7 +62,8 @@ The migration steps are as follows: 3. Prepare your binaries and configuration files for Garage v0.9 -4. Shut down all v087 nodes simultaneously, and restart them all simultaneously in v0.9. +4. Shut down all v0.8 nodes simultaneously, and restart them all simultaneously in v0.9. Use your favorite deployment tool (Ansible, Kubernetes, Nomad) to achieve this as fast as possible. + Garage v0.9 should be in a working state as soon as it starts. -5. Proceed with steps 9-12 above. +5. Proceed with repair and monitoring as described in steps 9-12 above.