From 1c9c8c8149b40c65f98f49be7b593fe5eb8817f9 Mon Sep 17 00:00:00 2001 From: rustmailer Date: Fri, 22 May 2026 15:00:52 +0800 Subject: [PATCH] =?UTF-8?q?Updated=20Bichon=20Data=20Migration:=20v0.3.7?= =?UTF-8?q?=20=E2=86=92=20v1.0=20(markdown)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Bichon-Data-Migration:-v0.3.7-→-v1.0.md | 26 +++++++++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/Bichon-Data-Migration:-v0.3.7-→-v1.0.md b/Bichon-Data-Migration:-v0.3.7-→-v1.0.md index f235539..ae36881 100644 --- a/Bichon-Data-Migration:-v0.3.7-→-v1.0.md +++ b/Bichon-Data-Migration:-v0.3.7-→-v1.0.md @@ -38,6 +38,32 @@ If `--bichon-index-dir` or `--bichon-data-dir` were customized, `bichon-indices/ --- +## Before Starting the Migration + +Before running the migration tool: + +1. **Stop the existing v0.3.7 bichon server completely** + + * Ensure no bichon process is still running. + * Migration must not be performed while the old server is actively writing data. + +2. **Use the latest available v1.x.x release** + + * It is strongly recommended to use the latest `bichon` and `bichon-admin` versions, + as newer releases may include migration fixes, memory optimizations, or data + consistency improvements. + +3. Run the migration using `bichon-admin`. + +4. After the migration finishes successfully: + + * Start the new v1.x.x bichon server. + * It is recommended to keep the legacy data for a few days after migration. Only remove the old data once the new server has been running stably and the migration has been fully validated. + +> **Warning:** Do not start the v1.x.x server before migration has completed successfully. + + + ## Running the Migration Run `bichon-admin` and select: