Data Management:Manually download a backup set

Limitations and formats

Billing

Downloading backup sets is currently free of charge.

Procedure

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

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

   Note

   If you use the DMS console in simple mode, move the pointer over the icon in the upper-left corner of the DMS console and choose All Features > Security and disaster recovery (DBS) > Data Disaster Recovery (DBS) > Backup Plan.

3. Find the target backup schedule and click its ID or click Manage in the Manage column.

4. In the left-side navigation pane, choose Backup Tasks > Full Data.

   Note

   • If the database engine supports downloading incremental data and you have enabled transaction log backup for the backup instance, you can also download transaction log backup sets.

   • The download process for a Transaction Log Backup is similar to that for a Full Data backup. To start, choose Backup Tasks > Transaction Log Backup.

5. In the Actions column for the target Backup Set ID, click Download.

6. In the dialog box that appears, click OK.

   After you click OK, the system packages, compresses, and converts the backup file into a downloadable format. The system then redirects you to the Backup Set Download details page.

   Note

   The time required to compress and convert the backup file depends on its size. For example, a 150 GB file can take about 4 hours to process.

7. When the Status of the download task changes to Completed, click Download.

8. In the panel that appears, select a download method.

   • I see. Downloads: Starts the download in your browser.

   • Copy public network address

     • Windows

       Open a browser, paste the copied address into the address bar, and press Enter to start the download.

     • Linux

       Download command: wget "<copied_download_link>" -O <download_task_id>.zip

       Example: wget "https://dbs-backup-137***50-cn-hangzhou-ubj5***gisz.oss-cn-hangzhou.aliyuncs.com/shsw*****lIAA%3D" -O vf0x****ilo4.zip

   • Copy internal network address

     • Windows

       Open a browser, paste the copied address into the address bar, and press Enter to start the download.

     • Linux

       Download command: wget "<copied_download_link>" -O <download_task_id>.zip

       Example: wget "https://dbs-backup-137***50-cn-hangzhou-ubj5***gisz.oss-cn-hangzhou.aliyuncs.com/shsw*****lIAA%3D" -O vf0x****ilo4.zip

9. (Optional) After the download is complete, decompress the file.

   Zip file

   Use the following command to decompress the file from the command line:

   1. Run the unzip <download_task_id>.zip command.

      If your database contains a large amount of duplicate or voluminous data, the error: invalid zip file with overlapped components (possible zip bomb) error may occur during decompression. To resolve this, set the UNZIP_DISABLE_ZIPBOMB_DETECTION=TRUE environment variable. For example: UNZIP_DISABLE_ZIPBOMB_DETECTION=TRUE unzip 1iyq***m42.zip.

      Note

      On a Windows system, you can decompress the file directly.

   2. Optional: If the previous step produces a .xb file, download the required tool and run the following command to decompress it.

      To obtain the tool, click xbunpack.exe (for Windows systems) or xbunpack (for Linux systems).

      • Windows

        Run the xbunpack.exe -file=<download_task_id>.xb -dir=/<destination_directory> command to obtain the decompressed file.

      • Linux

        Method 1: Run the ./xbunpack -file=<download_task_id>.xb -dir=/<destination_directory> command to obtain the decompressed file.

        Method 2: Run the cat <download_task_id>.xb | ./xbunpack -dir=/<destination_directory> command to obtain the decompressed file.

        Note

        The xbunpack tool requires execute permissions. You can run the chmod +x xbunpack command to grant the permissions.

   .tar.gz file

   1. Run the gzip -d <download_task_id>.tar.gz command to obtain the <download_task_id>.tar file.

      Note

      On a Windows system, you can decompress the file directly.

   2. Run the file <download_task_id>.tar command to check the file format:

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

      • If the 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 format is data, run the unzip <download_task_id>.tar command to obtain the <download_task_id> file.

   3. Optional: If you obtain a .xb file after completing the previous step, you must download the appropriate tool and run the following command to decompress the file.

      • Windows

        Run the xbunpack.exe -file=<download_task_id>.xb -dir=/<destination_directory> command to obtain the decompressed file.

      • Linux

        Note

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

        Method 1: Run the ./xbunpack -file=<download_task_id>.xb -dir=/<destination_directory> command to obtain the decompressed file.

        Method 2: Run the cat <download_task_id>.xb | ./xbunpack -dir=/<destination_directory> command to obtain the decompressed file.

      To obtain the tool, click xbunpack.exe (for Windows systems) or xbunpack (for Linux systems).

   .tar.zst file

   • Use the following command to decompress the file from the command line:

     # Decompress <archive_name>.tar.zst to <destination_path>
     # zstd: -d=decompress, -c=output to stdout
     # tar:  -x=extract, -v=verbose, -f-=read from stdin, -C=specify target directory
     zstd -d -c <archive_name>.tar.zst | tar -xvf - -C <destination_path>

     Note

     Windows does not natively support the zstd command-line tool. For GUI-based decompression, use 7-Zip with a zstd plug-in or PeaZip. To use the command line on Linux or macOS, install zstd using the command for your operating system:

     • macOS (using Homebrew): brew install zstd

     • CentOS/RHEL: sudo yum install zstd

     • Ubuntu/Debian: sudo apt install zstd

   • Optional: If the previous step produces a .xb file, download the required tool and run the following command to decompress it.

     To obtain the tool, click xbunpack.exe (for Windows systems) or xbunpack (for Linux systems).

     • Windows

       Run the xbunpack.exe -file=<download_task_id>.xb -dir=/<destination_directory> command to obtain the decompressed file.

     • Linux

       Method 1: Run the ./xbunpack -file=<download_task_id>.xb -dir=/<destination_directory> command to obtain the decompressed file.

       Method 2: Run the cat <download_task_id>.xb | ./xbunpack -dir=/<destination_directory> command to obtain the decompressed file.

       Note

       The xbunpack tool requires execute permissions. You can run the chmod +x xbunpack command to grant the permissions.