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.

Prerequisites

  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.

Step-by-step instructions

  1. Verify Checksums (Optional but Recommended):

    Compare the provided checksum file with your downloaded parts using:

sha256sum files.tar.gz.part*

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

    Replace N with the total number of parts you received.

  2. Extract the Consolidated File:

    Extract the .tgz file using:

    tar zxvf consolidated.tgz

  3. Troubleshooting Extraction Errors:

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

    tar zxvf consolidated.tgz

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

    bashCopy codegzip -t consolidated.tgz

Common issues and solutions

  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.