Install backup gateway

更新时间:
复制 MD 格式

A backup gateway is a client program you install on a database server. It lets you back up local databases for disaster recovery, perform physical backups and restores, and automatically download backup sets to a self-managed server. This topic describes how to install a backup gateway.

Use cases

Server backup gateway

Use case

Description

Mechanism

Physical backup

A physical backup captures the database files at the operating system level.

The backup gateway starts a process on the database server. This process receives operation tasks and backup schedule configurations from the Data Disaster Recovery console to back up and restore the database.

Private network backup

Data Disaster Recovery cannot directly access and back up databases in a private network, such as databases in an on-premises data center or a private network of another cloud provider.

The backup gateway can act as middleware to actively access the Data Disaster Recovery server and cloud OSS, resolving the issue where Data Disaster Recovery cannot directly access a private network database.

Automatic download of backup sets

Data Disaster Recovery lets you automatically download backup sets to a local server.

The backup gateway periodically accesses cloud storage to download backup sets to your local server, ensuring data security and reliability.

Note

You only need to install the backup gateway on the database server.

Bastion host architecture

To back up a database in a private network without internet access, install a proxy gateway on a bastion host and a backup gateway on the database server. The following table describes the steps.

Step

Description

Install a proxy gateway on a bastion host

Install a proxy gateway on a bastion host.

The main function of the proxy gateway is to receive data from the database server that hosts the backup gateway during a backup and forward the data to the disaster recovery cloud storage over the Internet. Additionally, during a database recovery or download, the proxy gateway receives data sent back from the disaster recovery cloud storage and forwards it to the database server.

Install a backup gateway on the database server

Install a backup gateway on the database server. During the installation, specify the IP address of the proxy gateway (the private IP address of the bastion host).

During a backup, the backup gateway connects to and queries the database, then sends the data to the proxy gateway. During a restoration, it retrieves data through the proxy gateway and writes it to the database.

Prerequisites

  • Ensure the database server has a Java environment that meets the following requirements:

    • Linux server: Install Java Runtime Environment (JRE) version 1.8. Download it from the official website.

    • Windows server: Install Java SE Development Kit (JDK) version 8u261. Download it from the official website. Other versions will cause the backup precheck to fail.

    Note

    Run the java -version command in the CLI to verify the installed Java version.

  • Complete the following tasks:

    • Create an AccessKey and obtain the AccessKey ID and AccessKey secret. The backup gateway uses these credentials to authenticate when it registers with the Data Disaster Recovery console. For more information, see Create an AccessKey.

    • If you use a RAM user to add the backup gateway, grant the AliyunDBSFullAccess and AliyunOSSFullAccess permissions to the RAM user. For more information, see Manage RAM user permissions.

      Note
      • By default, your Alibaba Cloud account receives these permissions when you activate Data Disaster Recovery.

      • After you add a backup gateway, all users in your Alibaba Cloud account can see it in the Data Disaster Recovery console.

  • Ensure that the installation directory on the server has more than 1 GB of free disk space and that you have the required permissions:

    • Linux server: root permissions.

    • Windows server: administrator permissions.

  • If you back up an SQL Server database, grant the sysadmin server role to the NT AUTHORITY\SYSTEM account by running the following SQL command or using the GUI:

    • SQL command

      ALTER SERVER ROLE [sysadmin] ADD MEMBER [NT AUTHORITY\SYSTEM]
      GO
    • GUI: In SQL Server Management Studio, right-click the NT AUTHORITY\SYSTEM login and select Properties. On the Server Roles page, select the sysadmin checkbox, and then click OK.

    Note

    By default, AliyunDBSAgent runs as NT AUTHORITY\SYSTEM.

Precautions

Installation methods

The backup gateway installer automatically selects a graphical or command-line installation method based on your system environment. You can also install the backup gateway in unattended mode.

Note

By default, the installer prioritizes the graphical user interface (GUI) method on systems that support a GUI, such as Windows, or GNOME and KDE on Linux. The command-line interface (CLI) method is used only if a GUI is not supported.

