Commandes en ligne

Changer votre mot de passe

Protect> set password
Please enter password for user id "DEMO": (1)

Please enter a new password: (2)
Enter new password for verification: (3)
Password updated.

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

Il faut ici :

  • saisir le mot de passe initial qui vous a été communiqué par les administrateurs TSM du CC-IN2P3,

  • saisir votre nouveau mot de passe,

  • saisir votre nouveau mot de passe une seconde fois.

Consulter les classes de gestion disponibles

Protect> query mgmt -detail

Consulter les options utilisées

Protect> query options
[...]

              ACTIVATEKEY: YES
          AFSBACKUPMNTPNT: YES
          ALLOWWILDCARDCH: NO
                   ARCHMC:
        ARCHSYMLINKASFILE: YES
               ASNODENAME:
             ASRFILESPATH:
                  ASRMODE: NO
             AUTOFSRENAME: PROMPT
             AUDITLOGGING: OFF
             AUDITLOGNAME: /tmp/dsmaudit.log
                AUTOMOUNT:
               AUTODEPLOY: YES
                   BACKMC:
           BACKUPREGISTRY: YES
       CANDIDATESINTERVAL: 1
       CASESENSITIVEAWARE: NO
          CHANGINGRETRIES: 4
          CHECKFORORPHANS: NO
          CHECKTHRESHOLDS: 5
               CLIENTVIEW: STANDARD
         CLUSTERDISKSONLY: NO
              CLUSTERNODE: NO
               COMMMETHOD: TCP/IP
      COLLOCATEBYFILESPEC: NO
      COMMRESTARTDURATION: 60
[...]
                   DOMAIN:
                           /home
                           /etc
[...]
        VIRTUALMOUNTPOINT:
                           /home
                           /etc

Note

Pour plus d’informations sur l’utilisation des directives VirtualMountPoint ou Domain, veuillez consulter la FAQ.

Consulter les options d’inclusion/exclusion

Protect> query inclexcl
[...]

