SQWareProduction:sybase:bin:sqwsyb LoadDatabase.ksh

Presentation

Script $gvsqw_SybBin/sqwsyb_LoadDatabase.ksh :

Chargement standard de database
le script trouve dynamiquement les fichiers a charger
Vous pouvez choisir le type de load (par defaut full):

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

Vous pouvez choisir de mettre online la database ou pas (par defaut on):

• on -> online
• off -> not online
• ostb -> online for standby access

Le script peut aussi:

• killer les sessions connectes sur la database a charger
• fait la synchronisation de syslogins/sysusers
• Execute script shell avant chargement
• Execute script shell apres chargement

Aide en ligne

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

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

Utilisation: sqwsyb_LoadDatabase.ksh [[-h]] -I <dataserver> -DT <DatabaseTarget> [[+ options]]

DESCRIPTION
   sqwsyb_LoadDatabase.ksh load $lvsqw_LoadType 
SUPPORT
   Sybase versions supportees: 12.5 <= v <= 16.0

PARAMETERS
     -I  dataserver     : Dataserver cible.
     -DT DatabaseTarget : Base de donneescible.
OPTIONS
     -h                 : Affichage de l'aide complete.
     -s                 : Affichage des exemples d'utilisation.
     -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.
     -DS DatabaseSource : Source base de donnees (par defaut meme que -DT).
     -O on,off,ostb     : Type online (par defaut on).
     -F file            : Fichier dump a charger (par defaut remonte la derniere).
     -DD date_dump      : Date dump a charger (par defaut remonte la derniere).
     -RD directory      : Repertoire pour trouver le fichier dump (par defaut /$(echo ${HOME}|cut -d/ -f2)/syb_dump/$DSQUERY).
     -FRT       code    : Valeur forcee du code retour sur erreur.
     -Before  script    : Script a executer avant le script.
     -After   script    : Script a executer apres le script.
     -Type type         : Type de load full,inc,stb,fstb (par defaut full).
     -Chk               : Check la taille de la base de donnees avant de charger.
     -Lock              : Lock tous les logins pendant le chargement.
     -Kill              : Kill connexion sur la base de donnees a charger.
     -Shut              : Execute "dbcc dbreboot('shutdown_load',dbname)" avant chargement de la base de donnees (12.5.4 ESD1 et 15.0.2).
     -Rsync             : Synchronise sysusers et sysalternates avec master..syslogins (par defaut non).
     -LtmIgnore         : Execute 'dbcc settrunc (ltm,ignore)' apres chargement.
     -CrossPlatform     : Execute sp_post_xpload apres chargement.
     -AddFlagName mflag : Cherche le dumps avec '.mflag' a la fin du nom.
     -Upgrade           : Execute sp_checkreswords,sp_checksource,dbcc upgrade_object apres chargement.
     -Locale    locale  : Force la Locale d'affichage de l'aide (fr,en).
     -Exec              : Execute load $lvsqw_LoadType (par defaut, affiche les commandes generees).

Traitement de l'erreur

Erreurs de parse des arguments

Ce type de message est genere:

Lack 'dataserver' parameter, Utilisation: sqwsyb_LoadDatabase.ksh [[-h]] -I <dataserver> -DT <DatabaseTarget> [[+ options]]

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

Begining     : 2020-12-15 21:15:49
End          : 2020-12-15 21:15:49
Duration     : 00:00:00 

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).

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).

Exemples d'utilisation

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

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


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

$gvsqw_SybBin/sqwsyb_LoadDatabase.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_SybBin/sqwsyb_LoadDatabase.ksh -s
#Affichage des exemples d'utilisation pour ce script

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

$gvsqw_SybBin/sqwsyb_LoadDatabase.ksh -I $DSQUERY -DT <DbName> -Exec
#Charge le dump d'une seule database 

$gvsqw_SybBin/sqwsyb_LoadDatabase.ksh -I $DSQUERY -DT <DbName> -RD <DirName> -O <Type> -Exec
#Specifie le chemin du dump, ainsi que le type de databas cible (on/off/ostb. Par defaut, on) 

$gvsqw_SybBin/sqwsyb_LoadDatabase.ksh -I $DSQUERY -DT <DbName> -DS <DataserverSource> -Exec
#Precise le dataserveur source du dump

$gvsqw_SybBin/sqwsyb_LoadDatabase.ksh -I $DSQUERY -DT <DbName> -DD <date> -After <script> -Exec
#Precise la date du dump a charger (par defaut, le dernier), puis execute un script apres le chargement

$gvsqw_SybBin/sqwsyb_LoadDatabase.ksh -I $DSQUERY -DT <DbName> -Chk -Before <script> -Exec
#Verifie la taille de database, et execute un script avant le chargement du dump

$gvsqw_SybBin/sqwsyb_LoadDatabase.ksh -I $DSQUERY -DT <DbName> -Lock -Exec
#Verouille tous les logins pendant le chargement des dumps

$gvsqw_SybBin/sqwsyb_LoadDatabase.ksh -I $DSQUERY -DT <DbName> -Shut -Exec
#Execute \"dbcc dbreboot('shutdown_load',dbname)\" avant chargement de la database

$gvsqw_SybBin/sqwsyb_LoadDatabase.ksh -I $DSQUERY -DT <DbName> -CrossPlatform -Exec
#Execute sp_post_xpload apres le chargement des dumps

$gvsqw_SybBin/sqwsyb_LoadDatabase.ksh -I $DSQUERY -DT <DbName> -AddFlagName -Exec
#Charge les dumps avec '.mflag' a la fin du nom

$gvsqw_SybBin/sqwsyb_LoadDatabase.ksh -I $DSQUERY -DT <DbName> -Upgrade -Exec
Execute sp_checkreswords,sp_checksource,dbcc upgrade_object apres chargement des dumps

$gvsqw_SybBin/sqwsyb_LoadDatabase.ksh -I $DSQUERY -DT <DbName> -Type <TypedeDump> -F <File> -Exec
#Execute un load database de type <TypedeDump> de la database cible avec le fichier specifie <File>

$gvsqw_SybBin/sqwsyb_LoadDatabase.ksh -I $DSQUERY -DT <DbName> -Kill -Rsync -Exec
#Kill des connexions users avant chargement et synchronisation de syslogins/sysusers

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

$gvsqw_SybBin/sqwsyb_LoadDatabase.ksh -I $DSQUERY -DT <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_LoadDatabase=<NumericValue>
#dans le fichier de configuration $gvsqw_SybBin/../etc_cust/sqwsyb_GlobalVar.cfg