SQWareProduction:sybase:bin:sqwsyb DumpDatabase.ksh

De WikiFr_dbSQWare
Aller à : navigation, rechercher

Presentation

Script $gvsqw_SybBin/sqwsyb_DumpDatabase.ksh :


Genere un dump database
Vous pouvez choisir type de dump (par defaut full):

  • full -> Dump full
  • inc -> Dump tran
  • stb -> Dump tran for standby
  • fstb -> Dump full plus dump tran for standby


Le script determine automatiquement le nombre de stripes
Realise le backup de master..syslogins (permet la synchronisation au chargement)
Realise la purge des generations de dump
Vous pouvez changer les valeurs par defaut:

  • compression level
  • force le nombre de stripes
  • taille max d'un stripe
  • nombre de generations de dumps a garder



Aide en ligne

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

Sourcing sqwsyb_Global.lib v2024.02 SQWareProduction for Sybase (dbSQWare) ... 

Utilisation: sqwsyb_DumpDatabase.ksh [-h] -I <dataserver> [+ options]

DESCRIPTION
   sqwsyb_DumpDatabase.ksh dump $DumpType
SUPPORT
   Sybase versions supportees: 12.5 <= v <= 16.0

PARAMETERS
     -I  dataserver     : Dataserver cible.
     -D  database       : Base de donnes cible.
OPTIONS
     -h                 : Affichage de l'aide complete.
     -s                 : Affichage des exemples d'utilisation.
     -NS Nb stripe      : Force le nombre de stripes.
     -HI Nb             : Nb de generations a garder (par defaut 2).
     -RD directory      : Repertoire pour ecrire le fichier dump (par defaut /$(echo ${HOME}|cut -d/ -f2)/syb_dump/$DSQUERY).
     -CL Level          : Compression level (par defaut 1).
     -CR Rate           : Taux estime de compression (par defaut 22).
     -SMS Size          : Taille max d'un stripe (Mo, par defaut 4096).
     -FRT       code    : Valeur forcee du code retour sur erreur.
     -OldSyntax         : Force le Dump a l'ancienne syntaxe (par defaut, 'NewSyntax').
     -NewSyntax         : Force le Dump a la nouvelle syntaxe (par defaut, 'NewSyntax').
     -NoSyslogins       : Pas de backup syslogins tables.
     -NoMail            : Desactive l'envoi de mail sur erreur a pmexpdba@gmail.com (par defaut, envoi sur erreur).
     -AddMail   email   : Adresse Email a ajouter a 'pmexpdba@gmail.com'.
     -SendReport        : Envoi du rapport d'execution.
     -AddFlagName mflag : Met '.mflag' a la fin du nom du dump.
     -CrossPlatform     : Place la db en 'single user' mode et execute sp_flushstats avant le dump.
     -TryCum            : Try 'dump cumulative' if 'dump tran' error (need to customise lfsqw_TryCum fonction).
     -Type type         : Type de dump full,inc,stb,fstb (par defaut full).
     -Locale    locale  : Force la Locale d'affichage de l'aide (fr,en).
     -Exec              : Execute dump $DumpType (by default, display generated commands).
