SQWareProduction:mssql:bin:sqwmsq RestoreAllDatabases.ksh : Différence entre versions

Version actuelle datée du 2 juillet 2021 à 15:38

Sommaire

1 Presentation
2 Aide en ligne
3 Traitement de l'erreur
- 3.1 Erreurs de parse des arguments
- 3.2 Execution errors
4 Exemples d'utilisation

Presentation

Script $gvsqw_MsqBin/sqwmsq_RestoreAllDatabases.ksh :

Execution de sqwmsq_RestoreDatabase.ksh en mode parallele
Vous pouvez choisir:

Le degre de parallelisme
Aggressivite de lancement (nombre de secondes entre deux lancements)
Aggressivite de check de fin (nombre de secondes entre deux check de fin)

Filtres de generation de la liste des databases (vous pouvez tous les mixer):

Liste d'inclusion de database
Liste d'exclusion de database
Clause d'inclusion de type like
Clause d'exclusion de type like
Clause where

Aide en ligne

L'aide en ligne est accessible dans la plupart des scripts avec l'option -h.
Ex: $gvsqw_MsqBin/sqwmsq_RestoreAllDatabases.ksh -h
Contenu de l'aide :

Sourcing sqwmsq_Global.lib v2024.07 SQWareProduction for MsSql (dbSQWare) ... 

Utilisation: sqwmsq_RestoreAllDatabases.ksh [-h] -I <FreeTdsAlias> [+ options]

DESCRIPTION
   sqwmsq_RestoreAllDatabases.ksh restore de toutes les bases de donnees en parallele
SUPPORT
   MsSql versions supportees: 2000 <= v <= 2022

PARAMETERS
     -I   Instance      : Instance cible (freeTds alias) a restaurer.
OPTIONS
     -h                 : Affichage de l'aide complete.
     -s                 : Affichage des exemples d'utilisation.
     -P   Nb_threads    : Nombre de threads en parallele (par defaut 4).
     -BP  path          : Chemin des sauvegardes a restaurer (par defaut: 'HKEY_LOCAL_MACHINE', 'BackupDirectory').
     -ID  listdb        : Liste des bases de donnees a inclure.
     -ED  listdb        : Liste des bases de donnees a exclure.
     -IL  likeclause    : Clause d'inclusion de type like pour generer la liste des bases de donnees (exemple: 'db%').
     -EL  likeclause    : Clause d'exclusion des bases de donnees de type like (exemple: 'nodb%').
     -WCD whereclause   : Clause where pour generer la liste des databases.
     -PAR parfile       : Parfile a utiliser.
     -AGR Nb_sec        : Nombre de secondes entre deux lancements (par defaut 5s).
     -AGE Nb_sec        : Nombre de secondes entre deux check de fin (par defaut 20s).
     -FRT return_code   : Valeur forcee du code retour sur erreur.
     -REP               : Reprise des backups en echec (prend la main sur les autres options).
     -Move              : Generer une instruction de deplacement.
     -Type    type      : Type de restauration full,diff (par defaut full).
     -Rename  listolddb : Nom d'origine de la liste des bases de donnees a restaurer (doit etre utilise avec -ID).
     -AddMail   email   : Adresse Email a ajouter a 'pmexpdba@gmail.com'.
     -SendReport        : Envoi du rapport d'execution.
     -NoMail            : Desactive l'envoi de mail sur erreur a pmexpdba@gmail.com (par defaut, envoi sur erreur).
     -Locale    locale  : Force la Locale d'affichage de l'aide (fr,en).
     -Exec              : Execute les commandes generees (par defaut, affiche les commandes generees).

Information:
Pour etre sur d'avoir une aide a jour, reportez vous directement a l'aide en ligne du script avec l'option -h .

Traitement de l'erreur

Erreurs de parse des arguments

Ce type de message est genere:

Lack 'FreeTdsAlias' parameter, Utilisation: sqwmsq_RestoreAllDatabases.ksh [-h] -I <FreeTdsAlias> [+ options]

Si vous vous connectez via un terminal, aucun mail ne sera envoyé et vous aurez plutôt ce type de message:

