Guides

对象存储迁移

在对象存储切换时规划配置、数据迁移和访问验证。

获取最新代码

请下载项目的最新代码版本：

最新代码已集成S3迁移工具，无需单独操作。

git clone https://github.com/openimsdk/open-im-server.git
cd open-im-server

配置文件修改指南

请根据需要修改config目录下的相关配置文件，以完成迁移相关的 S3 配置：

编辑openim-rpc-third.yml配置文件
定位并更新与 S3 相关的配置项，确保其符合你的实际迁移需求。
关于 minio.yml 配置文件
如果项目中未实际使用 MinIO，该文件可以忽略。
如需使用，请同样根据迁移需求更新 S3 配置相关项。
openim-rpc-third.yml中都有object.enable字段，用于指定新的 S3 存储引擎。

编译 S3 迁移工具

进入工具目录

cd tools/s3

执行编译命令

go build -o s3convert main.go

开始迁移

为确保数据迁移过程的稳定性，请按照以下建议进行操作：

准备工作
关闭服务：建议在服务停止的状态下进行迁移操作，以避免数据不一致或操作冲突。
备份 MongoDB：重点备份s3表的数据，以便在发生意外时快速恢复。
迁移说明
迁移工具不会删除原有的S3数据，但会修改MongoDB中s3表的相关记录。
请在迁移完成后，核对数据完整性，确保所有迁移步骤正确执行。
执行迁移命令
<config dir path>：指定配置文件目录路径。
<old s3 name>：填写原 S3 配置名称，例如 minio。

./s3convert -config <config dir path> -name <old s3 name>

示例命令

如配置文件位于 config 目录下，且原 S3 名称为 minio，可执行以下命令：

./s3convert -config ./../../config -name minio

当看到输出信息success时，表示迁移操作已完成。