
# 安装Agent
启用数据库服务器备份前，需先在弹性云服务器上更改安全组和成功安装Agent。
如果服务器未安装Agent而执行了数据库服务器备份，则会出现数据库服务器备份失败，只能进行普通云服务器备份的情况。为了确保数据库服务器备份正常进行，请先按照本章节下载并安装Agent。
#### 操作说明
- 当前仅支持x86计算类型的服务器，暂不支持鲲鹏计算类型的服务器。
- 安装客户端时，系统会以"rdadmin"用户运行安装程序。请定期修改Agent的操作系统"rdadmin"用户的登录密码，并禁止"rdadmin"用户远程登录，以提升系统运维安全性。详情请参见[修改rdadmin账号密码](https://support.huaweicloud.com/usermanual-cbr/cbr_03_0042.html)。
- 支持安装客户端的操作系统如[表1]所示。其中，仅语言为中文或英文的Windows操作系统支持安装客户端。
   表1支持安装客户端的操作系统列表 
  | 数据库名称                  | 操作系统类型  | 版本范围                                                       |
  |:---|:---|:---|
  | SQLServer 2008         | Windows | Windows Server 2012, 2012 R2, 2019 for x86_64              |
  | SQLServer 2012         | Windows | Windows Server 2012, 2012 R2, 2019 for x86_64              |
  | SQLServer 2019         | Windows | Windows Server 2019 for x86_64                             |
  | SQLServer 2014/2016/EE | Windows | Windows Server 2016 Datacenter for x86_64                  |
  | SQLServer 2022         | Windows | Windows Server 2016, 2019, 2022 for x86_64                 |
  | MySQL 5.5/5.6/5.7      | Red Hat | Red Hat Enterprise Linux 6, 7 for x86_64                   |
  | MySQL 5.5/5.6/5.7      | SUSE    | SUSE Linux Enterprise Server 12, 15 SP1, 15 SP2 for x86_64 |
  | MySQL 5.5/5.6/5.7      | CentOS  | CentOS 6, 7 for x86_64                                     |
  | MySQL 5.5/5.6/5.7      | Euler   | Euler OS 2.2, 2.3 for x86_64                               |
  | MySQL 8.0              | Red Hat | Red Hat Enterprise Linux 7, 8 for x86_64                   |
  | MySQL 8.0              | CentOS  | CentOS 7 for x86_64                                        |
  | MySQL 8.0              | SUSE    | SUSE Linux Enterprise Server 15 SP5 for x86_64             |
  | HANA 1.0/2.0           | SUSE    | SUSE Linux Enterprise Server 12 for x86_64                 |
     
  ![](https://support.huaweicloud.com/usermanual-cbr/public_sys-resources/note_3.0-zh-cn.png)
  对于Windows 操作系统，需要Volume Shadow Copy服务正常运行，才能备份成功。
  
- 由于部分操作系统已结束官方支持（End of Service, EOS），因此不再在数据库服务器备份的支持范围内。如您仍希望在该服务器上使用数据库服务器备份功能，请使用旧版本的Agent软件。详细说明请参考[相关说明]。
- 支持的sha256值如[表2]所示。
   表2sha256值 
  | 包名                                               | sha256值                                                          |
  |:---|:---|
  | Cloud Server Backup Agent-CentOS6-x86_64.tar.gz  | f0c59ccb4443bcb6e874bf6e3c574914f9f8b27f3f7379e2d81956a9972802f3 |
  | Cloud Server Backup Agent-CentOS7-x86_64.tar.gz  | 2d3028cb794e1699bae9f65746a60ae99be17d5c4c5e7ebe6b45ff261db9c3c7 |
  | Cloud Server Backup Agent-EulerOS2-x86_64.tar.gz | 4fb4cf9cb6f5b0e6c13d8ad8bf928754cb95332ee645a97fd0bb3fcbeb53d003 |
  | Cloud Server Backup Agent-RedHat6-x86_64.tar.gz  | 6ae3838fb5644f0f47282c211fe20c6b57a7c5c1d683cd5a1f55860d259b2054 |
  | Cloud Server Backup Agent-RedHat7-x86_64.tar.gz  | 40fa68a808d9da04672678b2773e3345ea6c9dee3c17d598acb66a023cc5cacc |
  | Cloud Server Backup Agent-SuSE11-x86_64.tar.gz   | 346cc9f1fc0a41a817abb2db61e657a4d615449e13bc46f1c1cfbadc0b281f47 |
  | Cloud Server Backup Agent-SuSE12-x86_64.tar.gz   | 625279b9c9d17ddcc4210b78242efebacdad73f808b86754659d243ece85a400 |
  | Cloud Server Backup Agent-WIN64.zip              | b7b2067ac89f1fec635d82e3fe2ea794ce6482f9880838f34924b383be44ac4e |
  | CloudServerBackupAgent-Linux-x86_64.tar.gz       | 022d8f3806d79c606fc5d379f2e150504c95e40d7d87e1c5fe807747b0f81e9f |
  | CloudServerBackupAgent-WIN64.zip                 | 0894675d766d74d44bf1edf989d89000cae29acb85e37baf3238d2397e61af1e |
     
  
![](https://support.huaweicloud.com/usermanual-cbr/public_sys-resources/note_3.0-zh-cn.png)
客户端安装时，系统会打开弹性云服务器的59526-59528端口的防火墙其中之一。当59526端口被占用时，则会打开59527端口的防火墙，以此类推。
#### 前提条件
- 已获取管理控制台的登录账号与密码。
- 已经配置好安全组。
- 弹性云服务器的"Agent状态"为"未安装"。
- 通过IE浏览器访问时需要将用到的网站加入受信任的站点。
 
#### 安装Linux版本客户端（方式一）
1. [登录云备份控制台](https://console.huaweicloud.com/console/?locale=zh-cn#/cbr/manager/csbs/vaultList)。
   
   1. [登录云备份控制台](https://console.huaweicloud.com/console/?locale=zh-cn#/cbr/manager/csbs/vaultList)。
   
   2. 单击管理控制台左上角的![](https://support.huaweicloud.com/usermanual-cbr/zh-cn_image_0000002512834191.png)，选择区域。
   
   3. 单击"![](https://support.huaweicloud.com/usermanual-cbr/zh-cn_image_0000002480754324.jpg)"，选择"存储 \> 云备份 CBR"。
   
   
   
   
2. 选择左侧导航栏"云服务器备份"。
3. 选择"安装Agent"页签，进入"安装Agent"页面。 
   图1进入Linux安装界面
   
   ![](https://support.huaweicloud.com/usermanual-cbr/zh-cn_image_0000001879933598.png "点击放大")
   
   
   
   
   
4. 在方式一中，根据需要选择相应的Agent版本，并将步骤二的安装命令复制下来。
5. 前往"弹性云服务器"界面，选择目标服务器，单击"操作"列下的"远程登录"，登录该弹性云服务器。 
   ![](https://support.huaweicloud.com/usermanual-cbr/public_sys-resources/note_3.0-zh-cn.png)
   请确保此软件包的sha256值与[表2]提供的一致。
   软件包获取方式：在方式二中，单击"单击下载"。在弹出的"下载客户端"，根据目标弹性云服务器的操作系统类型，选择需要下载的版本。
   
   
6. 将步骤二的安装命令粘贴至该服务器，以root权限执行。 
   系统提示客户端安装成功，如[图2]所示。
   图2安装Linux客户端成功   
   ![](https://support.huaweicloud.com/usermanual-cbr/zh-cn_image_0000002263730818.png "点击放大")
   如果执行失败，请先使用命令yum install -y bind-utils进行dig模块安装；如果使用该命令安装仍旧失败，再使用安装Linux版本客户端（方式二）进行安装。
   
   
7. Linux系统客户端安装完成后，即表示Agent已在正常工作。后续请参考《云备份最佳实践》修改或编写自定义脚本，来实现MySQL或SAP HANA等数据库的一致性备份。
 
#### 安装Linux版本客户端（方式二）
1. [登录云备份控制台](https://console.huaweicloud.com/console/?locale=zh-cn#/cbr/manager/csbs/vaultList)。单击管理控制台左上角的![](https://support.huaweicloud.com/usermanual-cbr/zh-cn_image_0000002658631605.png)，选择区域。
2. 选择"安装Agent"页签，进入"安装Agent"页面。 
   图3Linux安装界面
   
   ![](https://support.huaweicloud.com/usermanual-cbr/zh-cn_image_0000001928173649.png "点击放大")
   
   
   
   
   
3. 在方式二中，单击"单击下载"。在弹出的"下载客户端"，根据目标弹性云服务器的操作系统类型，选择需要下载的版本，单击"确定"。如[图4]所示。
   
   图4下载客户端
   ![](https://support.huaweicloud.com/usermanual-cbr/zh-cn_image_0000001879953570.png)
   
   
   
   
   
4. 将客户端下载至本地任意目录后，请确保此软件包的sha256值与[表2]提供的一致。
5. 使用文件传输工具（例如："Xftp"、"SecureFX"、"WinSCP"），将下载的客户端安装包上传到待安装客户端的弹性云服务器。
6. 上传完毕后，前往"弹性云服务器"界面，选择目标服务器，单击"操作"列下的"远程登录"，登录该弹性云服务器。
7. 执行**tar -zxvf** 命令，将客户端安装包解压至任意目录，执行以下命令，进入解压后目录中的bin目录。
   
   **cd** **bin**
   
   
8. 执行以下命令，运行安装脚本。 
   **sh agent_install_ebk.sh**
   
   
9. 系统提示客户端安装成功，如[图5]所示。
   
   图5安装Linux客户端成功   
   ![](https://support.huaweicloud.com/usermanual-cbr/zh-cn_image_0160521047.png "点击放大")
   
   
10. 如果弹性云服务器中已经安装了MySQL或SAP HANA数据库，需要执行以下命令加密MySQL或HANA数据库登录密码。
    
    **/home/rdadmin/Agent/bin/agentcli encpwd**
    
    
11. 使用[上一个步骤]中的加密密码替换/home/rdadmin/Agent/bin/thirdparty/ebk_user/目录下脚本里的数据库登录密码。
12. Linux系统客户端安装完成后，即表示Agent已在正常工作。后续请参考《云备份最佳实践》修改或编写自定义脚本，来实现MySQL或SAP HANA等数据库的一致性备份。
 
#### 安装Windows版本客户端（方式一）
1. [登录云备份控制台](https://console.huaweicloud.com/console/?locale=zh-cn#/cbr/manager/csbs/vaultList)。单击管理控制台左上角的![](https://support.huaweicloud.com/usermanual-cbr/zh-cn_image_0000002658631605.png)，选择区域。
2. 选择"安装Agent"页签，进入"安装Agent"页面。 
   图6进入Windows安装界面
   
   ![](https://support.huaweicloud.com/usermanual-cbr/zh-cn_image_0000001880114422.png "点击放大")
   
   
   
   
   
3. 在方式一中，单击"单击下载"。将下载的安装包保存至本地任意目录。
4. 将客户端下载至本地任意目录后，请确保此软件包的sha256值与[表2](https://support.huaweicloud.com/usermanual-cbr/cbr_03_0021.html#cbr_03_0021__table1327905811117)提供的一致。
5. 使用文件传输工具（例如："Xftp"、"SecureFX"、"WinSCP"），将下载的客户端安装包上传到待安装客户端的弹性云服务器。
6. [登录弹性云服务器控制台](https://console.huaweicloud.com/ecm/?locale=zh-cn#/ecs/manager/vmList)，以Administrator的权限进入弹性云服务器。
7. 将安装包解压至任意目录，进入"*安装路径* **\\bin**"目录中。
8. 双击**agent_install_ebk** **.bat**脚本开始安装。
9. 系统提示客户端安装成功，如[图7]所示。
   
   图7Windows客户端安装成功   
   ![](https://support.huaweicloud.com/usermanual-cbr/zh-cn_image_0160521049.png "点击放大")
   
   
 
#### 安装Windows版本客户端（方式二）
1. [登录云备份控制台](https://console.huaweicloud.com/console/?locale=zh-cn#/cbr/manager/csbs/vaultList)。单击管理控制台左上角的![](https://support.huaweicloud.com/usermanual-cbr/zh-cn_image_0000002658631605.png)，选择区域。
2. 选择"安装Agent"页签，进入"安装Agent"页面。 
   图8Windows安装界面
   
   ![](https://support.huaweicloud.com/usermanual-cbr/zh-cn_image_0000001925873665.png "点击放大")
   
   
   
   
   
3. 前往"弹性云服务器"界面，选择目标服务器，单击"操作"列下的"远程登录"，以Administrator的权限登录该弹性云服务器。
4. 将方式二步骤二框中的安装命令复制到该服务器，在CMD中执行。
5. 将方式二步骤三框中的命令复制到浏览器，此处以华北区为例。然后在浏览器中按"Enter"下载安装包。 
   **https://csbs-agent-***cn-north-1*** .obs.***cn-north-1***.myhwclouds.com/Cloud Server Backup Agent-WIN64.zip**
   
   
6. 将客户端下载至本地任意目录后，请确保此软件包的sha256值与[表2](https://support.huaweicloud.com/usermanual-cbr/cbr_03_0021.html#cbr_03_0021__table1327905811117)提供的一致。
7. 解压后得到安装文件。将安装包解压至任意目录，进入"*安装路径* **\\bin**"目录中。
8. 双击**agent_install_ebk** **.bat**脚本开始安装。
9. 系统提示客户端安装成功，如[图9]所示。
   
   图9安装Windows客户端成功   
   ![](https://support.huaweicloud.com/usermanual-cbr/zh-cn_image_0160521051.png "点击放大")
   
   
 
#### 开启自动升级Agent
开启自动升级后，Agent会自动升级到最新版本。关闭Agent自动升级后，Agent将不会自动升级。后续如需更新Agent版本，请重新安装最新版本的Agent进行手动升级。
以下情况将不支持自动升级Agent版本：
- 云服务器操作系统不在新版本兼容性支持范围内 若当前服务器操作系统已超出新版本Agent的兼容支持范围，则无法通过自动升级方式更新至最新版本。
  
- 当前使用的Agent版本号为1.x.x系列 使用早期1.x.x版本的Agent将不支持自动升级功能。如需升级，请手动下载并安装兼容版本的Agent。
  
 
1. [登录云备份控制台](https://console.huaweicloud.com/console/?locale=zh-cn#/cbr/manager/csbs/vaultList)。单击管理控制台左上角的![](https://support.huaweicloud.com/usermanual-cbr/zh-cn_image_0000002658631605.png)，选择区域。
2. 选择"安装Agent"页签，进入"安装Agent"页面。
3. 将"Agent自动升级"按钮置为开启，在弹窗中单击"确定"。 
   图10开启Agent自动升级   
   ![](https://support.huaweicloud.com/usermanual-cbr/zh-cn_image_0000002312663322.png "点击放大")
   
   
4. （可选）如不在不需要自动升级Agent，则将"Agent自动升级"按钮置为关闭，在弹窗中单击"确定"。
 
 #### 相关说明
- 当前旧版本Agent不再提供bug修复、功能更新或技术支持；使用旧版本可能存在兼容性、安全性和稳定性风险，请根据实际情况评估使用。如您需安装旧版本，请参考以下说明操作：
  - Linux系统：请将安装命令中的包名替换为对应版本的包名，如Cloud Server Backup Agent-SuSE11-x86_64.tar.gz。 例如当前您的系统版本为SUSE 11，您可以将图中命令部分红框处替换为Cloud Server Backup Agent-SuSE11-x86_64.tar.gz进行旧版本Agent的安装。同理，如您需要使用方式二进行安装，则将下载弹窗的网页地址中的包名替换为Cloud Server Backup Agent-SuSE11-x86_64.tar.gz即可。
    ![](https://support.huaweicloud.com/usermanual-cbr/zh-cn_image_0000002346644677.png "点击放大")
    
  
  - Windows系统：请将安装命令中的包名替换为对应版本的包名，例如Cloud Server Backup Agent-WIN64.zip。 例如当前您的系统版本为Windows 2008，您可以将图中命令部分红框处替换为Cloud Server Backup Agent-WIN64.zip后进行旧版本Agent的安装。同理，如您需要使用方式一进行安装，则将下载弹窗的网页地址中的包名替换为Cloud Server Backup Agent-WIN64.zip即可。
    ![](https://support.huaweicloud.com/usermanual-cbr/zh-cn_image_0000002346766081.png "点击放大")
    
   
 
