Sauvegarde et restauration SQL Server avec IBM TSM (tdpsqlc)
Commandes tdpsqlc d'IBM Tivoli Storage Manager pour sauvegarder, interroger et restaurer des bases SQL Server.
IBM Tivoli Storage Manager (TSM) for Databases, Data Protection for SQL Server (TDP for SQL), fournit la commande tdpsqlc pour sauvegarder et restaurer des bases SQL Server depuis la ligne de commande. Cet article regroupe les commandes courantes.
Attention : une base dont l'option
AUTO_CLOSEest activée peut provoquer des erreurs lors des sauvegardes. Désactivez-la sur les bases à sauvegarder.
Prérequis
Se placer dans le répertoire d'installation par défaut :
cd /d "C:\Program Files\Tivoli\TSM\TDPSql"
Les paramètres de connexion se passent soit par un fichier d'options TSM (/TSMOPTFile) et un fichier de configuration TDP (/CONFIGFILE), soit directement en ligne de commande. Les mots de passe ne doivent jamais être écrits en clair dans des scripts : <PASSWORD> ci-dessous est une valeur de remplacement.
Sauvegarde
tdpsqlc backup * full
tdpsqlc backup * log
tdpsqlc backup AppDb full
tdpsqlc backup AppDb log
tdpsqlc backup AppDb differential
* désigne toutes les bases. Pour exclure une base (par exemple tempdb) :
tdpsqlc.exe backup * full /sqlserver=sqlserver01 /SQLAUTH=INT /TSMOPTFile=C:\tsm\tdp_sqlserver01.opt /EXCLUDEDB=tempdb
Instance nommée, port spécifique, authentification
tdpsqlc.exe backup * full /sqlserver=sqlserver01\INST1,14330 /SQLAUTH=INT /tsmoptfile=C:\tsm\tdp_inst1.opt
tdpsqlc.exe backup * log /sqlserver=sqlserver01\INST1,14330 /SQLAUTH=INT /tsmoptfile=C:\tsm\tdp_inst1.opt
| Option | Rôle |
|---|---|
/sqlserver= |
Serveur ou instance SQL Server (serveur\instance[,port]) |
/SQLAUTH=INT |
Authentification intégrée Windows |
/SQLAUTH=SQL |
Authentification SQL (avec /SQLUSer= et /SQLPassword=) |
/tsmoptfile= |
Fichier d'options du client TSM |
/CONFIGFILE= |
Fichier de configuration TDP |
/EXCLUDEDB= |
Base(s) à exclure d'une sauvegarde * |
Depuis SQL Server avec xp_cmdshell
EXEC xp_cmdshell '"C:\Program Files\Tivoli\TSM\TDPSql\tdpsqlc.exe" backup * full /sqlserver=sqlserver01 /SQLAUTH=INT /tsmoptfile=C:\tsm\tdp_sqlserver01.opt /EXCLUDEDB=tempdb';
Avec l'authentification SQL :
tdpsqlc.exe backup * full /sqlserver=sqlserver01 /SQLAUTH=SQL /SQLUSer=app_user /SQLPassword=<PASSWORD> /tsmoptfile=C:\tsm\tdp_sqlserver01.opt /EXCLUDEDB=tempdb
Interrogation
tdpsqlc query tdp
tdpsqlc query tsm * types /all
tdpsqlc.exe query tsm AppDb /compat
tdpsqlc.exe query tsm AppDb /all
tdpsqlc.exe query tsm AppDb full /fileinfo /all
tdpsqlc.exe query sql *
query tdpaffiche la configuration de TDP for SQL.query tsm * types /allliste les sauvegardes disponibles sur le serveur TSM.query sqlliste les bases du serveur SQL./fileinfodétaille les fichiers contenus dans la sauvegarde.
Pour lister les sauvegardes d'un autre serveur (nécessaire avant une restauration croisée) :
tdpsqlc.exe query tsm * types /all /fromsqlserver=sqlserver01 /tsmoptfile=C:\tsm\tdp_sqlserver01.opt
Dans un cluster, ajoutez /CONFIGFILE et /TSMOPTFile pointant vers les fichiers propres au noeud ou à l'instance.
Restauration
Restauration d'une base sur le même serveur :
tdpsqlc.exe restore AppDb full /CONFIGFILE=C:\tsm\tdpsql_inst1.cfg /TSMOPTFile=C:\tsm\tdp_inst1.opt
Restauration d'une sauvegarde provenant d'un autre serveur (/fromsqlserver) vers un serveur cible (/SQLSERVer), avec journal d'exécution :
tdpsqlc.exe restore AppDb full /fromsqlserver=sqlserver01 /tsmoptfile=C:\tsm\tdp_restore.opt /SQLSERVer=sqlserver02 /logfile=C:\tsm\restore.log
Déplacer les fichiers vers d'autres chemins avec /relocate (noms logiques) et /to (chemins physiques) :
tdpsqlc.exe restore AppDb full /fromsqlserver=sqlserver01 /tsmoptfile=C:\tsm\tdp_restore.opt /SQLSERVer=sqlserver02 /relocate=AppDb,AppDb_log /to=D:\Data\AppDb.mdf,E:\Log\AppDb_log.ldf
Pour écraser une base existante, ajouter /REPlace. Si le support de stockage nécessite un montage, /MOUNTWait=Yes fait attendre la commande.
Exemple de sortie d'une restauration
Starting Sql database restore...
Connecting to TSM Server as node 'NODE_SQLINST1'...
Querying Tivoli Storage Manager server for a list of database backups, please wait...
Beginning full restore of backup object AppDb, 1 of 1,
to database AppDb
Restore of AppDb completed successfully.
Total database backups inspected: 1
Total database backups requested for restore: 1
Total database backups restored: 1
Total database skipped: 0
Interface graphique
Lancer tdpsql (sans le c) avec les fichiers de configuration ouvre l'interface graphique de restauration :
tdpsql /tsmoptfile=C:\tsm\tdp_restore.opt /CONFIGFILE=C:\tsm\tdpsql.cfg
Remarques
- Les noms de serveurs, instances, bases, chemins et comptes de cet article sont des exemples génériques.
- Ne jamais laisser
/SQLPasswordou/TSMPassworden clair dans un script ou un historique ; préférer l'authentification intégrée (/SQLAUTH=INT) ou un fichier d'options protégé. - Documentation de référence : IBM Spectrum Protect for Databases: Data Protection for SQL Server.