Information.png
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 'dataserver' parameter, Utilisation: sqwsyb_DumpDatabase.ksh [-h] -I <dataserver> [+ 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 'dataserver' 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_sybase : " (Voir l'aide pour personnaliser cette variable).

Information.png
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_sybase : " (Voir l'aide pour personnaliser cette variable).

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


Exemples d'utilisation

Sourcing sqwsyb_Global.lib v2024.02 SQWareProduction for Sybase (dbSQWare) ... 

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


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

$gvsqw_SybBin/sqwsyb_DumpDatabase.ksh -Locale fr -h
#Affichage de l'aide en ligne pour ce script avec forçage de la locale 'fr' (Locale par defaut geree par $gvsqw_Locale)

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

$gvsqw_SybBin/sqwsyb_DumpDatabase.ksh -I $DSQUERY -D <DbName>
#Genere les commandes mais ne les execute pas !

$gvsqw_SybBin/sqwsyb_DumpDatabase.ksh -I $DSQUERY -D <DbName> -Exec
#Genere un dump de la databse cible 

$gvsqw_SybBin/sqwsyb_DumpDatabase.ksh -I $DSQUERY -D <DbName> -RD <chemin> -CR <NumericValue> -Exec
#Specifie le chemin pour ecrire le dump avec un taux de compression estime (par defaut $gvsqw_DefCompRate=22)

$gvsqw_SybBin/sqwsyb_DumpDatabase.ksh -I $DSQUERY -D <DbName> -CL <NumericValue> -Exec
#Applique un taux de compression au dump (par defaut $gvsqw_DefCompLevel=1)

$gvsqw_SybBin/sqwsyb_DumpDatabase.ksh -I $DSQUERY -D <DbName> -SMS <NumericValue> -Exec
#Specifie la taille max des stripes en Mo (par defaut $gvsqw_DefMaxSizeStrip=4096)

$gvsqw_SybBin/sqwsyb_DumpDatabase.ksh -I $DSQUERY -D <DbName> -OldSyntax -Exec
#Force a ecrire le dump a l'ancienne syntax (par defaut, $gvsqw_DumpSyntaxType=NewSyntax)

$gvsqw_SybBin/sqwsyb_DumpDatabase.ksh -I $DSQUERY -D <DbName> -NewSyntax -Exec
#Force a ecrire le dump a la nouvelle syntax (par defaut, $gvsqw_DumpSyntaxType=NewSyntax)

$gvsqw_SybBin/sqwsyb_DumpDatabase.ksh -I $DSQUERY -D <DbName> -CrossPlatform -Exec
#Place la database en mode 'single user' et execute sp_flushstats avant le dump

$gvsqw_SybBin/sqwsyb_DumpDatabase.ksh -I $DSQUERY -D <DbName> -AddFlagName -Exec
#Met '.mflag' a la fin du nom du dump

$gvsqw_SybBin/sqwsyb_DumpDatabase.ksh -I $DSQUERY -D <DbName> -Type <TypedeDump> -Exec
#Execute les commandes generees et change le type de dump (full,inc,stb,fstb)

$gvsqw_SybBin/sqwsyb_DumpDatabase.ksh -I $DSQUERY -D <DbName> -HI <NumberOfGenerations> -Exec
#Change nombre de generations de backup a garder

$gvsqw_SybBin/sqwsyb_DumpDatabase.ksh -I $DSQUERY -D <DbName> -NS <NumberOfStripes> -Exec
#Generate un dump sur <NumberOfStripes> stripes

$gvsqw_SybBin/sqwsyb_DumpDatabase.ksh -I $DSQUERY -D <DbName> -AddMail 'mymail1@mydomaine.com,mymail2@mydomaine.com' -Exec
#Ajoute la liste de mail a l'adresse par defaut geree par $gvsqw_GlobalMail

$gvsqw_SybBin/sqwsyb_DumpDatabase.ksh -I $DSQUERY -D <DbName> -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_SybBin/sqwsyb_DumpDatabase.ksh -I $DSQUERY -D <DbName> -NoMail -Exec
#Desactive l'envoi de mail sur erreur a $gvsqw_GlobalMail (par defaut, seulement en cas d'erreur)

$gvsqw_SybBin/sqwsyb_DumpDatabase.ksh -I $DSQUERY -D <DbName> -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_sqwsyb_DumpDatabase=<NumericValue>
#dans le fichier de configuration $gvsqw_SybBin/../etc_cust/sqwsyb_GlobalVar.cfg

$gvsqw_SybBin/sqwsyb_DumpDatabase.ksh -I $DSQUERY -P <NumericValue> -Exec
#Execute le script sqwsyb_DumpDatabase.ksh avec un degre de parallelisme de '<NumericValue>'
#Utilise par defaut la variable gvsqw_NbThreadXXX dans $gvsqw_SybBin/../etc/sqwsyb_GlobalVar.cfg
#Vous pouvez changer le defaut sur tout l'environnement si vous settez cette variable
#dans le fichier de configuration $gvsqw_SybBin/../etc_cust/sqwsyb_GlobalVar.cfg
Information.png
Information:
Pour être sûr que les exemples sont exacts, reportez-vous directement à l'option d'aide en ligne du script -s .


Récupérée de « https://wikifr.dbsqware.com/index.php?title=SQWareProduction:sybase:bin:sqwsyb_DumpDatabase.ksh&oldid=6963 »