# 安装代理客户端
#### 操作场景
当需要使用BRS服务时，需要在生产站点服务器安装代理客户端。
代理客户端将复制生产站点服务器的IO，并发送给容灾网关。
#### 前提条件
- 代理客户端不能部署在云容灾网关服务器上。
- 为保障服务正常运行，需要确保[异步复制客户端的端口说明](https://support.huaweicloud.com/usermanual-sdrs/sdrs_faq_0011.html)中的端口未被占用。
- 如果待安装代理客户端的服务器的防火墙已开启，需要放通59526端口的访问。
- 云容灾网关和代理客户端建议放在同一安全组内，安全组配置为仅允许安全组内弹性云服务器互通。
 
#### 安装包准备步骤
基于安全考虑，BRS服务将在首次安装时随机生成自签证书用于组件间认证。为保证通信正常，安装代理客户端时，需使用在**网关节点**上生成的携带证书的安装包。
![](https://support.huaweicloud.com/usermanual-sdrs/public_sys-resources/note_3.0-zh-cn.png)
仅新安装客户端涉及以下安装包准备步骤。
如果云容灾网关存在已经签名的目标版本安装包，可直接使用该安装包安装，详见[Linux安装代理客户端步骤]或[Windows安装代理客户端步骤]。
1. 获取代理客户端软件包到**网关服务器** 的**/opt/cloud** 目录，并比对软件包的sha256值，确保安装包完整性。
   
   - IDC上云模式：通过界面链接下载软件包，并上传到网关服务器/opt/cloud目录； 
     
     ![](https://support.huaweicloud.com/usermanual-sdrs/zh-cn_image_0000002132486292.png)
     
   
   - 跨区域和跨可用区模式：在服务控制台页面选择生产站点服务器的操作系统及对应版本，复制页面提供的命令，登录到网关服务器，进入/opt/cloud目录，粘贴并执行命令获取软件包。 
     ![](https://support.huaweicloud.com/usermanual-sdrs/zh-cn_image_0000002132328104.png)
     
     ![](https://support.huaweicloud.com/usermanual-sdrs/zh-cn_image_0000001963229077.png)
     
   
   
   
   
2. 执行以下命令，将网关节点上的证书打包生成新的Linux安装包和sha256文件： 
   sh /opt/cloud/sdrs/create_certs.sh**-l**
   ![](https://support.huaweicloud.com/usermanual-sdrs/zh-cn_image_0000001963237477.png)
   
   
3. 执行以下命令，将网关节点上的证书打包生成新的Windows安装包和sha256文件： 
   sh /opt/cloud/sdrs/create_certs.sh **-w**
   ![](https://support.huaweicloud.com/usermanual-sdrs/zh-cn_image_0000001936039610.png)
   ![](https://support.huaweicloud.com/usermanual-sdrs/public_sys-resources/note_3.0-zh-cn.png)
   打包Windows安装包需要使用unzip\\zip命令，若回显中包含如下提示，需安装后再进行重试。
   ```
   ...    unzip not installed.
   ```
   或者
   ```
   ...    zip not installed.
   ```
   
   
 
 #### Linux安装代理客户端步骤
以下操作以在Centos系统安装"24.9.0"版本的代理客户端安装包"***sdrs_xxxx_24.9.0.xxxx.tar.gz***"为例。
1. 获取在网关节点/opt/cloud目录下生成的安装包**sdrs_xxxx_24.9.0.xxxx_with_certs.tar.gz** 到待部署服务器的任意目录并比对软件包的sha256值，确保安装包完整性。
2. 在软件包所在目录下，以"root"用户，执行以下命令，解压缩软件包。 
   **tar -zxvf sdrs_xxxx_24.9.0.xxxx_with_certs.tar.gz**
   
   
3. 执行以下命令，进入安装脚本所在目录。 
   **cd sdrs_xxxx_24.9.0.xxxx**
   
   
4. 执行以下命令，安装代理客户端软件。 
   **sh install.sh --hostagent-ip=** *hostagent_ip* **--drm-ip=** *drm _ip* **--role=all**
   其中，"hostagent_ip"为代理客户端的IP地址，需要设置为安装代理客户端服务器的主网卡IP地址。"drm_ip"为云容灾网关的IP地址。
   回显中包含如下信息，说明代理客户端安装成功：
   ```
   ...
   Installed SDRS successfully.
   ...
   ```
   
   
5. 安装完成后，删除安装包及其解压文件。
 
 #### Windows安装代理客户端步骤
以下操作以在windows 2019系统安装"24.9.0"版本的代理客户端安装包"**sdrs_xxxx_24.9.0.xxxx.zip**"为例。
1. 获取在网关节点/opt/cloud目录下生成的安装包**sdrs_xxxx_24.9.0.xxxx_with_certs.zip**到待部署服务器的任意目录并比对软件包的sha256值，确保安装包完整性。
2. 在软件包所在目录下，选择软件包，右键解压。
3. 双击解压目录，进入安装脚本所在目录。 
   
   ![](https://support.huaweicloud.com/usermanual-sdrs/zh-cn_image_0000002014280502.png)
   
   
4. 右键以管理员权限运行安装脚本install.bat。 
   
   ![](https://support.huaweicloud.com/usermanual-sdrs/zh-cn_image_0000002140400637.png)
   根据回显指示输入参数：
   1. role 选择all
   
   2. DRM IP 输入云容灾网关的ip地址
   
   3. nginx所用的ip，若生产站点服务器有多个网卡，此处均将列举出来，请选择所需的ip对应的序号
   
   
   图1代理客户端安装示例   
   ![](https://support.huaweicloud.com/usermanual-sdrs/zh-cn_image_0000001919271497.png)
   ![](https://support.huaweicloud.com/usermanual-sdrs/public_sys-resources/notice_3.0-zh-cn.png)
   BRS服务要求jdk版本\>=jdk.8u261，若当前版本低于要求需升级jdk版本。
   若生产站点服务器未安装Jdk，安装BRS时将自动安装；若当前服务器已有jdk，则不会再次安装。
   
   
5. 代理客户端将安装在C:\\cloud\\sdrs目录下，安装完成后，请手动删除安装包及其解压文件。 
   ![](https://support.huaweicloud.com/usermanual-sdrs/zh-cn_image_0000001873472246.png)