tsmpipe/README.md

About

TSMPIPE is a Tivoli Storage Manager (TSM) or now known as Spectrum Protect client, that enables you to take data from STDIN and store that in TSM as a BACKUP or ARCHIVE object. By using this client, you dont need to do a dump to disk process, followed by using the Spectrum Protect Backup Archive Client. (So no more consuming disk space with old dumps!)

Restoring data, is the reverse step, restoring directly back to the application from Spectrum Protect.

Using

In its simplest form, you can cat myfile.ext | tsmpipe -c [MORE OPTIONS]

Or, where an application supports "dumping" to STDOUT, you can pipe that dump into TSMPIPE. myappdump | tsmpipe -c [OPTIONS]

Getting data back is the reverse tsmpipe -x [MORE OPTIONS] > myfile

Or, back to your application tsmpipe -x [MORE OPTIONS] | myapp

This client can also calculate a digest while backuping up data (like MD5, SHA1, etc) - so that you can verify that the dump out of the application matches what goes into Spectrum Protect. For example:

myappdump > file
md5sum file
cat file | tsmpipe -cBs /example/ -f file -m md5
tsmpipe -xBs /example/ -f file > file2
md5sum file2

The MD5 calculation should match in all cases - including the MD5 printed by tsmpipe. See the build test script for more details.

Building

Building TSMPIPE is hopefully relatively easy - it's currently only tested on Linux (specifically CentOS), but it should be buildable on other Spectrum Protect supported platforms, however you may need to create an appropriate Makefile.

Here is a blog on building on Linux: https://thefrinkiac7.wordpress.com/data-protection/building-tsmpipe

Help

For help, use tsmpipe -h To test that you can connect to TSM, use tsmpipe -i