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: