SQWareProduction:ingres:bin:sqwing RefreshDatabase.ksh

De WikiFr_dbSQWare
Aller à : navigation, rechercher

Presentation

Script $gvsqw_IngBin/sqwing_RefreshDatabase.ksh :


Transfert the export files locally from the source server
Generate database refresh (import full of database after destroy and recreation of database)
Export name to use can be chosen



Aide en ligne

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

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

Utilisation: sqwing_RefreshDatabase.ksh [-h] -I instance -D databasename -IS <instance> -US <hostname> [+ options]

DESCRIPTION
   sqwing_RefreshDatabase.ksh database refresh
SUPPORT
   Ingres versions supportees: v=2.6

PARAMETERS
     -I  instance       : Instance cible pour database refresh.
     -D   databasename  : Database to refresh (import full with reLoad).
     -IS instance       : Instance source of the export.
     -US hostname       : Source hostname.
OPTIONS
     -h  help           : Affichage de l'aide complete.
     -s                 : Affichage des exemples d'utilisation.
     -DIR export_dir    : Export directory on the source hostname (default: 'retrieve last recent one').
     -UUS  username     : Source unix user (par defaut, meme que la target).
     -FRT  return_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).
     -Exec              : Execute les commandes generees (par defaut, affiche les commandes generees)

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 'instance' parameter, Utilisation: sqwing_RefreshDatabase.ksh [-h]  -I instance -D databasename -IS <instance> -US <hostname> [+ 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).

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_ingres : " (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 sqwing_Global.lib v2024.01 SQWareProduction for Ingres (dbSQWare) ... 

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


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

$gvsqw_IngBin/sqwing_RefreshDatabase.ksh -Locale fr -h
#Affichage de l'aide en ligne pour ce script avec forçage de la locale 'fr' (Locale par défaut gérée par la variable gvsqw_Locale)

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

$gvsqw_IngBin/sqwing_RefreshDatabase.ksh -AddMail 'mymail1@mydomaine.com,mymail2@mydomaine.com'
#Ajoute la liste de mail à l'adresse par défaut gérée par la variable gvsqw_GlobalMail

$gvsqw_IngBin/sqwing_RefreshDatabase.ksh -SendReport
#Envoie la log par mail à la fin du traitement même s'il n'y a pas d'erreur

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

$gvsqw_IngBin/sqwing_RefreshDatabase.ksh -I $INGRES_SID -D <DbName> -IS <InstanceSource> -US <HostnameSource> -NoMail
#Desactive l'envoi de mail sur erreur a $gvsqw_GlobalMail (par defaut, send on error)

$gvsqw_IngBin/sqwing_RefreshDatabase.ksh -I $INGRES_SID -D <DbName> -IS <InstanceSource> -US <HostnameSource> -Exec
#Execute les commandes generees

$gvsqw_IngBin/sqwing_RefreshDatabase.ksh -I $INGRES_SID -D <DbName> -IS <InstanceSource> -US <HostnameSource> -DIR <DirExport> -Exec
#Execute les commandes generees and use the export directory <DirExport>

$gvsqw_IngBin/sqwing_RefreshDatabase.ksh -I $INGRES_SID -D <DbName> -IS <InstanceSource> -US <HostnameSource> -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_RefreshDatabase=<NumericValue>
#dans le fichier de configuration $gvsqw_IngBin/../etc_cust/sqwing_GlobalVar.cfg

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