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 dédié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.

Création de l’arborescence

Créer le répertoire de configuration du client TSM :

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

Copier les fichiers de configuration d’exemple d’IBM ou ceux présents dans le package tsm-ccin2p3 :

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

ou :

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

Édition des fichiers de configuration

Adresse du serveur de sauvegarde

Lors du premier contact avec les administrateurs TSM, ces derniers peuvent vous avoir attribué un alias tsm${NOM_DU_LABORATOIRE}.in2p3.fr (exemple : tsmlpnhe.in2p3.fr).

Attention

Cet alias est à utiliser impérativement. Dans certains cas, cet alias n’existe pas ou ne peut être utilisé, par exemple si vous avez des nœuds de sauvegarde sur différents serveurs TSM. Pour la suite de cette documentation ${SERVER_NAME} sera à remplacer par le nom du serveur qui vous est propre.

Identifiants de sauvegarde

Lors de votre contact avec les administrateurs TSM du CC-IN2P3, ces derniers vous ont communiqué un nom de nœud (identifiant de sauvegarde) ainsi qu’un mot de passe associé.

Attention

Pour la suite de cette documentation ${NODE_NAME} sera à remplacer par le nom de nœud qui vous est propre.

Fichier dsm.opt

Ce fichier spécifie le serveur que le client TSM cherche à contacter lorsque vous lancer votre sauvegarde :

% 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

Fichier dsm.sys

Ce fichier permet de définir les profils de sauvegarde connus de TSM :

% 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"

Attention

Attention à bien modifier la valeur de l’option NodeName ainsi que celle de l’option TCPServeraddress.

Lier le profil de sauvegarde aux répertoires IBM

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

Saisie initiale du mot de passe TSM

L’option PasswordAccess Generate du fichier de configuration dsm.sys permet au client TSM de se souvenir du mot de passe TSM utilisé pour vous authentifier sur les serveurs de sauvegarde du CC-IN2P3. Cependant lors de la première configuration, vous devez saisir ce mot de passe au moins une fois :

% /usr/bin/dsmc

IBM Storage 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>
  1. Juste appuyer sur Entrée ou saisir le nom du nœud TSM qui doit être utilisé.

  2. Entrer le mot de passe initial qui vous a été communiqué par les administrateurs TSM.

  3. Si les fichiers dsm.sys ou dsm.opt ne sont pas trouvés au démarrage de dsmc, il vous faudra indiquer le chemin vers ces fichiers dans la variable d’environnement DSM_DIR.