Updated on 2024-10-29 GMT+08:00

Installing a Proxy Client

Scenarios

To use SDRS, you need to install a proxy client on each production site server.

The proxy client replicates I/Os of each production site server and sends them to the disaster recovery gateway.

Prerequisites

  • The proxy client cannot be deployed on the disaster recovery gateway server.
  • Ensure that the ports listed in Port Description (Asynchronous Replication) are not used.
  • If the firewall is enabled on the ECS where you want to deploy the proxy client, enable port 59526 on the firewall.
  • It is recommended that you deploy the disaster recovery gateway and proxy client in the same security group and only allow ECSs within the security group to communication with each other. For details, see Security Group Configuration Examples.

Procedure

Preparing the installation package

For security concerns, SDRS randomly generates a self-signed certificate for inter-component authentication upon the first installation. When you install the proxy client, the package with this certificate generated on the gateway server is required to ensure normal communication.

This step is only required when the client is newly installed.

  1. Obtain the proxy client package and upload it to the /opt/cloud directory on the gateway server. Ensure the package integrity by comparing the SHA256 values in advance.

    • IDC-to-cloud: Click the link on the console to download the package and upload it to the /opt/cloud directory of the gateway server.

    • Cross-region and Cross-AZ: Select the OS type and version of your production site server on the console and copy the command provided. Then, log in to the gateway server, go to the /opt/cloud directory, and paste and run the command to obtain the package.

  2. Generate a new Linux installation package and a .sha256 file using the certificates on the gateway server.

    sh /opt/cloud/sdrs/create_certs.sh -l

  3. Generate a new Windows installation package and a .sha256 file using the certificates on the gateway server.

    sh /opt/cloud/sdrs/create_certs.sh -w

    Use unzip and zip when packaging the Windows installation package. If any of the following is return, install the command package and then try again:

    ...    unzip not installed.

    Or

    ...    zip not installed.

Linux

In the following example, sdrs_xxxx_24.9.0.xxxx.tar.gz is the package (24.9.0) used to install the proxy client on CentOS.

  1. Obtain the sdrs_xxxx_24.9.0.xxxx.tar.gz_with_certs.tar.gz package from the /opt/cloud directory of the gateway server and upload it to a directory on the target production server. Ensure the package integrity by comparing the SHA256 values.
  2. In the directory containing the package, run the following command as user root to decompress the package:

    tar -zxvf sdrs_xxxx_24.9.0.xxxx.tar.gz_with_certs.tar.gz

  3. Go to the directory containing the installation script.

    cd sdrs_xxxx_24.9.0.xxxx.tar.gz

  4. Install the proxy client.

    sh install.sh --hostagent-ip=hostagent_ip --drm-ip=drm _ip --role=all

    In the preceding command, hostagent_ip indicates the IP address of the proxy client. Set it to the IP address of the primary NIC of the server you want to install the proxy client. drm_ip indicates the IP address of the cloud disaster recovery gateway.

    If the command output contains the following information, the proxy client has been installed:
    ...
    Installed SDRS successfully.
    ...

  5. After the installation is complete, delete the installation package and decompressed files.

Windows

In the following example, sdrs_xxxx_24.9.0.xxxx.tar.gz.zip is the package (24.9.0) used to install the proxy client on Windows Server 2019.

  1. Obtain the sdrs_xxxx_24.9.0.xxxx.tar.gz_with_certs.zip package from the /opt/cloud directory of the gateway server and upload it to a directory on the target production server. Ensure the package integrity by comparing the SHA256 values.
  2. In the directory containing the package, right-click the package to decompress it.
  3. Double-click the decompressed directory to go to the directory containing the installation script.

  4. Double-click install.bat to run the script.

    Enter the parameters as prompted.

    1. Select all for role.
    2. Enter the gateway IP address for DRM IP Address.
    3. If the production site server has multiple NICs, all the IP addresses bound by Nginx will be displayed, enter the serial number of the IP address you required.
    Figure 1 Proxy client installation example

    SDRS requires that jdk.8u261 or later is installed on the production site server. If the installed version is earlier than jdk.8u261, upgrade JDK first.

    If JDK is not installed, it will be automatically installed during the SDRS installation. If JDK has been installed, it will not be installed again.

  5. The proxy client is installed in the C:\cloud\sdrs directory. After the installation is complete, manually delete the installation package and decompressed files.