SQWareProduction:ingres:bin:sqwing ExportFullDatabase.ksh

Presentation

Script $gvsqw_IngBin/sqwing_ExportFullDatabase.ksh :

Genere un dechargement complet de la database
Gere la profondeur d'historique
Peut faire le dechargement en mode consistent

Aide en ligne

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

Sourcing sqwing_Global.lib v2024.07 SQWareProduction for Ingres (dbSQWare) ... 

Utilisation: sqwing_ExportFullDatabase.ksh [-h] -I instance -D databasename [+ options]

DESCRIPTION
   sqwing_ExportFullDatabase.ksh export full de la base de donnees
SUPPORT
   Ingres versions supportees: v=2.6

PARAMETERS
     -I  instance       : Instance cible pour export full.
     -D   databasename  : Base de donnees.
OPTIONS
     -h                 : Affichage de l'aide complete.
     -s                 : Affichage des exemples d'utilisation.
     -HI   nb_gen       : Nombre de generations a garder (par defaut: 2).
     -OPT  option       : Options additionnelles pour la ligne de commande.
     -FRT       code    : Valeur forcee du code retour sur erreur.
     -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).
     -Consistent        : Fait l'export avec l'option -l (exclusive mode).
     -Exec              : Execute les commandes generees (par defaut, affiche les commandes generees).

Traitement de l'erreur

Erreurs de parse des arguments

Ce type de message est genere:

Lack 'instance' parameter, Utilisation: sqwing_ExportFullDatabase.ksh [-h]  -I instance -D databasename [+ 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 'instance' 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_ingres : " (Voir l'aide pour personnaliser cette variable).

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

Exemples d'utilisation

Sourcing sqwing_Global.lib v2024.07 SQWareProduction for Ingres (dbSQWare) ... 

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


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

$gvsqw_IngBin/sqwing_ExportFullDatabase.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_IngBin/sqwing_ExportFullDatabase.ksh -s
#Affichage des exemples d'utilisation pour ce script

$gvsqw_IngBin/sqwing_ExportFullDatabase.ksh -I $INGRES_SID -D <DbName>
#Genere les commandes mais ne les execute pas !

$gvsqw_IngBin/sqwing_ExportFullDatabase.ksh -I $INGRES_SID -D <DbName> -Exec
#Genere un dechargement complet de la database

$gvsqw_IngBin/sqwing_ExportFullDatabase.ksh -I $INGRES_SID -D <DbName> -HI <NumberOfGenerations> -Exec
#Change le nombre de generations de sauvegarde a garder

$gvsqw_IngBin/sqwing_ExportFullDatabase.ksh -I $INGRES_SID -D <DbName> -Consistent -Exec
#Realise l'export avec l'option -l

$gvsqw_IngBin/sqwing_ExportFullDatabase.ksh -I $INGRES_SID -D <DbName> -OPT <option> -Exec
#Ajoute l(es) option(s) <option> a la commande

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

$gvsqw_IngBin/sqwing_ExportFullDatabase.ksh -I $INGRES_SID -D <DbName> -SendReport
#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_IngBin/sqwing_ExportFullDatabase.ksh -I $INGRES_SID -D <DbName> -NoMail
#Desactive l'envoi de mail sur erreur a $gvsqw_GlobalMail (par defaut, seulement en cas d'erreur)

$gvsqw_IngBin/sqwing_ExportFullDatabase.ksh -I $INGRES_SID -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_sqwing_ExportFullDatabase=<NumericValue>
#dans le fichier de configuration $gvsqw_IngBin/../etc_cust/sqwing_GlobalVar.cfg