SMC客户端使用指南

SMC客户端为阿里云自主研发的迁移工具,迁移时需要在源服务器中运行SMC客户端。本文主要介绍如何下载、查看、运行、停止和退出SMC客户端。

获取SMC客户端

查看SMC客户端

  • 如果是通过SMC控制台或ECS控制台自动导入的迁移源。

    • Linux系统:SMC默认安装目录为/smc/go2aliyun_client*/

      其中:*需要替换为实际SMC客户端的版本号,例如:2.7.3。

    • Windows系统:SMC默认安装目录为C:\smc\go2aliyun_client*\

  • 如果是通过手动下载客户端方式导入的迁移源,SMC安装目录则是您自行解压的目录(无需执行安装程序,解压即可用)。

SMC客户端压缩包解压后文件夹中包含的目录和文件如下。

  • Windows版本

    image

  • Linux版本

    image

解压后文件说明如下表所示。

文件(夹)名

描述

go2aliyun_client.exe

(Windows版本)命令行主程序。

go2aliyun_gui.exe

(Windows版本) GUI主程序。GUI版本详情,请参见SMC客户端说明(Windows)

go2aliyun_client

(Linux版本)命令行主程序。

Check

(Linux版本)迁移前检查文件夹。

EULA

最终用户许可协议。

user_config.json

迁移源和迁移目标的配置文件。

Excludes

(Linux版本)排除不迁移的文件目录配置文件夹。更多信息,请参见如何过滤、排除不需要迁移的文件或目录?

client_data

迁移数据文件,包含ECS中转实例信息和迁移进度等。

运行SMC客户端

  • 如果您选择控制台导入迁移源或者命令行导入迁移源的方式,则系统会自动运行SMC客户端。

  • 如果您选择客户端导入迁移源的方式,则需要手动运行SMC客户端。具体操作如下:

    1. 进入SMC客户端的安装目录。SMC客户端的安装目录,请参见查看SMC客户端

    2. 执行以下命令,运行SMC客户端。

      • Linux系统

        chmod +x ./go2aliyun_client
        ./go2aliyun_client
      • Windows系统

        双击运行go2aliyun_gui.exe,或通过CMD运行go2aliyun_client.exe

    3. 检查SMC客户端运行状态。

      • 如果运行无报错,则会提示迁移源导入成功如下图,迁移源状态会恢复正常。

        image

        • 如果没有关联的迁移任务,迁移源状态会变成在线

        • 如果已有关联的迁移任务,迁移源状态会变成迁移中。如果迁移任务状态为出错,可在操作列,单击重试任务,尝试恢复继续运行迁移任务。

      • 如果运行报错,则会提示相关错误码信息如下图。获取错误码后,排查问题排查后再试。具体操作,请参见故障排除

        image

        说明

        如果您需要停止客户端迁移或修改客户端配置,可参考以下操作步骤退出SMC客户端。

        • Linux

          Linux版本客户端默认在后台运行,可执行以下命令退出后台进程:

          ./go2aliyun_client --abort
        • Windows

          Windows版本客户端是前台运行,直接退出go2aliyun_gui.exego2aliyun_client.exe程序即可。

    重要

    在迁移过程中,切勿手动关闭SMC客户端,否则可能导致迁移失败。

SMC客户端说明(Windows)

SMC为Windows系统迁移提供了GUI版本客户端和命令行版本客户端,两者配置参数的原理一致,并且运行过程兼容。

Windows GUI客户端主界面如下图所示。asdasd

主界面及菜单项说明如下表所示。

序号

分区

描述

菜单栏

配置日志视图帮助语言五个菜单组成。

  • 配置

    • 单击传输选项,设置数据传输的带宽上限值(单位为KB/s)。

    • 单击保存用户配置,保存当前的页面设置便于批量操作。

    • 单击清理工具数据,一键初始化客户端配置文件。

  • 日志

    • 单击打开日志文件快速打开迁移日志文件。

    • 单击打开日志目录查找迁移日志文件所在路径。

  • 视图: 单击隐藏进度日志隐藏或取消隐藏进度日志栏。

  • 帮助:获取在线文档或SMC客户端版本信息。

  • 语言:选择GUI界面的显示语言。

用户自定义配置编辑区

您可以根据需求配置激活码或者密钥(AccessKey),配置的信息会被写入SMC客户端user_config.json文件中。

  • 激活码:输入Token IdToken Code

    说明

    Token IdToken Code的获取方式,请参见通过命令行一键导入迁移源

  • 密钥(AccessKey):

    • AK:输入AccessKey ID。

    • SK:输入AccessKey Secret。

    说明

    获取AccessKey的具体操作,请参见创建AccessKey

任务进度与日志区

运行客户端后,您可以通过该区域查看任务进度或根据界面提示排查故障。

使用Windows GUI客户端迁移源服务器至阿里云的操作视频如下:

重要

退出SMC客户端之前要确保没有正在执行中的迁移任务,否则任务可能因此执行失败。

退出SMC客户端

  1. 进入到SMC客户端目录。具体操作,请参见查看和运行SMC客户端

  2. 退出SMC客户端。

    • Linux

      Linux版本客户端默认在后台运行,可以执行以下命令退出。

      ./go2aliyun_client --abort
    • Windows

      • 如果是手动运行的客户端程序,直接退出go2aliyun_gui.exego2aliyun_client.exe程序即可。

      • 如果不确定,在命令行窗口执行以下命令退出即可。

        go2aliyun_client.exe --abort

卸载SMC客户端

在退出客户端迁移后,可参考以下操作步骤卸载SMC客户端。

  • Linux

    1. 执行以下命令,尝试清理残留缓存数据。

      ./Check/client_check --ssclear smcss
    2. 删除SMC客户端目录。

      示例为默认安装SMC客户端目录。

      rm -f /smc/go2aliyun_client*/

      其中:*需要替换为实际SMC客户端的版本号,例如:2.7.3。

  • Windows

    删除SMC客户端目录即可。SMC默认安装目录是为C:\smc\go2aliyun_client*\

相关文档

使用SMC迁移时,出错提示“S0_*客户端调用SMC服务出错”时,具体解决方案请参见出错提示S0客户端调用SMC服务出错