Sauvegarde¶

Machines Unix¶

L’automatisation de la tâche de sauvegarde doit se faire côté client via cron par exemple. Veuillez vous référer à la page dediée à la mise en place d’un job cron.

Le client TSM se configure principalement au travers de deux fichiers :

/opt/tivoli/tsm/client/ba/bin/dsm.opt
/opt/tivoli/tsm/client/ba/bin/dsm.sys

Afin d’éviter qu’une mise à jour du client n’affecte la configuration que vous avez faite, nous recommandons de déporter toute la configuration de TSM dans une arborescence distincte. Nous avons pour habitude d’utiliser /var/spool/tsm.

% mkdir -p /var/spool/tsm/{etc,log,lock,bin}

% cp /opt/tivoli/tsm/client/ba/bin/dsm.{opt,sys} /var/spool/tsm/etc/

% cp /usr/share/doc/tsm-ccin2p3/etc/* /var/spool/tsm/etc/

% cat /var/spool/tsm/etc/dsm.opt
************************************************************************
* IBM Tivoli Storage Manager                                           *
*                                                                      *
* Sample Client User Options file for UNIX (dsm.opt.smp)               *
************************************************************************

*  This file contains an option you can use to specify the TSM
*  server to contact if more than one is defined in your client
*  system options file (dsm.sys).  Copy dsm.opt.smp to dsm.opt.
*  If you enter a server name for the option below, remove the
*  leading asterisk (*).

************************************************************************

* SErvername       A server name defined in the dsm.sys file

SErvername  ccin2p3

% cat /var/spool/tsm/etc/dsm.sys
************************************************************************
* IBM Tivoli Storage Manager                                           *
*                                                                      *
* Sample Client System Options file for UNIX (dsm.sys.smp)             *
************************************************************************

*  This file contains the minimum options required to get started
*  using TSM.  Copy dsm.sys.smp to dsm.sys.  In the dsm.sys file,
*  enter the appropriate values for each option listed below and
*  remove the leading asterisk (*) for each one.

*  If your client node communicates with multiple TSM servers, be
*  sure to add a stanza, beginning with the SERVERNAME option, for
*  each additional server.

************************************************************************

SErvername ccin2p3
        COMMMethod                      TCPip
        TCPPort                         1500
        NodeName                        ${NODE_NAME}
        PasswordAccess                  generate
        TCPServeraddress                ${SERVER_NAME}
        errorlogname                    "/var/spool/tsm/log/dsmerror.log"

% ln -s /var/spool/tsm/etc/dsm.{sys,opt} /opt/tivoli/tsm/client/ba/bin/

% /usr/bin/dsmc

IBM Spectrum Protect
Command Line Backup-Archive Client Interface
  Client Version 8, Release 1, Level 13.0
  Client date/time: 01/19/2023 19:38:47
(c) Copyright by IBM Corporation and other(s) 1990, 2021. All Rights Reserved.

Node Name: DEMO
Please enter your user id <DEMO>: (1)

Please enter password for user id "DEMO": (2)

Session established with server CCTSM9: Linux/x86_64
  Server Version 8, Release 1, Level 13.000
  Server date/time: 01/19/2023 19:38:49  Last access: 01/19/2023 11:56:15

Protect>

Machines Red-Hat like¶

Pour les systèmes utilisant le couple RPM, YUM, le CC-IN2P3 met à disposition un dépot permettant de maintenir vos paquets TSM dans une version connue pour être compatible avec la version utilisée sur les serveurs TSM du CC-IN2P3. Vous pouvez également récupérer les paquets TSM directement depuis le dépot officiel d’IBM pour obtenir la dernière version disponible (cf. lien ci-dessus dans la rubrique Installation).

% cat > /etc/yum.repos.d/tsm_ccin2p3.repo
name=IBM-TSM packages repository
baseurl=https://ccrepository.in2p3.fr/pulp/repos/el/all/x86_64/tsm
gpgcheck=1
gpgkey=https://ccrepository.in2p3.fr/pulp/static/tsm.gpg

% yum install tsm-ccin2p3
[...]
Dependencies Resolved

============================================================================================================================================================================================================
 Package                                              Arch                                            Version                                            Repository                                    Size
============================================================================================================================================================================================================
Installing:
 tsm-ccin2p3                                          noarch                                          2.0-0                                              tsm                                          4.9 k
Installing for dependencies:
 TIVsm-API64                                          x86_64                                          7.1.2-0                                            tsm                                           29 M
 TIVsm-BA                                             x86_64                                          7.1.2-0                                            tsm                                           62 M
 gskcrypt64                                           x86_64                                          8.0-50.40                                          tsm                                          1.2 M
 gskssl64                                             x86_64                                          8.0-50.40                                          tsm                                          6.0 M

Transaction Summary
============================================================================================================================================================================================================
Install  1 Package (+4 Dependent packages)
[...]

Description¶

Les informations retournées par cette API sont :

• la date de dernière mise à jour des données donnée au format timestamp Unix ;
• des statistiques relatives à l’ensemble du laboratoire ;
• des statistiques relatives à un noeud donné du laboratoire ;
• des statistiques relatives à un filespace donné d’un noeud spécifique du laboratoire.

Les informations retournées au niveau global du laboratoire sont :

• le nom du laboratoire ;
• le nombre total de noeuds de sauvegarde rattachés à ce laboratoire ;
• le nombre total de fichiers de ce laboratoire présents dans le système de sauvegarde (copie primaire + copie secondaire) ;
• l’espace total en Bytes occupé par la sauvegarde de ce laboratoire dans le système de sauvegarde (copie primaire + copie secondaire) ;
• la liste des noeuds de sauvegarde rattachés à ce laboratoire ;
• l’espace total en Bytes occupé par la sauvegarde de ce laboratoire dans le système de sauvegarde (copie primaire + copie secondaire).

Les informations retournées au niveau d’un noeud de sauvegarde sont :

• le nom du noeud
• le nombre total de fichiers de ce noeuds présents dans le système de sauvegarde (copie primaire + copie secondaire) ;
• l’espace total en Bytes occupé par la sauvegarde de ce noeud dans le système de sauvegarde (copie primaire + copie secondaire) ;
• la liste de personnes enregistrées comme contact officiel de ce noeud (personne que les administrateurs de sauvegarde du CC-IN2P3 contacteront en cas de besoin) ;
• la date de dernier accès de ce noeud au service de sauvegarde du CC-IN2P3, donnée au format timestamp Unix ;
• le nombre de jours comptés depuis le dernier accès de ce noeud au système de sauvegarde (<1 signifiant qu’un accès à été fait dans les dernières 24 heures) ;
• la liste des filespaces rattachés à ce noeud.

Les informations retournées au niveau du filespace d’un noeud de sauvegarde sont :

• le nom du filespace ;
• le nombre total de fichiers de ce filespace présents dans le système de sauvegarde (copie primaire + copie secondaire) ;
• l’espace total en bytes occupé par la sauvegarde de ce filespace dans le système de sauvegarde (copie primaire + copie secondaire).

Interrogation de l’API¶

L’accès à cette API nécessite des identifiants qui doivent vous être communiqués par les administrateurs du service de sauvegarde du CC-IN2P3.

L’API fournit par le CC-IN2P3 se présente sous la forme d’un Web Service REST. Les différents formats de sortie (ou serializer) supportés sont :

• application/xml (utilisé par défaut) (description Wikipédia)
• application/json (description Wikipédia)
• text/html (actuellement non supporté)
• text/x-yaml (description Wikipédia)

% curl -L -H 'Accept: application/json' -u 'username:password' https://tsmlabapi.in2p3.fr
{
    "details": {
        "generated_in": "0.66ms",
        "last_cache_update": 1406551433
    },
    "results": [
        {
            "laboratory": "CCIN2P3",
            "nodes": [
                {
                    "contacts": [
                        "no-reply@cc.in2p3.fr"
                    ],
                    "days_since_last_access": "<1",
                    "filespaces": [
                        {
                            "filespace_name": "/backup/volume1",
                            "num_files": 6,
                            "physical_b": 21
                        },
                        {
                            "filespace_name": "/backup/volume2",
                            "num_files": 6,
                            "physical_b": 21
                        }
                    ],
                    "last_access": 1406524790,
                    "node_name": "DEMO_NODE",
                    "total": {
                        "num_files": 12,
                        "physical_b": 42
                    }
                }
            ],
            "total": {
                "nodes": 1,
                "num_files": 12,
                "physical_b": 42
            }
        }
    ]
}

Détails de la clef utilisée pour les signatures¶

La clef publique utilisée pour l’ensemble des signatures numériques peut-être trouvée ici.

Détail de la clef :

pub   2048R/18877579 2012-12-05
      Key fingerprint = 1868 E312 47B4 610A CC8A  CD67 14A7 1D76 1887 7579
uid                  CC-IN2P3 TsmMaster <tsmmaster@cc.in2p3.fr>

Importation dans votre trousseau de la clef publique permettant de vérifier les signatures numériques¶

Soit ${PUBLICKEY_PATH} le chemin sous lequel vous avez sauvegardé la clef publique. Cela peut-être par exemple C:\Documents and settings\Administrator\CC-IN2P3_public_key.gpg ou encore /tmp/CC-IN2P3_public_key.gpg.

1. Vérifier le fingerprint de la clef publique :

   % gpg --with-fingerprint ${PUBLICKEY_PATH}
   pub  2048R/18877579 2012-12-05 CC-IN2P3 TsmMaster <tsmmaster@cc.in2p3.fr>
         Key fingerprint = 1868 E312 47B4 610A CC8A  CD67 14A7 1D76 1887 7579
   

2. Importation de la clef publique dans votre keyring :

   % gpg --verbose --import ${PUBLICKEY_PATH}
   gpg: armor header: Version: GnuPG v2.0.14 (GNU/Linux)
   gpg: pub  2048R/18877579 2012-12-05  CC-IN2P3 TsmMaster <tsmmaster@cc.in2p3.fr>
   gpg: using PGP trust model
   gpg: key 18877579: public key "CC-IN2P3 TsmMaster <tsmmaster@cc.in2p3.fr>" imported
   gpg: Total number processed: 1
   gpg:               imported: 1  (RSA: 1)
   

3. Modification de la confiance attribuée à la clef du service de sauvegarde du CC-IN2P3 :

   % gpg --edit "CC-IN2P3 TsmMaster"
   gpg (GnuPG) 1.4.11; Copyright (C) 2010 Free Software Foundation, Inc.
   This is free software: you are free to change and redistribute it.
   There is NO WARRANTY, to the extent permitted by law.
   
   pub  2048R/18877579  created: 2012-12-05  expires: never       usage: SC
                        trust: unknown       validity: unknown
   [ unknown] (1). CC-IN2P3 TsmMaster <tsmmaster@cc.in2p3.fr>
   
   gpg> trust
   pub  2048R/18877579  created: 2012-12-05  expires: never       usage: SC
                        trust: unknown       validity: unknown
   [ unknown] (1). CC-IN2P3 TsmMaster <tsmmaster@cc.in2p3.fr>
   
   Please decide how far you trust this user to correctly verify other users' keys
   (by looking at passports, checking fingerprints from different sources, etc.)
   
     1 = I don't know or won't say
     2 = I do NOT trust
     3 = I trust marginally
     4 = I trust fully
     5 = I trust ultimately
     m = back to the main menu
   
   Your decision? 5
   Do you really want to set this key to ultimate trust? (y/N) y
   
   pub  2048R/18877579  created: 2012-12-05  expires: never       usage: SC
                        trust: ultimate          validity: unknown
   [ unknown] (1). CC-IN2P3 TsmMaster <tsmmaster@cc.in2p3.fr>
   Please note that the shown key validity is not necessarily correct
   unless you restart the program.
   
   gpg> quit
   
   % gpg --verbose --list-key "CC-IN2P3 TsmMaster"
   gpg: using PGP trust model
   pub   2048R/18877579 2012-12-05
   uid                  CC-IN2P3 TsmMaster <tsmmaster@cc.in2p3.fr>
   

Vérification d’une signature numérique¶

Soit :

• MY_FILE.pdf le fichier dont on souhaite vérifier la signature ;

• MY_FILE.asc le fichier de signature :

  % gpg --verbose --verify MY_FILE.asc
  gpg: armor header: Version: GnuPG v2.0.14 (GNU/Linux)
  gpg: assuming signed data in `MY_FILE.pdf'
  gpg: Signature made Tue 26 Feb 2013 02:28:03 PM CET using RSA key ID 18877579
  gpg: using PGP trust model
  gpg: Good signature from "CC-IN2P3 TsmMaster <tsmmaster@cc.in2p3.fr>"
  gpg: binary signature, digest algorithm SHA1
  

Générateur de données pour la sauvegarde de nouvelles arborescences¶

Ce générateur permet de fixer un format d’échange lors des demandes d’ajout de nouvelles arborescences à votre sauvegarde.

• Lien direct : http://mirror.in2p3.fr/TSM/html/tsm-mg-generator.html ;
• Documentation d’utilisation : voir ici.