本文介绍安装迁移工具Agent并导入迁移源的操作步骤。
注意
- 本文仅适用于2024年07月01日前下载、安装的迁移工具Agent。
- 建议您下载、安装最新版迁移工具Agent,操作详情可查看导入迁移源。
前提条件
请确认您已经按照要求完成前置准备。详情可查看准备工作。
操作步骤
您需要在迁移源中安装迁移工具Agent,Agent可以收集迁移源信息并导入火山引擎。
下载并解压迁移Agent。
下载Agent。
登录待迁移的源服务器,并使用如下命令解压迁移Agent。
- 执行如下命令,进入迁移Agent所在目录。
cd /root/download/
说明
请将/root/download/
替换为实际路径。
执行如下命令解压Agent压缩文件。
unzip Volcanicengine_Migration_Tool.zip
解压后将获得如下文件。
文件名 | 说明 |
---|
Linux_Version.tar.gz | Linux操作系统使用到迁移工具压缩包。 |
Windows_Version.zip | Windows操作系统使用到迁移工具压缩包。 |
执行如下命令,解压Linux版本迁移工具。
tar -xzvf Linux_Version.tar.gz
解压后将获得如下文件。
文件名 | 说明 |
---|
Linux-version | 当前压缩包版本信息。 |
smc-agent_Linux_amd64_1.0.tar.gz | 迁移Agent压缩包,包含迁移工具与配置文件等内容。 说明 此处Agent压缩包名称仅做参考,请以实际解压结果为准。 |
执行如下命令,解压迁移Agent压缩包。
tar -xzvf smc-agent_Linux_amd64_*.tar.gz
解压后将获得如下文件。
文件名 | 说明 |
---|
smc_agent | 二进制文件,迁移工具主要文件。 |
smc_manage | 二进制文件,迁移管理工具。 |
agent_cfg.json | JSON文件,用于记录迁移过程信息。 |
excludes.txt | txt文件,不迁移的文件和目录路径需要写入此文件。 |
user_cfg.json | JSON文件,用户信息配置文件。 |
smc_tools | 文件夹,包含迁移过程中SMC使用到的临时密钥对、块复制、检测脚本等工具。 |
(可选) 运行迁移Agent前,您可以排除无需迁移的文件或目录。
- 执行如下命令,编辑excludes.txt文件
vim excludes.txt
- 按
i
键,写入无需迁移的文件或目录路径。说明
- 需填写文件相对于其所在目录挂载点的相对路径,例如:路径为/etc/test.txt的文件,路径填写为test.txt。
- 仅可修改您自行写入的内容,请勿修改文件原始内容。
- 按
ESC
键退出编辑,输入:wq
并按回车键,保存并退出文件。
(可选) 您可以指定导入的迁移源归属于某个项目,方便管理。更多项目详情,可查看项目管理。
- 执行如下命令,编辑user_cfg.json文件
vim user_cfg.json
- 按
i
键,更新projectName
参数的参数值为目标项目名称。![](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_f9f7382c337bb08a9aa9d4c651624d6b.png)
- 按
ESC
键退出编辑,输入:wq
并按回车键,保存并退出文件。
执行如下命令,运行迁移工具Agent。
cd <Agent所在目录>
./smc_manage start
说明
- 您需要使用root权限运行迁移工具Agent。
- 请将
<Agent所在目录>
替换为实际路径。
输入火山引擎访问密钥(Access Key)包含的Access Key ID和Secret Access Key,并按Enter
键确认。
![](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_0b1a6a4e13f069ab276848dfcd836bbb.png)
(可选) 如果您输入的Access Key ID和Secret Access Key不正确或需要更换密钥配置,请按如下步骤完成操作。
- 执行如下命令,打开工具用户信息配置文件。
vim user_cfg.json
- 按
i
键进入编辑模式。 - 删除文件中已有
ak
与sk
参数值,填入新的Access Key ID和Secret Access Key。
![](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_6449fb83d9c8dab50458add1b6f55984.png)
- 按
ESC
键,输入:wq
并按回车键,保存并退出文件。 - 执行如下命令,再次启动Agent。
./smc_manage start
注意
Agent运行后,将在smc_tools目录下生成临时密钥对id_rsa
(临时私钥)、id_rsa.pub
(临时公钥)。
运行成功后,迁移Agent将开始向SMC上传迁移源信息。
说明
完成导入前请勿关闭迁移工具客户端,否则迁移源将与SMC控制台失去联系,无法完成导入。
您可以在运行Agent的目录下,执行tail -f smc.log
命令,查看SourceId
(迁移源ID)及Agent运行日志,排查迁移问题。
![](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_df9429bbbc1febdf09212eadd13758cc.png)
说明
由于Windows操作系统仅支持“块复制”方式迁移数据,因此不支持排除无需迁移的文件或目录。
下载并解压迁移Agent。
- 下载Agent。
- 通过PowerShell下载Agent
登录待迁移的源服务器。
在PowerShell中执行如下命令,下载Agent。
请将<下载文件存储路径>
替换为实际路径。
Start-BitsTransfer -Source "https://smc-beijing.tos-cn-beijing.volces.com/Volcanicengine_Migration_Tool.zip" -Destination "<下载文件存储路径>\Volcanicengine_Migration_Tool.zip"
当传输进度完结且界面自动关闭后,即可前往您指定的存储位置解压使用Agent。
![](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_c9c31ac22fed1a6091e3ddce28668b24.png)
- 本地上传Agent
- 在任意连通公网的服务器中,访问迁移Agent下载地址。
- 通过FTP等工具,将Agent上传至待迁移的源服务器。操作详情可参考本地数据上传。
- 右键单击Volcanicengine_Migration_Tool.zip文件,单击“全部解压缩”按钮并在弹窗中单击“提取”按钮,解压后将得到如下文件。
文件名 | 说明 |
---|
Linux_Version.tar.gz | Linux操作系统使用到迁移工具压缩包。 |
Windows_Version.zip | Windows操作系统使用到迁移工具压缩包。 |
- 右键单击Windows_Version.zip文件,单击“全部解压缩”按钮并在弹窗中单击“提取”按钮,解压后将得到如下文件。
文件名 | 说明 |
---|
Windows-version.txt | 当前压缩包版本信息。 |
smc-agent_Windows_x86_64_1.0.zip | 迁移Agent压缩包,包含迁移工具与配置文件等内容。 说明 此处Agent压缩包名称仅做参考,请以实际解压结果为准。 |
- 右键单击smc-agent_Windows_x86_64_1.0.zip,单击“全部解压缩”按钮并在弹窗中单击“提取”按钮,解压后将得到如下文件。
文件名 | 说明 |
---|
smc_agent.exe | 应用程序文件,迁移工具主要文件。 |
agent_cfg.json | JSON文件,用于记录迁移过程信息。 |
user_cfg.json | JSON文件,用户信息配置文件。 |
bin | 文件夹,二进制文件存放目录。 |
sciter.dll | 迁移工具依赖的库文件。 |
notice.txt | 迁移工具遵守的规范信息。 |
(可选) 您可以指定导入的迁移源归属于某个项目,方便管理。更多项目详情,可查看项目管理。
- 进入Agent所在文件夹。
- 右键单击user_cfg.json文件,单击“打开方式”按钮,选择“记事本”打开文件。
- 更新
projectName
参数的参数值为目标项目名称。
![](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_c02cf1d60bca220a8d97a3565a222d33.png)
- 保存修改并关闭文件。
您可以选择如下方式,运行迁移工具Agent。
注意
- 杀毒软件可能会禁止迁移工具运行,请检查其配置。
- 您需要以管理员(Administer)身份运行迁移工具。
- 开始运行后,Agent将自动生成smc.txt文件记录Agent运行日志,方便您排查迁移问题。
方式一:图形化界面运行。
进入Agent所在文件夹。
右键单击smc_agent.exe,单击“以管理员身份运行”按钮,运行迁移工具Agent。
![](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_800dcc8991962c228dd4e30b4ada858b.png)
输入火山引擎访问密钥(Access Key)包含的Access Key ID和Secret Access Key,并单击“运行”按钮启动迁移Agent。
获取访问密钥(Access Key)操作,可查看获取Access Key。
![](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_c95662685b1d656071d2cd5d58831b49.png)
方式二:通过命令运行。
在PowerShell对话框中,运行如下命令。
请将<Agent所在目录路径>
替换为实际路径。
cd <Agent所在目录路径>
.\smc_agent.exe -autostart=true -ak=xxx -sk=xxx
参数说明:
参数名 | 说明 | 取值样例 |
---|
autostart | 是否使用命令行启动Agent,固定为true 。 | true |
ak | 火山引擎访问密钥(Access Key)包含的Access Key ID,获取详情可查看Access Key(密钥)管理 | AKLTYmMyNj***jY1OTU |
sk | Access Key ID对应的Secret Access Key,获取详情可查看Access Key(密钥)管理。 | TlRWaU1XUXhNREk***pJell6Yw== |
系统将自动打开迁移Agent图形化界面,填入您在命令中传入的访问秘钥,并自动开始导入迁移源信息。
![](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_a3b84420fff584d6dc12c48795b877e8.png)
运行成功后,迁移Agent将开始向SMC上传迁移源信息。
说明
完成导入前请勿关闭迁移工具客户端,否则迁移源将与SMC控制台失去联系,无法完成导入。
您可以在运行Agent的目录下,查看Agent运行日志文件smc.txt,获取SourceId
(迁移源ID)及Agent运行日志,排查迁移问题。
![](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_5d4830ef91b93dcc30b00f1164ecf3ec.png)
后续操作
您可以前往云服务器控制台查看迁移源信息并创建迁移任务。操作详情可查看查看迁移源详情、创建迁移任务。