LLI Wiki — My Digital Knowledge Base

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_CLOSE est 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 *

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

Mastodon LLIMastodon SocialFosstodon