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 and tivsm-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.

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.

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:

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.

IBM official documentation