All Products
Search
Document Center

Data Management:Configure automatic download of backup sets

Last Updated:Jun 16, 2025

Data Disaster Recovery can use backup gateways to automatically download backup sets. This topic describes how to configure automatic download of backup sets.

Prerequisites

A backup gateway is added. Data Disaster Recovery connects to on-premises devices by using the backup gateway. For more information, see Add a backup gateway.

Pricing

Data Disaster Recovery does not charge a fee for network traffic that is generated when you manually download a backup set.

Limits

Note

Before you download a backup set, check its validity period. The download process takes an amount of time. If the backup set that you want to download is about to expire, we recommend that you extend the retention period of the backup set in advance to prevent data from being automatically deleted during the download process. After the backup set is downloaded, you can change its retention period to the original setting. For more information, see Modify the lifecycle of a backup schedule.

Item

Logical backup

Physical backup

Backup destination storage type

Only Data Disaster Recovery built-in storage is supported. Object Storage Service (OSS) buckets are not supported.

Only Data Disaster Recovery built-in storage is supported. OSS buckets are not supported.

Full data

The following types of databases are supported:

  • MySQL

  • SQL Server

  • MariaDB

  • PostgreSQL

  • Oracle

  • MongoDB

Note

MongoDB data is in the JSON format. Other data is in the CSV format.

The following types of databases are supported:

  • MySQL

  • SQL Server

Note
  • MySQL data is in the same format as the data generated by using Percona XtraBackup and is compressed.

  • SQL Server data is in the same format as the data generated by using the native backup command and is compressed.

Incremental data

The following type of database is supported:

MySQL

Note

Data is in the native format of MySQL.

The following types of databases are supported:

  • MySQL

  • SQL Server

Note

Data is in the same format as its full data.

Procedure

  1. Log on to Data Management (DMS) V5.0.

  2. In the top navigation bar, choose Security and Specifications (DBS) > Data Disaster Recovery (DBS) > Backup Plan.

    Note

    If you use the DMS console in simple mode, move the pointer over the 2023-01-28_15-57-17.png icon in the upper-left corner of the DMS console and choose All Features > Security and Specifications (DBS) > Data Disaster Recovery (DBS) > Backup Plan.

  3. Find the backup schedule that you want to manage and click the schedule ID or Manage in the Actions column.

    管理按钮

  4. On the Configure Task page, click Set backup set download rules in the Backup set download section.

    Note

    If the database engine of a backup schedule does not support the download of backup sets or the destination storage type is not Data Disaster Recovery built-in storage, the Set backup set download rules button is unavailable in the console.

  5. In the Set backup set download rules panel, configure the parameters that are described in the following table.

    Parameter

    Description

    Automatic download status

    Specifies whether to enable automatic download. Select Enable.

    Target type

    By default, the parameter is set to the directory of the server on which the backup gateway is installed.

    Backup Gateway

    The backup gateway that is used by Data Disaster Recovery to connect to the on-premises device. For more information, see Install a backup gateway.

    Important

    The feature for automatical download of backup sets is not yet commercially available and does not ensure stable performance. To prevent data accumulation and other exceptions, we recommend that you do not use the same backup gateway to download the backup data of multiple backup schedules.

    Target location

    The type of the location and the corresponding directory to which the backup set is downloaded. Valid values:

    • Server directory

    • FTP direction

    • NAS direction

    • Minio direction

    Full data format

    This parameter is automatically configured by the system and cannot be modified.

    Note

    For more information about the data format of full and incremental backup sets, see the "Feature limits and formats" section of the Overview topic.

    Incremental data format

    This parameter is automatically configured by the system and cannot be modified.

  6. Click OK.

    After you configure the feature for automatical download of backup sets, Data Disaster Recovery does not trigger the automatic download rule to download the historical backup data. Data Disaster Recovery triggers the automatic download rule only when new full or incremental backup data is generated.

  7. (Optional) After the download is complete, you can refer to the following operations to decompress the downloaded file:

    zip

    1. Run the unzip <Download task ID>.zip command.

      If your database contains a large amount of duplicate data or a large volume of data, you may encounter the error: invalid zip file with overlapped components (possible zip bomb) error during decompression. In this case, you need to set the environment variable UNZIP_DISABLE_ZIPBOMB_DETECTION=TRUE. Example: UNZIP_DISABLE_ZIPBOMB_DETECTION=TRUE unzip 1iyq***m42.zip.

      Note

      On Windows, you can directly decompress the file.

    2. Optional.If an XB file exists after you perform the preceding steps, you must download the tool and run the following commands to decompress the file.

      Download xbunpack.exe for Windows or xbunpack for Linux.

      • Windows

        Run the xbunpack.exe -file=<Download task ID>.xb -dir=/<Destination storage directory> command to decompress the file.

      • Linux

        Method 1: Run the xbunpack -file=<Download task ID>.xb -dir=/<Destination storage directory> command to decompress the file.

        Method 2: Run the cat <Download task ID>.xb | ./xbunpack -dir=/<Destination storage directory> command to decompress the file.

        Note

        The xbunpack tool requires executable permissions. You can use the chmod +x xbunpack command to grant permissions.

    tar.gz

    1. Run the gzip -d <Download task ID>.tar.gz command to obtain the <Download task ID>.tar file.

      Note

      On Windows, you can directly decompress the file.

    2. Run the file <Download task ID>.tar command to view the file format after the gzip command is run:

      • If the file format is POSIX tar archive, run the tar xvf <Download task ID>.tar command to obtain the file.

      • If the file format is Zip archive data, at least v2.0 to extract, run the unzip <Download task ID>.tar command to obtain the file.

      • If the file format is data, run the unzip <Download task ID>.tar command to obtain the <Download task ID> file.

    3. Optional. If an XB file exists after you perform the preceding steps, you must download the tool and run the following commands to decompress the file.

      • Windows

        Run the xbunpack.exe -file=<Download task ID>.xb -dir=/<Destination storage directory> command to decompress the file.

      • Linux

        Note

        The downloaded xbunpack tool requires executable permissions. You can use the chmod +x xbunpack command to grant permissions.

        Method 1: Run the ./xbunpack -file=<Download task ID>.xb -dir=/<Destination storage directory> command to decompress the file.

        Method 2: Run the cat <Download task ID>.xb | ./xbunpack -dir=/<Destination storage directory> command to decompress the file.

      Download xbunpack.exe for Windows or xbunpack for Linux.

What to do next

View the download progress of backup sets: You can view the download progress of backup sets in the console.