GUI

  1. Log on to the DMS console V5.0.

  2. Move the pointer over the 2023-01-28_15-57-17.png icon in the upper-left corner and choose All Features > Security and disaster recovery (DBS) > Data Disaster Recovery (DBS) > Backup Gateway.

    Note

    If you use the DMS console in normal mode, choose Security and disaster recovery (DBS) > Data Disaster Recovery (DBS) > Backup Gateway in the top navigation bar.

  3. In the upper-right corner of the page, click Add Backup Gateway.

  4. Copy the installation command for Windows and run the command in the Windows Command Prompt.

    Microsoft Windows [Version]
    (c) 2019 Microsoft Corporation. All rights reserved.
    C:\Users\xxx>cmd /c cd "%USERPROFILE%"&bitsadmin /transfer 1 /priority foreground https://aliyun-dbs.oss-cn-hangzhou.aliyuncs.com/installer/0.0.96/aliyunDBSAgentInstaller-0.0.96.jar "%USERPROFILE%\dbs.jar"&java -Dregion=cn-hangzhou -jar dbs.jar
    Note

    After the download is complete, the installer runs automatically.

    1. Select an installation language and click Next.

    2. Read and accept the license agreement, and then click Next.

    3. Select DBS Backup Gateway and click Next.

      Note

      This example shows how to install a DBS Backup Gateway to connect to a local database. To connect to data on a bastion host, see Backup gateway in a bastion host architecture.

    4. Select an installation path, click Next, and then click Yes.

    5. Confirm the Agent Region, enter your AccessKey ID and AccessKey Secret, and then click Next.

      The account for the AccessKey pair must have the AliyunDBSFullAccess and AliyunOSSFullAccess permissions.

      Note
      • Confirm that the Agent Region is the region nearest to your database. If you need to change the region, select the target region.

      • The AccessKey pair is stored in plaintext in the .\config\dbs-agent.conf file in the installation directory.

      • In a bastion host architecture, you must enter the private IP address of the bastion host in the Database Gateway Address text box. The Database Gateway Port defaults to 9797. For more information, see Backup gateway in a bastion host architecture.

    6. Confirm the component package and click Next.

      The installation takes about 1 to 5 minutes.

    7. After the installation is complete, click Next.

    8. Click Done to complete the installation.

  5. In the Windows Run dialog box, enter services.msc and click OK to open the Services manager.

  6. In the Services manager, verify that the service has started. If not, right-click AliyunDBSAgent and select Start.

    Note

    The system starts the backup gateway by default. You can also start or stop the AliyunDBSAgent service in the Services manager.

  7. In the Database Backup (DBS) console, on the Backup Gateway page, click Refresh to view the newly added backup gateway.

