Extracting Multi-Part Data Exports

Prev Next

This guide provides step-by-step instructions on consolidating and extracting multi-part exported files provided by Rocket.Chat Cloud.


  1. Ensure you have all the .tar.gz.part files downloaded to the same directory.

  2. Use a Unix-based system (Linux, macOS, or Windows Subsystem for Linux) with standard tools like Bash, tar, and gzip installed.


  1. Verify Checksums (Optional but Recommended):

    Compare the provided checksum file with your downloaded parts using:

sha256sum files.tar.gz.part*
Bash

Ensure all parts are intact before proceeding.

  1. Merge File Parts:

    Run the following command to combine all parts into a single .tgz file:

    for i in {1..N}; do cat files.tar.gz.part$i >> consolidated.tgz; done
    
    Bash

    Replace N with the total number of parts you received.

  2. Extract the Consolidated File:

    Extract the .tgz file using:

    tar zxvf consolidated.tgz
    Bash
  3. Troubleshooting Extraction Errors:

    If you encounter errors, first check the integrity of the archive using:

    tar zxvf consolidated.tgz
    Bash

    If the issue persists, verify the integrity of the consolidated file:

    bashCopy codegzip -t consolidated.tgz
    
    Bash

  1. Checksum Mismatch: Re-download the affected parts and verify checksums again.

  2. Extraction Fails:

    • Ensure sufficient disk space is available (at least twice the size of the exported data).

    • Use the --ignore-zeros (-i) flag if encountering EOF errors.

  3. Missing Tools: Install the required tools using your system's package manager (e.g., apt, brew, or yum).

Always use the commands provided above to ensure compatibility with exported Rocket.Chat data.

If issues persists contact support with details about your system environment and errors.