Not sending mail because you are in connected mode !!!
Lack 'FreeTdsAlias' parameter

Si vous n'êtes pas connecté à un terminal, le message d'erreur apparaît et est envoyé par mail à l'adresse contenue dans la variable $gvsqw_GlobalMail (Voir l'aide pour personnaliser cette variable). L'objet commence toujours par "$gvsqw_MailMsg_mssql : " (Voir l'aide pour personnaliser cette variable).

Information:
L'envoi de mail peut être désactivé par l'option -NoMail pour une exécution.

Execution errors

Que vous soyez ou non connecté à un terminal, le message d'erreur apparaît et un mail contenant un résumé des erreurs de traitement est envoyé à l'adresse contenue dans la variable $gvsqw_GlobalMail (Voir l'aide pour personnaliser cette variable). L'objet commence toujours par "$gvsqw_MailMsg_mssql : " (Voir l'aide pour personnaliser cette variable).

Information:
L'envoi de mail peut être désactivé par l'option -NoMail pour une exécution.

Exemples d'utilisation

Sourcing sqwmsq_Global.lib v2024.07 SQWareProduction for MsSql (dbSQWare) ... 

#Standard (Locale) help for script sqwmsq_RestoreAllDatabases.ksh:


$gvsqw_MsqBin/sqwmsq_RestoreAllDatabases.ksh -h
#Affichage de l'aide en ligne pour ce script

$gvsqw_MsqBin/sqwmsq_RestoreAllDatabases.ksh -Locale fr -h
#Affichage de l'aide en ligne pour ce script avec forcage de la locale 'fr' (Locale par defaut geree par $gvsqw_Locale)

$gvsqw_MsqBin/sqwmsq_RestoreAllDatabases.ksh -s
#Affichage des exemples d'utilisation pour ce script

$gvsqw_MsqBin/sqwmsq_RestoreAllDatabases.ksh -I $Alias
#Genere les commandes mais ne les execute pas !

$gvsqw_MsqBin/sqwmsq_RestoreAllDatabases.ksh -I $Alias -Exec
#Execute le script sqwmsq_RestoreDatabase.ksh pour restaurer les backups de toutes les databases

$gvsqw_MsqBin/sqwmsq_RestoreAllDatabases.ksh -I $Alias -BP <path> -Exec
#Chemin <path> des backups a restaurer (par defaut: 'HKEY_LOCAL_MACHINE', 'BackupDirectory')

$gvsqw_MsqBin/sqwmsq_RestoreAllDatabases.ksh -I $Alias -PAR <parfile> -Exec
#Reconstruit les indexes en ajoutant les parametres contenu dans le fichier <parfile>

$gvsqw_MsqBin/sqwmsq_RestoreAllDatabases.ksh -I $Alias -REP -Exec
#Retente les sauvegardes qui ont echoue (prend la main sur les autres options)

$gvsqw_MsqBin/sqwmsq_RestoreAllDatabases.ksh -I $Alias -Move -Exec
#Restaure les databases en deplacant l'emplacement des fichiers 

$gvsqw_MsqBin/sqwmsq_RestoreAllDatabases.ksh -I $Alias -Rename <listolddb> -Exec
#Renomme les databases a restaurer (doit etre utilise avec -ID)

$gvsqw_MsqBin/sqwmsq_RestoreAllDatabases.ksh -I $Alias -Type <TypeRestore> -Exec
#Change le type de backup (full,diff)

$gvsqw_MsqBin/sqwmsq_RestoreAllDatabases.ksh -I $Alias -AGR 20 -Exec
#Reglage du temps d'attente en secondes entre deux lancements de commandes, 20s ici

$gvsqw_MsqBin/sqwmsq_RestoreAllDatabases.ksh -I $Alias -AGE 30 -Exec
#Reglage du temps d'attente en secondes entre deux check de fin, 30s ici

$gvsqw_MsqBin/sqwmsq_RestoreAllDatabases.ksh -I $Alias -ID 'DbName1,DbName2' -Exec
#Execute les commandes generees pour seulement les 2 bases de donnees specifiees

$gvsqw_MsqBin/sqwmsq_RestoreAllDatabases.ksh -I $Alias -ED 'DbName3,DbName4' -Exec
#Execute les commandes generees sauf pour les 2 bases de donnees specifiees

$gvsqw_MsqBin/sqwmsq_RestoreAllDatabases.ksh -I $Alias -IL '%_PROD' -Exec
#Clause like pour generee une liste dynamique de bases a inclure (exemple: 'dbprod%')

$gvsqw_MsqBin/sqwmsq_RestoreAllDatabases.ksh -I $Alias -EL '%_TESTS' -Exec
#Clause like pour generee une liste dynamique de bases a exclure (exemple: 'dbtest%')

$gvsqw_MsqBin/sqwmsq_RestoreAllDatabases.ksh -I $Alias -WCD '<condition>' -Exec
#Clause where pour generee une liste dynamique de bases a inclure (exemple: 'OPEN_MODE=MOUNTED')

$gvsqw_MsqBin/sqwmsq_RestoreAllDatabases.ksh -I $Alias -P <NumericValue> -Exec
#Execute le script sqwmsq_RestoreDatabase.ksh avec un degre de parallelisme de '<NumericValue>'
#Utilise par defaut la variable gvsqw_NbThreadXXX dans $gvsqw_MsqBin/../etc/sqwpg_GlobalVar.cfg
#Vous pouvez changer le defaut sur tout l'environnement si vous settez cette variable
#dans le fichier de configuration $gvsqw_MsqBin/../etc_cust/sqwpg_GlobalVar.cfg

$gvsqw_MsqBin/sqwmsq_RestoreAllDatabases.ksh -I $Alias -AddMail 'mymail1@mydomaine.com,mymail2@mydomaine.com' -Exec
#Ajoute la liste de mail a l'adresse par defaut geree par $gvsqw_GlobalMail

$gvsqw_MsqBin/sqwmsq_RestoreAllDatabases.ksh -I $Alias -SendReport -Exec
#Envoie la log par mail a la fin du traitement meme s'il n'y a pas d'erreur (par defaut, seulement en cas d'erreur)

$gvsqw_MsqBin/sqwmsq_RestoreAllDatabases.ksh -I $Alias -NoMail -Exec
#Desactive l'envoi de mail sur erreur a $gvsqw_GlobalMail (par defaut, seulement en cas d'erreur)

$gvsqw_MsqBin/sqwmsq_RestoreAllDatabases.ksh -I $Alias -FRT <NumericValue> -Exec
#Force le code retour a '<NumericValue>' sur erreur (si pas d'erreur, "exit 0"!)
#Vous pouvez aussi forcer le code retour de ce script pour tous
#si vous settez la variable d'environnement: $gvsqw_ForcedReturnCodeScript_sqwmsq_RestoreAllDatabases=<NumericValue>
#dans le fichier de configuration $gvsqw_MsqBin/../etc_cust/sqwmsq_GlobalVar.cfg

Information:
Pour être sûr que les exemples sont exacts, reportez-vous directement à l'option d'aide en ligne du script -s .

@@ Ligne 9 : / Ligne 9 : @@
 |
 <pre>
-Begining     : 2020-11-29 20:00:33
+Not sending mail because you are in connected mode !!!
-End          : 2020-11-29 20:00:34
+Lack 'FreeTdsAlias' parameter
-Duration     : 00:00:01
 </pre>
 |
 {{SQWareProduction_sqwmsq_RestoreAllDatabases.ksh_example}}
 }}

SQWareProduction:mssql:bin:sqwmsq RestoreAllDatabases.ksh : Différence entre versions

Version actuelle datée du 2 juillet 2021 à 15:38

Sommaire

Presentation

Aide en ligne

Traitement de l'erreur

Erreurs de parse des arguments

Execution errors

Exemples d'utilisation

Menu de navigation

Outils personnels

Espaces de noms

Variantes

Affichages

Plus

Rechercher

WikiFr

Général

SQWareProduction

Annexes

Outils