CLI

  1. Log on to the DMS console V5.0.

  2. Move the pointer over the 2023-01-28_15-57-17.png icon in the upper-left corner and choose All Features > Security and disaster recovery (DBS) > Data Disaster Recovery (DBS) > Backup Gateway.

    Note

    If you use the DMS console in normal mode, choose Security and disaster recovery (DBS) > Data Disaster Recovery (DBS) > Backup Gateway in the top navigation bar.

  3. In the upper-right corner of the page, click Add Backup Gateway.

  4. Select a Network Type for Backup Gateway, then copy and run the installation command on your database server.

    Note
    • Public network: Access Database Backup (DBS) over the public network.

    • ECS private network / VPC: Access Database Backup (DBS) over Alibaba Cloud Express Connect.

    1. Run the installation command in the Linux CLI. The command automatically downloads and runs the installer. The following example shows the command output:

      [root@iZbp****** ~]# wget -O aliyunDBSAgentInstaller.jar https://aliyun-dbs.oss-cn-hangzhou-internal.aliyuncs.com/installer/0.0.141/aliyunDBSAgentInstaller-0.0.141.jar && sudo java -Dregion=cn-hangzhou -jar aliyunDBSAgentInstaller.jar
      --2023-08-25 15:44:35--  https://aliyun-dbs.oss-cn-hangzhou-internal.aliyuncs.com/installer/0.0.141/aliyunDBSAgentInstaller-0.0.141.jar
      Resolving aliyun-dbs.oss-cn-hangzhou-internal.aliyuncs.com (aliyun-dbs.oss-cn-hangzhou-internal.aliyuncs.com)... 100.XXX.XX.XX, 100.XXX.XX.XX, 100.XXX.XX.XX, ...
      Connecting to aliyun-dbs.oss-cn-hangzhou-internal.aliyuncs.com (aliyun-dbs.oss-cn-hangzhou-internal.aliyuncs.com)|100.XXX.XX.XX|:443... connected.
      HTTP request sent, awaiting response... 200 OK
      Length: 247955671 (236M) [application/x-java-archive]
      Saving to: ‘aliyunDBSAgentInstaller.jar’
      100%[=====================================================================================================================================================================>] 247,955,671 17.4MB/s   in 13s    
      2023-08-25 15:44:49 (17.6 MB/s) - ‘aliyunDBSAgentInstaller.jar’ saved [247955671/247955671]
    2. Select an installation language. Enter 0 for Chinese or 1 for English, and then press Enter.

      Select your language
      0  [x] chn
      1  [ ] eng
      Input selection: 
      0
    3. Enter 1 and press Enter.

      2025-03-04 17:24:43 INFO JDKChecker - java.home: /usr/lib/jvm/java-1.8.0-openjdk-1.8.0.432.b06-2.0.2.1.al8.x86_64/jre
      2025-03-04 17:24:43 INFO IdentifierGenerator - use defined variable region: cn-hangzhou
      2025-03-04 17:24:43 INFO IdentifierGenerator - Alibaba Cloud Linux#ca7c6767-57c2-484d-9fb6-807e385297bb#0F81FBFF006006A6#Intel64 Family 6 Model 106 Stepping 6#32
      ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
      Welcome
      ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
      Welcome to the Aliyun DBS Agent 0.0.144 installer!
      Homepage: [International site: https://www.alibabacloud.com/en/product/database-backup | China site: https://www.aliyun.com/product/dbs]
      Press 1 to continue, 2 to quit, 3 to redisplay
      1
    4. Enter 1 to accept the gateway agreement and press Enter.

      Press 1 to accept, 2 to reject, 3 to redisplay
      1
    5. Select a component to install. Enter Y for the backup gateway (Agent) or N for the proxy gateway (database gateway DG). In this example, enter Y and press Enter.

      ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
      Component selection
      ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
      -----
      Agent
      -----
      Enter Y for Yes, N for No: 
      Y
      DG Not Selected
      Done!
      Note

      This example shows how to install a backup gateway to connect to a local database. To connect to data on a bastion host, enter N in this step. The system then prompts you to install the database gateway (DG). Enter Y to confirm. For more information, see Backup gateway in a bastion host architecture.

    6. Enter 1 and press Enter.

      Press 1 to continue, 2 to quit, 3 to redisplay
      1
    7. Select an installation path. Press Enter to use the default path /usr/local/aliyun/dbs_agent. To specify a custom path, enter the full path. This example uses the default path.

      If the following message appears, a backup gateway is already installed. Enter Y and press Enter to proceed. Note: This operation overwrites the existing backup gateway.

      ---------------------------
      Warning!
      The directory already exists! This may overwrite existing files. Are you sure you want to install here?
      ---------------------------
      Enter Y for Yes, N for No: 
      Y
      Press 1 to continue, 2 to quit, 3 to redisplay
      1
    8. Confirm the installation path. Enter O to confirm or C to cancel, and then press Enter.

      The destination directory will be created in :
      /usr/local/aliyun/dbs_agent
      --------------------------------------
      Enter O for OK, C to Cancel: 
      O
    9. Confirm the region of the backup gateway. The default region is China (Hangzhou). Press Enter to confirm.

      ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
      User information
      ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
      Agent Region:
      0  [x] China (Hangzhou)
      1  [ ] China (Shanghai)
      2  [ ] China (Beijing)
      3  [ ] China (Hong Kong)
      4  [ ] China (Shenzhen)
      5  [ ] China (Qingdao)
      6  [ ] US (Silicon Valley)
      7  [ ] US (Virginia)
      8  [ ] Germany (Frankfurt)
      9  [ ] Australia (Sydney)
      10  [ ] China (Hohhot)
      11  [ ] China (Zhangjiakou)
      12  [ ] Singapore
      13  [ ] Japan (Tokyo)
      14  [ ] China (Chengdu)
      15  [ ] China (Nanjing-Local) (Phasing Out)
      16  [ ] China (Fuzhou-Local) (Phasing Out)
      17  [ ] Malaysia (Kuala Lumpur)
      18  [ ] Indonesia (Jakarta)
      19  [ ] UAE (Dubai)
      20  [ ] UK (London)
      21  [ ] India (Mumbai)
      22  [ ] China East 1 Finance (Hangzhou)
      23  [ ] China East 2 Finance (Shanghai)
      24  [ ] China South 1 Finance (Shenzhen)
      25  [ ] China (Heyuan)
      26  [ ] China (Ulanqab)
      27  [ ] Gov Cloud
      28  [ ] Thailand (Bangkok)
      29  [ ] Philippines (Manila)
      30  [ ] Korea (Seoul)
      31  [ ] Saudi Arabia (Riyadh)
      Input selection: 
                        
      Note

      Confirm that the Agent Region is the region nearest to your database. To change the region, enter the number that corresponds to the target region.

    10. Enter a valid Alibaba Cloud AccessKey pair and press Enter. If the AccessKey pair is invalid, the installation fails.

      Alibaba Cloud AccessKey pair (Ensure that the account has been granted the AliyunDBSFullAccess and AliyunOSSFullAccess permissions)
      AccessKey ID: [] 
      yourAccessKeyID
      Access Key Secret: [] 
      yourAccessKeySecret
    11. (Optional) Enter information about the proxy gateway (database gateway DG). This step is required only in a bastion host architecture. For other scenarios, you can press Enter twice to skip this step.

      Proxy gateway information (Optional, for bastion host scenarios)
      Proxy gateway IP address: [] 
      Proxy gateway port number: [9797] 
      Note

      In a bastion host architecture, you must enter the private IP address of the bastion host. The port defaults to 9797. For more information, see Backup gateway in a bastion host architecture.

    12. Enter 1 to confirm the components to install, and then enter 1 again to start the installation.

      Press 1 to continue, 2 to quit, 3 to redisplay
      1
    13. The installation takes about 1 to 5 minutes.

      ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
      Select components
      ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
      Select the packages you want to install :
        [x] Pack 'DBS Backup Gateway Base Files' required
      Done!
      Press 1 to continue, 2 to quit, 3 to redisplay
      1
      ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
      Installing
      ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
      ====================
      Installation started
      Platform: linux,version=3.10.0-1160.XX.X.el7.x86_64,arch=x64,symbolicName=null,javaVersion=1.8.0_372
      [ Starting to unpack ]
      [ Processing package: DBS Backup Gateway Base Files (1/1) ]
      Cleaning up the target folder ...
      [ Unpacking finished ]
      Installation finished
      ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
      Installation complete
      ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
      Installation was successful
      Application installed on /usr/local/aliyun/dbs_agent
      [ Writing the uninstaller data ... ]
      [ Console installation done ]
  5. Return to the Add Backup Gateway page and click Complete Installation in the lower-right corner.

  6. On the Backup Gateway page, click Refresh to view the newly added backup gateway.

    The new backup gateway appears in the list. A status of Online in the Status column indicates that the backup gateway is successfully connected.

Upgrade or uninstall a backup gateway

  1. Uninstall the backup gateway and delete the dbs_agent folder.

    Linux

    1. Log on to the Linux server and run the cd /usr/local/aliyun/dbs_agent command to navigate to the default installation directory.

    2. In the installation directory, run the java -jar Uninstaller/uninstaller.jar -c command to uninstall the backup gateway. The following output indicates a successful uninstallation.

      [root@xxx          ~]# cd /usr/local/aliyun/dbs_agent
      [root@xxx          dbs_agent]# java -jar Uninstaller/uninstaller.jar -c
      Command line uninstaller.
      The uninstaller has put a log file: /tmp/izpack264516178954999826.log
      [root@xxx          dbs_agent]#
    3. Run the cd /usr/local/aliyun command to return to the parent directory.

    4. In the parent directory, run the sudo rm -rf dbs_agent command to delete the dbs_agent folder.

    Windows

    1. In Windows, uninstall AliyunDBSAgent from Programs and Features.

    2. Manually delete the dbs_agent folder.

      Note

      The default installation directory of the backup gateway is C:\Program Files\aliyun\dbs_agent.

  2. After you uninstall the backup gateway, reinstall it. For installation instructions, see Installation methods.

Proxy gateway on a bastion host

If your database is in a private network and cannot connect to the Internet, you can back up data by installing a proxy gateway on a bastion host and then installing a backup gateway on the database server. Follow these steps:

  1. Install a proxy gateway on a bastion host

  2. Install a backup gateway on a database server

Install a proxy gateway

The proxy gateway receives data from the database server hosting the backup gateway and forwards it to Database Backup Service (DBS) cloud storage over the Internet. During a restoration or download, the proxy gateway also receives data from Database Backup Service (DBS) cloud storage and forwards it to the database server.

Install a proxy gateway

This topic shows how to install a proxy gateway on a Linux bastion host. Database Backup Service (DBS) supports multiple installation methods, such as using a command-line interface (CLI) or a graphical user interface (GUI). For details on other installation methods, prerequisites, and precautions, see Add a backup gateway.

Note

To install a proxy gateway on a Windows bastion host, see Install on a Windows bastion host.

  1. Log on to Data Management Service (DMS).

  2. Move the pointer over the 2023-01-28_15-57-17.png icon in the upper-left corner and choose All Features > Security and disaster recovery (DBS) > Data Disaster Recovery (DBS) > Backup Gateway.

    Note

    If you use the DMS console in normal mode, choose Security and disaster recovery (DBS) > Data Disaster Recovery (DBS) > Backup Gateway in the top navigation bar.

  3. Click Install Backup Gateway in the upper-right corner of the page.

  4. Select a Backup Gateway Network Type, copy the installation command, and run the command on the bastion host.

    Note
    • Public Network: Access Database Backup Service (DBS) over the public network.

    • ECS Private Network/VPC: Access Database Backup Service (DBS) over Express Connect.

    1. In the Linux command-line interface (CLI), run the installation command. The system automatically downloads and runs the installation package. The output is similar to the following:

      [root@iZbp****** ~]# wget -O aliyunDBSAgentInstaller.jar https://aliyun-dbs.oss-cn-hangzhou-internal.aliyuncs.com/installer/0.0.141/aliyunDBSAgentInstaller-0.0.141.jar && sudo java -Dregion=cn-hangzhou -jar aliyunDBSAgentInstaller.jar
      --2023-08-25 16:04:52--  https://aliyun-dbs.oss-cn-hangzhou-internal.aliyuncs.com/installer/0.0.141/aliyunDBSAgentInstaller-0.0.141.jar
      Resolving aliyun-dbs.oss-cn-hangzhou-internal.aliyuncs.com (aliyun-dbs.oss-cn-hangzhou-internal.aliyuncs.com)... 100.XXX.XX.XX, 100.XXX.XX.XX, 100.XXX.XX.XX, ...
      Connecting to aliyun-dbs.oss-cn-hangzhou-internal.aliyuncs.com (aliyun-dbs.oss-cn-hangzhou-internal.aliyuncs.com)|100.XXX.XX.XX|:443... connected.
      HTTP request sent, awaiting response... 200 OK
      Length: 247955671 (236M) [application/x-java-archive]
      Saving to: ‘aliyunDBSAgentInstaller.jar’
      100%[=======================================================================================================>] 247,955,671 19.9MB/s   in 11s    
      2023-08-25 16:05:03 (21.4 MB/s) - ‘aliyunDBSAgentInstaller.jar’ saved [247955671/247955671]
    2. Select an installation language. Enter 0 for Chinese or 1 for English.

      Select your language
      0  [x] chn
      1  [ ] eng
      Input selection: 
      0
    3. Read the gateway agreement and enter 1 to continue.

      Press 1 to continue, 2 to quit, 3 to redisplay
      1
    4. Enter 1 to accept the gateway agreement.

      Press 1 to accept, 2 to reject, 3 to redisplay
      1
    5. Select a component to install. Enter Y to install the backup gateway (Agent) or N to install the proxy gateway (database gateway, DG). Since a proxy gateway is being installed in this example, enter N, and then enter Y to confirm the component.

      Enter Y for Yes, N for No: 
      N
      --
      DG
      --
      Enter Y for Yes, N for No: 
      Y
      Done!
    6. Enter 1 to continue the installation.

      Press 1 to continue, 2 to quit, 3 to redisplay
      1
    7. Select an installation path. Press Enter to use the default path /usr/local/aliyun/dbs_agent.

      To install the gateway in a custom path, enter the target path and enter 1 to confirm. This example uses the custom directory /usr/local/aliyun/daili_dbs_agent.

      Select installation path : [/usr/local/aliyun/dbs_agent] 
      /usr/local/aliyun/daili_dbs_agent
      Press 1 to continue, 2 to quit, 3 to redisplay
      1
    8. Confirm the component selection and enter 1 to start the installation.

      Wait for the installation to complete, which takes 1 to 5 minutes.

      Select the package that you want to install :
        [x] Pack 'Proxy Gateway Base Files' required
      Done!
      Press 1 to continue, 2 to quit, 3 to redisplay
      1
      ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
      Installing
      ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
      ====================
      Installation started
      Platform: linux,version=3.10.0-1XXX.XX.X.el7.x86_64,arch=x64,symbolicName=null,javaVersion=1.8.0_372
      [ Starting to unpack ]
      [ Processing package: Proxy Gateway Base Files (1/1) ]
      Cleaning up the target folder ...
      [ Unpacking finished ]
      Installation finished
      ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
      Installation finished
      ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
      Installation was successful
      Application installed on /usr/local/aliyun/daili_dbs_agent
      [ Writing the uninstaller data ... ]
      [ Console installation done ]
  5. Run the following command to verify that the proxy gateway was installed successfully:

    ps aux | grep app_aliyun_proxy

    The following output indicates that the process is running normally and the proxy gateway is installed successfully. If you encounter errors that you cannot resolve, contact support in the Database Backup Service (DBS) DingTalk group (ID: 35585947).

    [root@iZbp****** ~]# ps aux | grep app_aliyun_proxy
    root     1****  0.0  0.5 7*****  9*** ?        Ssl  16:06   0:00 /usr/local/aliyun/daili_dbs_agent/dist/app_aliyun_proxy/app_aliyun_proxy -addr :9797 -logdir /usr/local/aliyun/daili_dbs_agent/logs
    root     2****  0.0  0.0 1*****   9** pts/1    S+   16:08   0:00 grep --color=auto app_aliyun_proxy

  6. After you install the proxy gateway on the bastion host, install a backup gateway on the database server to back up data. For more information, see Install a backup gateway.

Backup gateway commands in Linux

Run the following commands to manage the backup gateway in Linux.

  • To start the backup gateway, run /usr/local/aliyun/dbs_agent/bin/aliyun-dbs-agent.sh start.

  • To stop the backup gateway, run /usr/local/aliyun/dbs_agent/bin/aliyun-dbs-agent.sh stop.

  • To restart the backup gateway, run /usr/local/aliyun/dbs_agent/bin/aliyun-dbs-agent.sh restart.

  • To uninstall the backup gateway, run java -jar Uninstaller/uninstaller.jar -c in the installation directory.

FAQ

  • Why do I receive a permission error when I back up an SQL Server database?

    solution: To resolve this issue, grant the sysadmin server role to the NT AUTHORITY\SYSTEM account. You can run the following SQL command or use the GUI to grant the role:

    • SQL command

      ALTER SERVER ROLE [sysadmin] ADD MEMBER [NT AUTHORITY\SYSTEM]
      GO
    • GUI

  • Does the backup gateway name or creation time change after upgrading or reinstalling the backup gateway, or changing the operating system?

    • Upgrading or reinstalling the backup gateway does not change its name or creation time if the hardware environment, such as the CPU model and MAC address, remains the same.

    • Changing to a different type of operating system changes the gateway name and creation time.

      Note

      For example, if you change the operating system from CentOS 7.9 to Alibaba Cloud Linux 3.2104 LTS, the gateway name and creation time will change.

    • Reinstalling a different version of the same operating system does not change the gateway name or creation time.

      Note

      For example, if you reinstall the operating system and change from CentOS 7.9 to CentOS 8.5, the gateway name and creation time do not change.

  • What do I do if my backup gateway is affected by the Log4j vulnerability?

    solution: Some earlier versions of the backup gateway have the Log4j vulnerability. For more information, see [Vulnerability Notice] Apache Log4j2 Remote Code Execution Vulnerability (CVE-2021-44228/CVE-2021-45046). If you use a backup gateway with a version earlier than 0.0.129, upgrade it to the latest version as soon as possible and re-associate it with your physical backup schedule. For upgrade instructions, see Upgrade a backup gateway.

  • Why might a successfully installed backup gateway not appear on the Backup Gateways page?

    • The backup gateway may not be started. See Steps 5 and 6 in Install by using the GUI to start the gateway.

    • The gateway's installation region does not match the region selected in the console.

    • The agent log contains errors, such as an incorrect AccessKey pair.

    • The backup gateway list is not refreshed. On the Backup Gateways page, click Refresh to view the new backup gateway.

  • Why does a backup gateway appear offline in the console after a successful installation?

    • The backup gateway may not be started. See Steps 5 and 6 in Install by using the GUI to start the gateway.

    • The gateway's installation region does not match the region selected in the console.

    • The gateway is offline due to network connectivity or routing issues.

    • The JRE or JDK version installed on the server may be unsupported. See the Prerequisites section and install JRE 1.8 or JDK 8u261 from the official website.

  • Where can I find the backup gateway logs on a Linux system?

    By default, the logs are in the /usr/local/aliyun/dbs_agent/logs directory.