*** FILE INCLUDE/EXCLUDE ***
Mode Function  Pattern (match from top down)  Source File
---- --------- ------------------------------ -----------------
No exclude filespace statements defined.
Excl Directory /.../*no_backup*               Server
Excl Directory /.../*NO_BACKUP*               Server
Excl Directory /.../.beagle                   Server
Excl Directory /.../.[Cc]ache                 Server
Excl Directory /.../[Cc]ache.Trash            Server
Excl Directory /.../Cache                     Server
Excl Directory /usr/lib64                     Server
Excl Directory /usr/lib32                     Server
Excl Directory /usr/lib                       Server
Excl Directory /usr/bin                       Server
Excl Directory /var/lock                      Server
Excl Directory /var/run                       Server
Excl Directory /var/tmp                       Server
Excl Directory /boot                          Server
Excl Directory /lib64                         Server
Excl Directory /lib32                         Server
Excl Directory /lib                           Server
Excl Directory /sbin                          Server
Excl Directory /bin                           Server
[...]

Par exemple, la ligne suivante signifie que tout ce qui se trouve sous /bin ne sera pas sauvegardé :

Excl Directory /bin                           Server

L’information Server indique que ce filtre provient du serveur de sauvegarde (et n’est donc pas modifiable sans intervention des administrateurs TSM du CC-IN2P3).

Consulter la liste des FileSpaces rattachés au nœud de sauvegarde

Protect> query files

Sauvegarder le contenu d’un répertoire

% dsmc incremental /<chemin>/ -subdir=yes

Sauvegarder un fichier

% dsmc incremental /<chemin>/<mon fichier>

Prévisualiser le contenu d’un répertoire tel qu’il sera sauvegardé

% dsmc preview backup /<chemin>/ -subdir=yes
[...]

Preview function invoked.
Depending on the number of objects to query, this operation could take a while to complete.

Are you sure you want to continue? (Yes (Y)/No (N)) Y
Preview output has been successfully written to file '/var/spool/tsm/log/dsmprev.txt'.

Cette commande génère une liste des fichiers et répertoires dans $PWD/dsmprev.txt, et précise si Storage Protect les sauvegardera ou non. Le fichier de prévisualisation dsmprev.txt peut dans certains cas vous être demandé par les administrateurs du CC-IN2P3 afin de vous aider à résoudre vos problèmes de sauvegarde.

Consulter les fichiers sauvegardés ainsi que leur état

Dans Storage Protect, un fichier peut avoir deux états :

  • A pour Active lorsque le fichier est encore présent sur la machine qui effectue la sauvegarde ;

  • I pour Inactive lorsque le fichier n’est plus présent sur la machine effectuant la sauvegarde ou n’est plus la dernière version du fichier :

% dsmc query backup /var/spool/tsm/etc/dsm.sys -inactive
[...]

           Size        Backup Date                Mgmt Class           A/I File
           ----        -----------                ----------           --- ----
         2 206  B  20/09/2011 17:10:36              PCMGM               A  /var/spool/tsm/etc/dsm.sys
         1 929  B  01/06/2011 17:06:08              PCMGM               I  /var/spool/tsm/etc/dsm.sys
         2 010  B  18/07/2011 17:52:02              PCMGM               I  /var/spool/tsm/etc/dsm.sys
         2 178  B  19/07/2011 17:13:58              PCMGM               I  /var/spool/tsm/etc/dsm.sys

Restaurer la dernière version d’un fichier

% dsmc restore /var/spool/tsm/etc/dsm.sys /tmp/dsm.sys.restored
[...]

Restore function invoked.

 ** Interrupted **
Restoring           2 206 /var/spool/tsm/etc/dsm.sys --> /tmp/dsm.sys.restored [Done]

Restore processing finished.

Total number of objects restored:         1
Total number of objects failed:           0
Total number of bytes transferred:    2,17 KB
Data transfer time:                    0,00 sec
Network data transfer rate:        90 779,62 KB/sec
Aggregate data transfer rate:          0,02 KB/sec
Elapsed processing time:           00:01:37

Cette commande restaure la dernière version du fichier /var/spool/tsm/etc/dsm.sys à l’emplacement /tmp/dsm.sys.restored. Si aucun nouvel emplacement n’avait été spécifié, la restauration se serait faite directement dans /var/spool/tsm/etc/dsm.sys et aurait écrasé notre fichier si ce dernier existait déjà.

Restaurer la dernière version d’un répertoire et son contenu

% dsmc restore /var/spool/tsm/ -verbose -subdir=yes

Comme pour les fichiers, vous pouvez préciser un nouvel emplacement pour la restauration :

% dsmc restore /var/spool/tsm/ /tmp/tsm.restored/ -subdir=yes

Restaurer une ancienne version d’un fichier en utilisant une date

% dsmc query backup /var/spool/tsm/etc/dsm.sys -inactive -pitd=09/01/2011
[...]

           Size        Backup Date                Mgmt Class           A/I File
           ----        -----------                ----------           --- ----
         2,178  B  07/19/2011 17:13:58              PCMGM               I  /var/spool/tsm/etc/dsm.sys

L’option -pitd signifie Point In Time Date et permet de préciser une date précise pour la restauration. Dans la commande donnée en exemple, nous souhaitons voir quelle version du fichier /var/spool/tsm/etc/dsm.sys était présente dans Storage Protect le 1er septembre 2011. Le format de la date tel que spécifié dans l’option -pitd est MM/DD/YYYY (format par défaut si LANG=C).

Nous pouvons voir que le fichier /var/spool/tsm/etc/dsm.sys du 1er septembre 2011 est une version inactive du fichier qui a été sauvegardée le 19 juillet 2011 et n’avait pas été modifiée depuis. Pour la restaurer, il suffit d’utiliser l’option -pitd conjointement à la fonction de restauration de dsmc :

% dsmc restore /var/spool/tsm/etc/dsm.sys -inactive -pitd=09/01/2011

Restaurer des données entre deux dates

% dsmc restore /path/to/restore/ -fromdate=06/01/2014 -todate=06/11/2014 -subdir=yes

Restaurer une liste de fichiers

Soit le fichier to_restore.txt avec le contenu suivant :

/tmp/file1.txt
/tmp/file2.txt
[...]
/var/tmp/files/fileN.txt

Pour restaurer l’ensemble des fichiers listés dans to_restore.txt, il suffit d’utiliser l’option -filelist du client Storage Protect :

% dsmc restore -filelist=to_restore.txt
[...]

Obtenir un rapport concernant l’installation et la configuration

% dsmc query systeminfo
[...]

QUERY SYSTEMINFO output has been written to file /var/spool/tsm/etc/CCAFS/dsminfo.txt.

Le fichier dsminfo.txt généré par cette commande peut dans certains cas vous être demandé par les administrateurs du CC-IN2P3 afin de vous aider à résoudre vos problèmes de sauvegarde.