Updated on 2022-08-16 GMT+08:00

Installing the Agent

Before enabling application-consistent backup, change the security group and successfully install the Agent on your ECSs.

If application-consistent backup is enabled but Agent is not installed on servers, application-consistent backup will fail, and a common server backup will be performed instead. To ensure that application-consistent backup is properly executed, download and install the Agent first.

Operation Instructions

  • During the Agent installation, the system requires the rdadmin user's permissions to run the installation program. To improve O&M security, change the user rdadmin's password of the Agent OS regularly and disable this user's remote login permission. For details, see Changing the Password of User rdadmin.
  • Table 1 lists OSs that support installation of the Agent.
    Table 1 OSs that support installation of the Agent

    Database

    OS

    Version

    SQL Server 2008/2012

    Windows

    Windows Server 2008, 2008 R2, 2012, and 2012 R2 for x86_64

    SQL Server 2014/2016/EE

    Windows

    Windows Server 2014, 2014 R2, and 2016 Datacenter for x86_64

    MySQL 5.5/5.6/5.7

    Red Hat

    Red Hat Enterprise Linux 6 and 7 for x86_64

    SUSE

    SUSE Linux Enterprise Server 11 and 12 for x86_64

    CentOS

    CentOS 6 and 7 for x86_64

    EulerOS

    EulerOS 2.2 and 2.3 for x86_64

    HANA 1.0/2.0

    SUSE

    SUSE Linux Enterprise Server 12 for x86_64

To install the Agent, the system will open the firewall of a port from 59526 to 59528 of the ECS. When port 59526 is occupied, the firewall of port 59527 is enabled, and so on.

Prerequisites

  • You have obtained a username and its password for logging in to the management console.
  • The security group has been configured.
  • The Agent Status of the ECS is Not installed.
  • If you use Internet Explorer, you need to add the websites you will use to trusted sites.

Installing the Agent for a Linux OS (Method 1)

  1. Click the Agent Installation tab.

  2. In method 1, select the corresponding Agent version as required, and copy the installation command in step 2.
  3. On the ECS page, select the target server and click Remote Login in the Operation column to log in to the ECS.
  4. Paste the installation command in step 2 to the server and run the command as user root. If the execution fails, run the yum install -y bind-utils command to install the dig module. If the installation still fails, use method 2 to install the Agent for a Linux OS.
  5. After the installation is complete, Agent is running properly. To implement application-consistent backup for MySQL, SAP HANA, or other types of databases, modify or compile a custom script by referring to the Cloud Backup and Recovery Best Practices.

Installing the Agent for a Linux OS (Method 2)

  1. Click the Agent Installation tab.

  2. In method 2, click Download. On the displayed download client dialog box, select the version to be downloaded based on the operating system type of the target ECS, and click OK.

  3. After downloading the Agent, use a file transfer tool, such as Xftp, SecureFX, or WinSCP, to upload the Agent installation package to your ECS.
  4. After the upload, go to the ECS page. Select the target server and click Remote Login in the Operation column to log in to the ECS.
  5. Run the tar -zxvf command to decompress the Agent installation package to any directory and run the following command to go to the bin directory:

    cd bin

  6. Run the following command to run the installation script:

    sh agent_install_ebk.sh

  7. The system displays a message indicating that the client is installed successfully. See Figure 1.

    Figure 1 Successful client installation for Linux

  8. If the MySQL or SAP HANA database has been installed on the ECS, run the following command to encrypt the password for logging in to the MySQL or SAP HANA database:

    /home/rdadmin/Agent/bin/agentcli encpwd

  9. Use the encrypted password in 8 to replace the database login password in the script in /home/rdadmin/Agent/bin/thirdparty/ebk_user/.
  10. After the installation is complete, Agent is running properly. To implement application-consistent backup for MySQL, SAP HANA, or other types of databases, modify or compile a custom script by referring to the Cloud Backup and Recovery Best Practices.

Installing the Agent for a Windows OS (Method 1)

  1. Click the Agent Installation tab.

  2. In method 1, click Download. Save the downloaded installation package to a local directory.
  3. After downloading the Agent, use a file transfer tool, such as Xftp, SecureFX, or WinSCP, to upload the Agent installation package to your ECS.
  4. Log in to the console and then log in to the ECS as the administrator.
  5. Decompress the installation package to any directory and go to the Installation path\bin directory.
  6. Double-click the agent_install_ebk.bat script to start the installation.
  7. The system displays a message indicating that the client is installed successfully. See Figure 2.

    Figure 2 Successful client installation for Windows

Installing the Agent for a Windows OS (Method 2)

  1. Click the Agent Installation tab.

  2. On the ECS page, select the target server and click Remote Login in the Operation column to log in to the ECS as the administrator.
  3. Copy the installation commands in step 2 of method 2 to the server and run the command in the Command Prompt.
  4. Copy any IP address in the response name, paste it in the address box of the browser, and replace 0.0.0.0 in the following address with the address. Replace region1 with the actual region. The following command uses region1 as an example. Then, press Enter in the browser to download the installation package.

    http://0.0.0.0/csbs-agent-region1/Cloud Server Backup Agent-WIN64.zip

  5. Decompress the file to obtain the installation file. Decompress the installation package to any directory and go to the Installation path\bin directory.
  6. Double-click the agent_install_ebk.bat script to start the installation.
  7. The system displays a message indicating that the client is installed successfully. See Figure 3.

    Figure 3 Successful client installation for Windows