文档中心

服务器迁移中心

用户指南

管理迁移工具Agent

安装迁移工具Agent后，您可以管理Agent运行状态、修改其配置文件。

说明

若您于2025年06月30日前安装了迁移工具Agent，建议您修改Agent配置文件user_cfg.json中host参数值为smc.volcengineapi.com，或下载安装新版本迁移工具Agent。

前提条件

已完成迁移工具Agent安装，详情可查看导入迁移源。

操作步骤

配置代理服务器信息

迁移工具Agent需要通过公网传输迁移命令。因此，使用“内网传输”模式迁移数据时，您也需要确保源服务器可以通过公网连接至火山引擎。

Linux操作系统

Windows操作系统

登录安装迁移Agent的服务器。

在迁移源中执行如下命令，验证迁移源能否通过公网连接至SMC。

ping smc.volcengineapi.com

若连接成功，表示您无需配置代理服务器。

若链接失败，请检查迁移源公网配置，或根据如下步骤配置代理服务器，通过代理方式进行连接。

配置代理服务器，操作详情可参考配置代理服务器。

执行如下命令，停止Agent运行。

sudo ./smc_manage stop

执行如下命令，打开工具用户信息配置文件。

vim user_cfg.json

按i键进入编辑模式。

在文件中添加代理服务器信息。

ip_port：必填，代理服务器内网ip地址:端口，表示允许源端服务器通过代理服务器的端口访问SMC服务。

user_pwd：可选（若代理服务器需要密码则必填），登录代理服务器的用户名:密码。

"proxy": {
"ip_port": "xx.xx.xx.xx:xx",
"user_pwd": "xxxx:xxxx"
}

按ESC键，输入:wq并按回车键，保存并退出文件。

完成修改后，即可执行如下命令启动Agent导入迁移源信息。

sudo ./smc_manage start

排除无需迁移文件或目录

您可以在Agent配置文件中填写无需迁移至平台的文件或目录路径，SMC将不会迁移配置路径对应的文件或目录。

说明

源服务器操作系统为Windows时，暂不支持使用本功能。

登录安装迁移Agent的服务器。

执行如下命令，进入迁移工具Agent所在目录。

执行如下命令，停止Agent运行。

sudo ./smc_manage stop

执行如下命令，打开excludes.txt文件。

vim excludes.txt

说明

需填写文件/目录相对于其所属目录挂载点的相对路径，例如：排除路径为/etc/test.txt的文件时，路径可填写为test.txt。

excludes.txt文件中，仅可修改您自行写入的内容，请勿修改文件原始内容。

按ESC键退出编辑，输入:wq按回车键，保存并退出文件。

完成修改后，即可执行如下命令启动Agent导入迁移源信息。

sudo ./smc_manage start

修改Access Key（密钥）

如果您输入的Access Key ID和Secret Access Key不正确或需要更换密钥配置，请按如下步骤完成操作。

说明

源服务器操作系统Windows时，暂不支持使用本功能。

登录安装迁移Agent的服务器。

执行如下命令，进入迁移工具Agent所在目录。

执行如下命令，停止Agent运行。

sudo ./smc_manage stop

执行如下命令，打开用户信息配置文件。

vim user_cfg.json

按i键进入编辑模式。

删除文件中已有ak与sk参数值，填入新的Access Key ID和Secret Access Key。平台Access Key（API访问密钥）获取操作，可查看获取 Access Key。

按ESC键退出编辑，输入:wq按回车键，保存并退出文件。

完成修改后，即可执行如下命令启动Agent导入迁移源信息。

sudo ./smc_manage start

指定迁移源所属项目

您可以指定导入的迁移源归属于某个项目，方便管理。更多项目详情，可查看项目管理。

Linux操作系统

Windows操作系统

登录安装迁移Agent的服务器。

执行如下命令，停止Agent运行。

sudo ./smc_manage stop

执行如下命令，打开工具用户信息配置文件。

vim user_cfg.json

按i键进入编辑模式。

在文件中更新projectName参数的参数值为目标项目名称。

按ESC键，输入:wq并按回车键，保存并退出文件。

完成修改后，即可执行如下命令启动Agent导入迁移源信息。

sudo ./smc_manage start

最近更新时间：2025.06.27 11:40:04

这个页面对您有帮助吗？

有用

无用