Backup
IBM Storage Protect (also referred to as TSM for Tivoli Storage Manager) is a storage service on disk (for the primary copy) and on magnetic tape (for the secondary copy) that provides regular data backup. The HOME and THRONG directories accessible from the CC-IN2P3 interactive servers and compute nodes are automatically backed up every day.
Users and experiments also have the option to request a backup on specific storage areas by contacting the user support.
The software for the backup service provided by CC-IN2P3 is IBM Storage Protect. Please take a moment to read the document describing the service terms of use (French only).
Installation
The client/server compatibility matrix of IBM supported versions is described in the official documentation.
Please find here the most recent Storage Protect client provided by IBM.
The installation and configuration procedure is given below:
For Linux systems such as RedHat and Debian, please refer to the notes below:
For Debian-based machines, you will need to:
install the packages
gskcrypt64
,gskssl64
,tivsm-api64
andtivsm-ba
,add the line
/usr/local/ibm/gsk8_64/lib64
to the file/etc/ld.so.conf.d/ibm-tsm.conf
,run the
ldconfig
command.
Use the Storage Protect client
Note
To install the Storage Protect client on non-Red-Hat like Unix systems, please contact your IT administrators.
To run the Storage Protect client in interactive mode, simply use the command dsmc
(ou dsmc.exe
).
The prompt Protect>
indicates that you are in the TSM interactive shell.
- Command line interface
- Change your password
- Check the management classes available
- Check the options enabled
- Check the list of inclusion/exclusion filters
- Check the FileSpaces assigned to my backup node
- Backup a directory
- Backup a file
- Preview a directory contents as will be backed up
- Check the backed up files and their state
- Restore the last version of a file
- Restore the last version of a directory and its contents
- Restore an older file version using a date
- Restore data between two dates
- Restore a list of files
- Get a report on installation and configuration
Practical issues
Troubleshooting for dsmc client
If you receive the following error message:
ANS1695E The certificate is not valid
On the default installation:
% cd /opt/tivoli/tsm/client/ba/bin
delete the following files:
% rm dsmcert.idx dsmcert.kdb dsmcert.sth
then restart a backup using the
dsmc
command.
For any questions, please contact the user support.
Backup statistics
Detailed statistics per laboratory can be obtained by querying the API at https://tsmlabapi.in2p3.fr. For any access request to the API please contact the user support.
Please find below the different types of information returned according to query level:
the date of the last update for the data given in the Unix timestamp format,
statistics for the entire laboratory,
statistics for a given node in the laboratory,
statistics for a given filespace in a specific node in the laboratory.
the lab name,
the total number of backup nodes assigned to this lab,
the total number of lab files available in the backup system (primary copy + secondary copy),
the total used space in bytes for the lab backup in the backup system (primary copy + secondary copy),
the list of the backup nodes assigned to this lab,
the total space in Bytes occupied by the backup of this laboratory in the backup system (primary copy + secondary copy).
the node name,
the total number of files in this node available in the backup system (primary copy + secondary copy),
the total used space in Bytes for the node backup in the backup system (primary copy + secondary copy),
the list of users registered as official contact for this node (users that will be contacted if necessary by CC-IN2P3 backup administrators),
the last access date to this node, given in timestamp Unix format,
the number of days since the node last access to the backup system (<1 meaning that access has been made in the last 24 hours),
the list of the filespaces assigned to this node.
the filespace name,
the total number of files belonging to this filespace available in the backup system (primary copy + secondary copy),
the the total used space in bytes for this filespace backup in the backup system (primary copy + secondary copy).
API querying
Access to this API requires identifiers that must be communicated to you by the CC-IN2P3 backup service administrators.
The API provided by CC-IN2P3 is in Web Service REST form. The supported output formats (or serializer) are:
application/xml (by default)
Tools
Data generator for new tree structures backup
This generator allows to set up an exchange format when the addition to the backup of a new tree structure is requested.
Direct link: http://mirror.in2p3.fr/TSM/html/tsm-mg-generator.html;
Documentation : see here.