# 安装Linux版的SMS-Agent
#### 操作场景
您需要在源端服务器上安装迁移Agent并且输入目的端服务器所在华为云账号的AK/SK，迁移Agent启动成功后会自动收集源端服务器信息并发送给主机迁移服务。收集的所有信息仅用于数据迁移，不会用作其他用途。具体收集源端哪些信息可查看[主机迁移服务会收集源端的哪些信息？](https://support.huaweicloud.com/sms_faq/sms_faq_0002.html)
![](https://support.huaweicloud.com/usermanual-sms/public_sys-resources/note_3.0-zh-cn.png)
在进行主机迁移时，SMS-Agent为手动安装并注册。如果源端待迁移的主机数量超过50台，推荐使用迁移中心 MgC服务[创建主机批量迁移工作流](https://support.huaweicloud.com/usermanual-mgc/mgc_03_3192.html)，通过批量自动注册的方式一次性发起多个迁移任务，从而提高迁移效率并简化操作流程。
#### 约束与限制
请使用Root用户登录源端Linux服务器进行下载和安装。
#### 前提条件
- 已获取目的端服务器所在华为云账号的AK/SK。
  - 如果您使用IAM用户进行迁移，具体请参见[如何获取AK/SK?（IAM用户）](https://support.huaweicloud.com/sms_faq/sms_faq_0012.html)。
  
  - 如果您直接使用账号进行迁移，具体请参见[如何获取AK/SK?（账号）](https://support.huaweicloud.com/sms_faq/sms_faq_0032.html)。
   

- 源端服务器的OS类型需要包含在[Linux兼容性列表](https://support.huaweicloud.com/productdesc-sms/sms3_01_0012.html)中。
 
#### 安装Linux版的SMS-Agent
1. 登录[主机迁移服务管理控制台](https://console.huaweicloud.com/sms3.0/?#/sms/overview)。
2. 在左侧导航树中，单击"迁移Agent"，进入"迁移Agent"页面。
3. 选择**Linux** 操作系统，单击Linux Agent下载窗格中的"下载Agent"后的![](https://support.huaweicloud.com/usermanual-sms/zh-cn_image_0000001936056440.png)图标，复制Agent的下载命令，在源端服务器执行命令下载迁移Agent。
   
   ![](https://support.huaweicloud.com/usermanual-sms/zh-cn_image_0000002518163769.png "点击放大")
   
   
   
4. 复制CMS文件和CRL文件的下载命令，在源端Linux主机下载CMS文件和CRL文件，对迁移Agent进行软件包完整性校验，具体操作参见[如何校验迁移Agent软件包数字签名CMS完整性？](https://support.huaweicloud.com/sms_faq/sms_faq_0037.html)。
   
   ![](https://support.huaweicloud.com/usermanual-sms/zh-cn_image_0000002485924054.png "点击放大")
   
   
   
5. 完整性校验完成后，执行以下命令，解压SMS-Agent软件包。 
   ```
   tar -zxvf SMS-Agent.tar.gz
   ```
   
   
6. 执行以下命令，进入源端服务器的SMS-Agent目录。 
   ```
   cd SMS-Agent
   ```
   
   
7. 选择是否使用HTTP/HTTPS代理服务器进行迁移。代理服务器为一种特殊网络服务，当您的源端无法通过公网访问华为云时，可以通过代理服务器访问华为云，代理服务器需用户自行配置。代理仅用于专线/VPN场景下源端到服务端的注册，不用于数据迁移过程。 
   - 若不使用HTTP/HTTPS代理服务器，请跳过该步骤，直接执行[下一步]。
   
   - 若使用HTTP/HTTPS代理服务器，请执行以下步骤：
     1. 执行如下命令，进入**config** 目录。
        ```
        cd SMS-Agent/agent/config
        ```
        
     
     2. 执行如下命令，打开并编辑auth.cfg文件。若迁移过程中不使用HTTP/HTTPS代理，禁止修改auth.cfg文件。
        ```
        vi auth.cfg
        ```
        示例：（以下仅为示例说明，具体代理服务器信息，请根据实际情况填写。）
        ```
        [proxy-config]
        enable = true
        proxy_addr = https://your-proxy-addr.com 
        proxy_port = 3128
        proxy_user = root
        use_password = true
        ```
        参数说明参见下表。
        表1代理参数配置说明 
        | 参数           | 说明                                                                                                              |
        |:---|:---|
        | enable       | 使用代理时，enable设置为true。                                                                                            |
        | proxy_addr   | 代理服务器地址，允许源端服务器通过代理服务器访问主机迁移服务，非目的端地址。your-proxy-addr.com需要更换为您代理服务器的地址，协议需要根据代理服务器的实际情况配置，建议您将代理服务器协议配置为https。 |
        | proxy_port   | 填写代理服务器开放的代理端口。                                                                                                 |
        | proxy_user   | 若代理服务器有用户名，则填写用户名，如root，没有则不填。                                                                                  |
        | use_password | 若代理服务器有密码，则设置为true，否则false。                                                                                     |
           
        
     
     3. 执行如下命令，保存auth.cfg文件并退出。
        ```
        :wq
        ```
        
      
   
   
   
   
8. 执行以下命令，启动SMS-Agent。
   
   ```
   ./startup.sh
   ```
   
   
9. 请仔细阅读显示内容，然后输入"y"并按键盘上的"Enter"键。 
   图1输入y   
   ![](https://support.huaweicloud.com/usermanual-sms/zh-cn_image_0000001208540715.png "点击放大")
   
   
10. 根据提示，输入目的端服务器所在华为云账号的AK、SK，以及SMS域名。SMS域名可在SMS控制台的"**迁移Agent** "页面获取，如[图3]所示。
    
    图2输入AK/SK   
    ![](https://support.huaweicloud.com/usermanual-sms/zh-cn_image_0000001208142171.png "点击放大")
    图3获取SMS域名   
    ![](https://support.huaweicloud.com/usermanual-sms/zh-cn_image_0000001468080613.png "点击放大")
    
    如果您的账号已经开通企业项目，输入AK/SK后，Agent会查询有主机迁移权限的企业项目并罗列，供您选择。选择具体的企业项目后，主机迁移服务会将主机迁移到您指定的企业项目中。实现迁移时权限、资源和财务的隔离。更多详细介绍和操作步骤，请参见[将主机迁移至企业项目](https://support.huaweicloud.com/bestpractice-sms/sms_05_0004.html)。
    当出现如下界面时，表示Linux版的SMS-Agent启动成功，开始给主机迁移服务上传源端服务器信息。您可以前往SMS控制台的"服务器迁移"列表页面查看上报的源端服务器。
    图4Agent启动成功   
    ![](https://support.huaweicloud.com/usermanual-sms/zh-cn_image_0000001704364118.png "点击放大")
    
    
 
#### 问题处理
- 如果迁移Agent启动失败，出现"SMS.6517 rsync not installed on the source server."错误提示，请您参见[SMS.6517 源端没有安装rsync](https://support.huaweicloud.com/sms_faq/sms_faq_0021.html)进行处理。
- 如果迁移Agent启动失败，出现"SMS.0202 AK,SK鉴权失败,请检查AK,SK是否正确"的错误提示，请您参见[SMS.0202 AK,SK鉴权失败](https://support.huaweicloud.com/sms_faq/sms_faq_0024.html)进行处理。
- 如果控制台看不到源端服务器记录，请参考[源端Agent注册后为什么主机迁移服务控制台没有记录](https://support.huaweicloud.com/sms_faq/sms_faq_0003.html)，进行排查处理。
 
#### 卸载SMS-Agent
迁移完成后，您可以卸载源端安装的SMS-Agent，具体卸载方法请参考[卸载Linux版SMS-Agent](https://support.huaweicloud.com/sms_faq/sms_faq_0035.html#section1)。