下载并解压迁移Agent。

1. 下载Agent。

   • 在源服务器中下载
     登录待迁移的源服务器，执行如下命令，通过公网下载Agent。

     wget https://smc-beijing.tos-cn-beijing.volces.com/Volcanicengine_Migration_Tool.zip
     

   • 本地上传Agent
     1. 在任意连通公网的服务器中，访问迁移Agent下载地址。
     2. 通过FTP等工具，将Agent上传至待迁移的源服务器。操作详情可参考本地数据上传。

2. 登录待迁移的源服务器，并使用如下命令解压迁移Agent。

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

      cd /root/download/
      

   说明

   请将/root/download/替换为实际路径。

   2. 执行如下命令解压Agent压缩文件。

      unzip Volcanicengine_Migration_Tool.zip
      

      解压后将获得如下文件。

      文件名	说明
      Linux_Version.tar.gz	Linux操作系统使用到迁移工具压缩包。
      Windows_Version.zip	Windows操作系统使用到迁移工具压缩包。

   3. 执行如下命令，解压Linux版本迁移工具。

      tar -xzvf Linux_Version.tar.gz
      

      解压后将获得如下文件。

      文件名	说明
      Linux-version	当前压缩包版本信息。
      smc-agent_Linux_amd64_1.0.tar.gz	迁移Agent压缩包，包含迁移工具与配置文件等内容。 说明 此处Agent压缩包名称仅做参考，请以实际解压结果为准。

   4. 执行如下命令，解压迁移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前，您可以排除无需迁移的文件或目录。

1. 执行如下命令，编辑excludes.txt文件

   vim excludes.txt
   

2. 按i键，写入无需迁移的文件或目录路径。

   说明

   • 需填写文件相对于其所在目录挂载点的相对路径，例如：路径为/etc/test.txt的文件，路径填写为test.txt。
   • 仅可修改您自行写入的内容，请勿修改文件原始内容。
3. 按ESC键退出编辑，输入:wq并按回车键，保存并退出文件。

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

1. 执行如下命令，编辑user_cfg.json文件

   vim user_cfg.json
   

2. 按i键，更新projectName参数的参数值为目标项目名称。

   说明

   默认为default项目。

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

执行如下命令，运行迁移工具Agent。

cd <Agent所在目录>
./smc_manage  start

输入火山引擎访问密钥（Access Key）包含的Access Key ID和Secret Access Key，并按Enter键确认。

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

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

   vim user_cfg.json
   

2. 按i键进入编辑模式。
3. 删除文件中已有ak与sk参数值，填入新的Access Key ID和Secret Access Key。
   
4. 按ESC键，输入:wq并按回车键，保存并退出文件。
5. 执行如下命令，再次启动Agent。

   ./smc_manage  start
   

   注意

   Agent运行后，将在smc_tools目录下生成临时密钥对id_rsa（临时私钥）、id_rsa.pub（临时公钥）。

   • 目标实例或中转实例将在迁移过程中使用该临时密钥对，减少您自有密钥泄露风险，保证您的密钥安全。
   • 请勿删除该密钥对，否则将导致迁移失败。
   • 若由于误删密钥对导致迁移失败，请执行如下命令再次运行Agent，重新导入迁移源并生成临时密钥对。

     ./smc_agent stop
     ./smc_agent start
     

     • 成功迁移后，请使用源服务器登录凭证（密码或密钥对）登录目标实例或自定义镜像。

运行成功后，迁移Agent将开始向SMC上传迁移源信息。

您可以在运行Agent的目录下，执行tail -f smc.log命令，查看SourceId(迁移源ID)及Agent运行日志，排查迁移问题。