Installing the Agent

Context

There are three types of backup consistency:

• Inconsistent backup: Files and disks are backed up at different points in time.
• Crash-consistent backup captures data existing on disks upon backup and backs up files and disks at the same point in time, without backing up memory data and quieting application systems. Backup consistency of application systems is not ensured. Though the application consistency is not ensured, disks, such as chkdsk, will be checked upon operating system re-startup to restore damaged data and log rollback will be performed on databases to keep data consistent.
• Application-consistent backup backs up files and disks at the same point in time, including memory data, to ensure application system consistency.

Description

• Before enabling application-consistent backup, change the security group and install the Agent on your ECSs. This section guides you to download and install the Agent.
• During the Agent installation, the system requires the rdadmin user's permissions to run the installation program. For O&M security purposes, change the user rdadmin's password of the Agent OS regularly and disable this user's remote login permission.
• Table 1 lists OSs that support installation of the Agent.

  Table 1 OSs that support installation of the Agent

  Database	OS	Supported Version
  SQLServer 2008/2012	Windows	Windows Server 2008, 2008 r2, 2012 , 2012 r2 for x86_64
  SQLServer 2014/2016/EE	Windows	Windows Server 2012, 2012 r2, 2016 Datacenter for x86_64
  MySQL 5.5/5.6/5.7	Red Hat	Red Hat Enterprise Linux 6, 7 for x86_64
  	SUSE	SUSE Linux Enterprise Server 11, 12 for x86_64
  	CentOS	CentOS 6, 7 for x86_64
  	Euler	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 Linux (Method 1)

1. Log in to the CSBS management console.
   1. Log in to the management console.
   2. Under Storage > Cloud Server Backup Service.

2. Click the Install Agent tab to go to the Install Agent tab page.
   Figure 1 Installation screen
   

3. In method 1, select the corresponding Agent version as required, and copy the installation command in step 2.
4. On the ECS page, select the target server and click Remote Login in the Operation column to log in to the ECS.
5. Paste the installation command in step 2 to the server and run the command as the root user. If the execution fails, run the yum install -y bind-utils command to install the dig module.
6. Finish the installation as instructed. If the installation fails, use method 2.
7. After the Agent for Linux is installed, see the best practices of application-consistent backup to modify or write a custom script to implement consistent backup for MySQL, SAP HANA, or other database types.

Installing the Agent for Linux (Method 2)

1. Log in to the CSBS management console.
   1. Log in to the management console.
   2. Under Storage > Cloud Server Backup Service.

2. Click the Install Agent tab to go to the Install Agent tab page.
   Figure 2 Installation screen
   

3. In method 2, click Download. In the dialog box, select the version to be downloaded based on the operating system type of the target ECS, and click OK. See Figure 3.
   Figure 3 Downloading the Agent
   

4. Use a file transfer tool, such as Xftp, SecureFX, or WinSCP, to upload the Agent installation package to your ECS.
5. 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.
6. 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 storage directory of the installation package

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

   sh agent_install_ebk.sh

8. The system displays a message indicating that the client is installed successfully. See Figure 4.
   Figure 4 Successful client installation
   

9. 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

10. Use the encrypted password in step 9 to replace the database login password in the script in /home/rdadmin/Agent/bin/thirdparty/ebk_user/.
11. After the Agent for Linux is installed, see the Database Backup Best Practice to modify or write a custom script to implement consistent backup for MySQL, SAP HANA, or other types of database.

Installing the Agent for Windows (Method 1)

1. Log in to the CSBS management console.
   1. Log in to the management console.
   2. Under Storage > Cloud Server Backup Service.

2. Click the Install Agent tab to go to the Install Agent tab page.
   Figure 5 Installation screen
   

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

Installing the Agent for Windows (Method 2)

1. Log in to the CSBS management console.
   1. Log in to the management console.
   2. Under Storage > Cloud Server Backup Service.

2. Click the Install Agent tab to go to the Install Agent tab page.
   Figure 7 Installation screen
   

3. 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.
4. Copy the installation commands in step 2 of method 2 to the server and run the command in the CMD window.
5. 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 cn-north-1 with the actual region. The following command uses North China as an example. Then, press Enter in the browser to download the installation package.

   http://0.0.0.0/csbs-agent-cn-north-1/Cloud Server Backup Agent-WIN64.zip

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