You need to enable JavaScript to run this app.
导航

第一步:导入迁移源

最近更新时间2024.02.27 14:12:17

首次发布时间2022.11.10 11:19:22

使用SMC将迁移源迁移至火山引擎前,您需要先通过迁移工具Agent将迁移源信息导入并连接到您的火山引擎账号。
本文介绍安装迁移工具Agent并导入迁移源的操作步骤。

前提条件

请确认您已经按照要求完成前置准备。详情可查看准备工作

操作步骤

您需要在迁移源中安装迁移工具Agent,Agent可以收集迁移源信息并导入火山引擎。

  • Linux 操作系统

    1. 下载并解压迁移Agent。

      1. 登录云服务器控制台
      2. 在任意地域下的左侧目录树选择“服务器迁移中心 > 迁移源”。
      3. 在迁移源页面顶部,找到“迁移Agent下载”按钮。
        • 通过命令下载Agent
          1. 右键单击Agent下载按钮,单击“复制链接地址”按钮获取Agent下载链接。
          2. 登录待迁移的源服务器,执行如下命令下载Agent。
            wget <Agent下载链接>
            
        • 本地上传Agent
          1. 单击“迁移Agent下载”按钮下载迁移工具。
          2. 登录待迁移的源服务器,并将已下载的迁移工具Agent上传至源服务器。

            若您的源服务器也是云服务器,可参考本地数据上传完成操作。

      4. 使用如下命令解压迁移Agent。
        1. 执行unzip <下载的压缩包名称>命令解压下载文件,解压后将获得如下文件。
          文件名说明
          Linux_Version.tar.gzLinux操作系统使用到迁移工具压缩包。
          Windows_Version.zipWindows操作系统使用到迁移工具压缩包。
        2. 执行tar -xzvf Linux_Version.tar.gz命令,解压Linux版本迁移工具,解压后将获得如下文件。
          文件名说明
          Linux-version当前压缩包版本信息。

          smc-agent_Linux_amd64_1.0.tar.gz

          迁移Agent压缩包,包含迁移工具与配置文件等内容。

          说明

          此处Agent压缩包名称仅做参考,请以实际解压结果为准。

        3. 执行tar -xzvf <迁移Agent压缩包名称>命令,解压后将获得如下文件。
          文件名说明
          smc_agent二进制文件,迁移工具主要文件。
          smc_manage二进制文件,迁移管理工具。
          agent_cfg.jsonJSON文件,用于记录迁移过程信息。
          excludes.txttxt文件,不迁移的文件和目录路径需要写入此文件。
          user_cfg.jsonJSON文件,用户信息配置文件。
          smc_tools文件夹,包含迁移过程中SMC使用到的临时密钥对、块复制、检测脚本等工具。
    2. (可选)运行迁移Agent前,您可以排除无需迁移的文件或目录。

      1. 执行如下命令,编辑excludes.txt文件
        vim excludes.txt
        
      2. i键,写入无需迁移的文件或目录路径。

        说明

        • 需填写文件相对于其所在目录挂载点的相对路径,例如:路径为/etc/test.txt的文件,路径填写为test.txt。
        • 仅可修改您自行写入的内容,请勿修改文件原始内容。
      3. ESC键退出编辑,输入:wq并按回车键,保存并退出文件。
    3. (可选)您可以指定导入的迁移源归属于某个项目,方便管理。更多项目详情,可查看项目管理

      1. 执行如下命令,编辑user_cfg.json文件
        vim user_cfg.json
        
      2. i键,更新projectName参数的参数值为目标项目名称。

        说明

        默认为default项目。

      3. ESC键退出编辑,输入:wq并按回车键,保存并退出文件。
    4. 执行如下命令,运行迁移工具Agent。

      说明

      • 您需要使用root权限运行迁移工具Agent。
      • 请将<Agent所在目录>替换为实际路径。
      cd <Agent所在目录>
      ./smc_manage  start
      
    5. 输入火山引擎访问密钥(Access Key)包含的Access Key ID和Secret Access Key,并按Enter键确认。

      说明

      获取访问密钥(Access Key)操作,可查看获取Access Key

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

      1. 执行如下命令,打开工具用户信息配置文件。
        vim user_cfg.json
        
      2. i键进入编辑模式。
      3. 删除文件中已有aksk参数值,填入新的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
          
        • 成功迁移后,请使用源服务器登录凭证(密码或密钥对)登录目标实例或自定义镜像。
    7. 运行成功后,迁移Agent将开始向SMC上传迁移源信息。

      说明

      完成导入前请勿关闭迁移工具客户端,否则迁移源将与SMC控制台失去联系,无法完成导入。

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

  • Windows 操作系统

    说明

    由于Windows操作系统仅支持“块复制”方式迁移数据,不支持排除无需迁移的文件或目录。

    1. 下载并解压迁移Agent。

      1. 登录云服务器控制台

      2. 在任意地域下的左侧目录树选择“服务器迁移中心 > 迁移源”。

      3. 在迁移源页面顶部,找到“迁移Agent下载”按钮。

        • 通过PowerShell下载Agent
          1. 右键单击Agent下载按钮,单击“复制链接地址”按钮获取Agent下载链接。

          2. 登录源服务器,在PowerShell中执行如下命令,下载Agent。

            • <Agent下载链接>请替换为步骤1获取的下载链接。
            • <下载文件存储路径>请替换为实际路径。
            Start-BitsTransfer -Source "<Agent下载链接>" -Destination "<下载文件存储路径>\Volcanicengine_Migration_Tool.zip"
            
          3. 当传输进度完结且界面自动关闭后,即可前往您指定的存储位置解压使用Agent。

        • 本地上传Agent
          1. 单击“迁移Agent下载”按钮下载迁移工具。
          2. 登录源服务器,并将迁移工具Agent上传至源服务器。

            若您的源服务器也是云服务器,可参考本地数据上传完成操作。

      4. 右键单击Volcanicengine_Migration_Tool.zip文件,单击“全部解压缩”按钮并在弹窗中单击“提取”按钮,解压后将得到如下文件。

        文件名说明
        Linux_Version.tar.gzLinux操作系统使用到迁移工具压缩包。
        Windows_Version.zipWindows操作系统使用到迁移工具压缩包。
      5. 右键单击Windows_Version.zip文件,单击“全部解压缩”按钮并在弹窗中单击“提取”按钮,解压后将得到如下文件。

        文件名说明
        Windows-version.txt当前压缩包版本信息。

        smc-agent_Windows_x86_64_1.0.zip

        迁移Agent压缩包,包含迁移工具与配置文件等内容。

        说明

        此处Agent压缩包名称仅做参考,请以实际解压结果为准。

      6. 右键单击smc-agent_Windows_x86_64_1.0.zip,单击“全部解压缩”按钮并在弹窗中单击“提取”按钮,解压后将得到如下文件。

        文件名说明
        smc_agent.exe应用程序文件,迁移工具主要文件。
        agent_cfg.jsonJSON文件,用于记录迁移过程信息。
        user_cfg.jsonJSON文件,用户信息配置文件。
        bin文件夹,二进制文件存放目录。
        sciter.dll迁移工具依赖的库文件。
        notice.txt迁移工具遵守的规范信息。
    2. (可选)您可以指定导入的迁移源归属于某个项目,方便管理。更多项目详情,可查看项目管理

      1. 进入Agent所在文件夹。
      2. 右键单击user_cfg.json文件,单击“打开方式”按钮,选择“记事本”打开文件。
      3. 更新projectName参数的参数值为目标项目名称。

        说明

        默认为default项目。

      4. 保存修改并关闭文件。
    3. 您可以选择如下方式,运行迁移工具Agent。

      注意

      • 杀毒软件可能会禁止迁移工具运行,请检查其配置。
      • 您需要以管理员(Administer)身份运行迁移工具。
      • 开始运行后,Agent将自动生成smc.txt文件记录Agent运行日志,方便您排查迁移问题。
      • 方式一:图形化界面运行。
        1. 进入Agent所在文件夹。

        2. 右键单击smc_agent.exe,单击“以管理员身份运行”按钮,运行迁移工具Agent。

        3. 输入火山引擎访问密钥(Access Key)包含的Access Key ID和Secret Access Key,并单击“运行”按钮启动迁移Agent。

          获取访问密钥(Access Key)操作,可查看获取Access Key

        • 方式二:通过命令运行。
          1. 在PowerShell对话框中,运行如下命令。

            请将<Agent所在目录路径>替换为实际路径。

            cd <Agent所在目录路径>
            .\smc_agent.exe -autostart=true -ak=xxx -sk=xxx
            

            参数说明:

            参数名说明取值样例
            autostart是否使用命令行启动Agent,固定为truetrue
            ak火山引擎访问密钥(Access Key)包含的Access Key ID,获取详情可查看Access Key(密钥)管理AKLTYmMyNj***jY1OTU
            skAccess Key ID对应的Secret Access Key,获取详情可查看Access Key(密钥)管理TlRWaU1XUXhNREk***pJell6Yw==
          2. 系统将自动打开迁移Agent图形化界面,填入您在命令中传入的访问秘钥,并自动开始导入迁移源信息。

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

      说明

      完成导入前请勿关闭迁移工具客户端,否则迁移源将与SMC控制台失去联系,无法完成导入。

    5. 您可以在运行Agent的目录下,查看Agent运行日志文件smc.txt,获取SourceId(迁移源ID)及Agent运行日志,排查迁移问题。

后续操作

您可以前往云服务器控制台查看迁移源信息并创建迁移任务。操作详情可查看查看迁移源详情创建迁移任务