SQWareProduction:ingres:bin:sqwing RefreshDatabase.ksh

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

Online help

The online help is available for most scripts with the -h option.
Ex: $gvsqw_IngBin/sqwing_RefreshDatabase.ksh -h
Content of this assistance :

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

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

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

PARAMETERS
     -I  instance       : Target instance to database refresh.
     -D   databasename  : Database to refresh (import full with reLoad).
     -IS instance       : Instance source of the export.
     -US hostname       : Source hostname.
OPTIONS
     -h                 : Display the full usage.
     -s                 : Display samples of usage.
     -DIR export_dir    : Export directory on the source hostname (by default: 'retrieve last recent one').
     -UUS  username     : Source unix user (by default, same as target).
     -FRT       code    : Force return code value on error.
     -AddMail   email   : Email address to add at 'pmexpdba@gmail.com'.
     -SendReport        : Send execution log report.
     -NoMail            : Deactivate sendmail on error to pmexpdba@gmail.com (by default, send on error).
     -Locale    locale  : Force Locale for help display (fr,en).
     -Exec              : Execute commands (by default, display generated commands).

Error management

Errors passing arguments

This type of message is generated:

Lack 'instance' parameter, Usage: sqwing_RefreshDatabase.ksh [-h]  -I instance -D databasename -IS <instance> -US <hostname> [+ options]
For full help : sqwing_RefreshDatabase.ksh -h

If you are connecting through a terminal, no mail will be sent and you will have more this kind of message:

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

If you are not connected to a terminal, the error message appears and is sent by mail to the address contained in the variable $gvsqw_GlobalMail (See help customize this variable). The subject line will always start by "$gvsqw_MailMsg_ingres : " (See help customize this variable).

Execution errors

Whether you are or not connected to a terminal, the error message appears and an email containing a summary of treatment errors is sent to the address contained in the variable $gvsqw_Mail_ingres (See help customize this variable). The subject line will always start by "$gvsqw_MailMsg_ingres : " (See help customize this variable).

Usage examples

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

#Standard help for script sqwing_RefreshDatabase.ksh:


$gvsqw_IngBin/sqwing_RefreshDatabase.ksh -h
#Display online help for this script

$gvsqw_IngBin/sqwing_RefreshDatabase.ksh -Locale en -h
#Display online help for this script with forcing of the 'en' locale (by default locale managed by $gvsqw_Locale)

$gvsqw_IngBin/sqwing_RefreshDatabase.ksh -s
#Display usage examples for this script

$gvsqw_IngBin/sqwing_RefreshDatabase.ksh -I $INGRES_SID -D <DbName> -IS <InstanceSource> -US <HostnameSource>
#Generate commands but don't execute them !

$gvsqw_IngBin/sqwing_RefreshDatabase.ksh -I $INGRES_SID -D <DbName> -IS <InstanceSource> -US <HostnameSource> -Exec
Transfert the export files locally from the source server

$gvsqw_IngBin/sqwing_RefreshDatabase.ksh -I $INGRES_SID -D <DbName> -IS <InstanceSource> -US <HostnameSource> -DIR <DirExport> -Exec
#Transfert the export files locally from the source server and use the export directory <DirExport>

$gvsqw_IngBin/sqwing_RefreshDatabase.ksh -I $INGRES_SID -D <DbName> -IS <InstanceSource> -US <HostnameSource> -UUS 'dba_42' -Exec
#Source unix user here 'dba_42' (by default, same as target)

$gvsqw_IngBin/sqwing_RefreshDatabase.ksh -I $INGRES_SID -D <DbName> -IS <InstanceSource> -US <HostnameSource> -AddMail 'mymail1@mydomaine.com,mymail2@mydomaine.com' -Exec
#Add the mail list to the default address managed by the variable gvsqw_GlobalMail

$gvsqw_IngBin/sqwing_RefreshDatabase.ksh -I $INGRES_SID -D <DbName> -IS <InstanceSource> -US <HostnameSource> -SendReport -Exec
#Send the log by email at the end of the treatment even if there is no error

$gvsqw_IngBin/sqwing_RefreshDatabase.ksh -I $INGRES_SID -D <DbName> -IS <InstanceSource> -US <HostnameSource> -NoMail -Exec
#Disables sending an email on error to $gvsqw_GlobalMail (by default, send on error)

$gvsqw_IngBin/sqwing_RefreshDatabase.ksh -I $INGRES_SID -D <DbName> -IS <InstanceSource> -US <HostnameSource> -FRT <NumericValue> -Exec
#Force return code to '<NumericValue>' on error (if no error, "exit 0!")
#You can also force return code of this script on all your
#environnement if you set the variable: $gvsqw_ForcedReturnCodeScript_sqwing_RefreshDatabase=<NumericValue>
#in configuration file $gvsqw_IngBin/../etc_cust/sqwing_GlobalVar.cfg