test/milvus
1
0
Fork 0
mirror of https://gitee.com/milvus-io/milvus.git synced 2024-12-02 03:48:37 +08:00
Code Issues Actions 12 Packages Projects Releases Wiki Activity
336809e180
milvus/deployments/migrate-meta
History
Yiyun Ni 336809e180
Refine meta migration guide (#19964) 
Signed-off-by: YiyunNi <yiyun.ni@zilliz.com>

Signed-off-by: YiyunNi <yiyun.ni@zilliz.com>
2022-10-26 08:23:34 +08:00
..
migrate.sh Fix -d flag for meta migration script (#19975) 2022-10-21 15:55:28 +08:00
README.md Refine meta migration guide (#19964) 2022-10-26 08:23:34 +08:00

README.md

README

Overview

Milvus 2.2 has changed the meta structure for segment index. To upgrade a Milvus cluster of 2.1.x version you have installed, run this script to migrate the meta and upgrade the Milvus image version.

Note:

  1. This script only applies to Milvus installed on a K8s cluster.
  2. This script only supports upgrading from Milvus v2.1.x to v2.2.0.

Parameters

Parameters Description Default value Required
i The Milvus instance name. None True
n The namespace that Milvus is installed in. default False
s The source Milvus version. None True
t The target Milvus version. None True
r The root path of Milvus meta. by-dev False
w The new Milvus image tag. milvusdb/milvus:v2.2.0 False
o The meta migration operation. migrate False
d Whether to delete migration pod after the migration is completed. false False

By default, the script only applies to migration from v2.1.x to v2.2.x. Rollback to the older version with the rollback operation first if an error occurs.

Overview of migration procedures

  1. Stop the Milvus components. Any live session in the Milvus Etcd can cause the migration to fail.
  2. Create a backup for Milvus meta.
  3. Migrate the Milvus meta.
  4. Start Milvus components with a new image.

Migration guide

  1. Specify Milvus instance name, source Milvus version, and target Milvus version.
./migrate.sh -i my-release -s 2.1.1 -t 2.2.0
  1. Specify namespace with -n if your Milvus is not installed in the default K8s namespace.
./migrate.sh -i my-release -n milvus -s 2.1.1 -t 2.2.0
  1. Specify rootpath with -r if your Milvus is installed with the custom rootpath.
./migrate.sh -i my-release -n milvus -s 2.1.1 -t 2.2.0 -r by-dev
  1. Specify the image tag with -w if your Milvus is installed with custom image.
./migrate.sh -i my-release -n milvus -s 2.1.1 -t 2.2.0 -r by-dev -w milvusdb/milvus:master-20221016-15878781
  1. Set -d true if you want to automatically remove the migration pod after the migration is completed.
./migrate.sh -i my-release -n milvus -s 2.1.1 -t 2.2.0 -w milvusdb/milvus:master-20221016-15878781 -d true
  1. Rollback and migrate again if the migration fails.
./migrate.sh -i my-release -n milvus -s 2.1.1 -t 2.2.0 -r by-dev -o rollback -w <milvus-2-1-1-image>
./migrate.sh -i my-release -n milvus -s 2.1.1 -t 2.2.0 -r by-dev -o migrate -w <milvus-2-2-0-image>