Tapestore

Find the package here: https://gitlab.plantmicrobe.de/i01-private/tapestore

Installation

Requirements:

bash (version 3.2+)
curl

With the Debian package, you can simply run

sudo apt install -y tapestore_*.deb

which makes the tapestore command available. You can test it with:

tapestore --version

In case you cloned the repository and no .deb package is available, you can run

make install

which builds and installs the package.

Setup

After installation, you also have to install all required dependencies. This can be done via:

tapestore install

The last step of the initial setup is to configure tapestore with the information for the archival server that you received from LRZ:

tapestore configure -n <NODE-NAME> -a <NODE-ADDRESS> -p <NODE-TCP-PORT>

It’s also possible to just run tapestore configure, in this case you will be prompted for the relevant information. At the end of the configuration, the data storage client will be started and you will additionally be prompted for the user id and password. Use the NODE-NAME again as user id and the password your received from LRZ. Close the client by entering quit. You can save your credentials by running

tapestore configure --save-auth

so that you don’t have to enter your password on every usage.

You must at least once authenticate successfully with the node’s

name and password before running tapestore --save-auth, otherwise you will

be locked out of the archival server.

You can check a successful installation and configuration with

tapestore status

which prints the following if everything worked:

✓ 'gskcrypt64_*.linux.x86_64.deb' installed
✓ 'gskssl64_*.linux.x86_64.deb' installed
✓ 'tivsm-api64.amd64.deb' installed
✓ 'tivsm-apicit.amd64.deb' installed
✓ 'tivsm-bacit.amd64.deb' installed
✓ 'tivsm-ba.amd64.deb' installed
✓ 'dsmc' is executable
✓ 'dsm.sys' found
✓ 'dsm.opt' found
'PASSWORDACCESS GENERATE' active

Usage

Archive data

Navigate to the directory which contains the data you want to archive. From there, run

tapestore store <DIRECTORY-TO-ARCHIVE>

You will see a list of files that are contained in your data directory that are zipped together and send to the archive server. It’s also possible to give the archive data a description with

tapestore store --description <DESCRIPTION> <DIRECTORY-TO-ARCHIVE>

Retrieve data

Check your archived data with

tapestore list

If you don’t see any archives listed, try to run the same command from

a higher point in your directory tree, i.e., run something like

cd ../../../../ and repeat the command above.

The output should look something like the following

    Size  Archive Date - Time    File - Expires on - Description
    ----  -------------------    -------------------------------
2,791  B  10/06/25   10:37:16    /home/debian/2025-10-06_super-metadata-example.tar.gz Never Test
2,787  B  10/07/25   13:55:25    /home/debian/2025-10-07_super-metadata-example.tar.gz Never Archive Date: 10/07/25

Choose one of the listed archives and run

tapestore get <ARCHIVE-NAME>

where ARCHIVE-NAME must be at least the basename of one of the listed archives, e.g., 2025-10-06_super-metadata-example.tar.gz in the example above. You can then unpack the retrieved file with

tar -xzvf <ARCHIVE-NAME>

For a list of all subcommands and options run tapestore --help or see tapestore(1).