SQWareProduction:sybase:bin:sqwsyb LoadAllDatabases.ksh

From Wiki_dbSQWare
Jump to navigation Jump to search
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

Presentation

Script $gvsqw_SybBin/sqwsyb_LoadAllDatabases.ksh :


load of all databases in parallel



Online help

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

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

Usage: sqwsyb_LoadAllDatabases.ksh [-h] -I <dataserver> [+ options]

DESCRIPTION
   sqwsyb_LoadAllDatabases.ksh load all databases in parallel
SUPPORT
   Sybase supported versions: 12.5 <= v <= 16.0

PARAMETERS
     -I  dataserver     : Target dataserver.
OPTIONS
     -P    Nb threads   : Number of threads in parallel (by default 2).
     -O  on,off,ostb    : Type online (by default on).
     -ID   listdb       : List of databases to run load (by default all).
     -ED   listdb       : List of databases to exclude.
     -IL   likeclause   : Like clause to generate databases list (example: 'db%').
     -EL   likeclause   : Like clause to exclude databases (example: 'nodb%').
     -RD   directory    : Directory holding dump file (by default /$(echo ${HOME}|cut -d/ -f2)/syb_dump/$DSQUERY).
     -WCD  whereclause  : Where clause to generate databases list.
     -FRT       code    : Force return code value on error.
     -AGR Nb_sec        : Nb of seconds between two runs (by default 10s).
     -AGE Nb_sec        : Nb of seconds between two checks of end (by default 30s).
     -Type type         : Dump type full,inc,stb,fstb (by default full).
     -Lock              : Lock all logins during load.
     -Kill              : Kill connexion on loaded database.
     -Shut              : Run "dbcc dbreboot('shutdown_load',dbname)" before load database (12.5.4 ESD1 and 15.0.2).
     -Rsync             : Synchronize sysusers and sysalternates with master..syslogins (by default no).
     -LtmIgnore         : Execute 'dbcc settrunc (ltm,ignore)' after load.
     -NoMail            : Deactivate sendmail on error demo-sqwarebox@dbsqware.com (by default, send on error).
     -AddMail   email   : Email address to add at 'demo-sqwarebox@dbsqware.com'.
     -SendReport        : Send execution log report.
     -CrossPlatform     : Execute sp_post_xpload after load.
     -AddFlagName mflag : Search dumps with '.mflag' at end of name.
     -Upgrade           : Execute sp_checkreswords,sp_checksource,dbcc upgrade_object after load.
     -h                 : Display the full usage.
     -s                 : Display samples of usage.
     -Locale    locale  : Force Locale for help display (fr,en).
     -Exec              : Execute commands (by default, display generated commands).
Note:
To be sure the aid is accurate, refer directly to the online help script -h option.


Error management

Errors passing arguments

This type of message is generated: 

Lack 'dataserver' parameter, Usage: sqwsyb_LoadAllDatabases.ksh [-h] -I <dataserver> [+ options]
For full help : sqwsyb_LoadAllDatabases.ksh -h

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

Not sending mail because you are in connected mode !!!
Lack 'dataserver' parameter

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_sybase : " (See help customize this variable).

Note:
Sending mail can be disabled by the option -NoMail for one execution.


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_sybase (See help customize this variable). The subject line will always start by "$gvsqw_MailMsg_sybase : " (See help customize this variable).

Note:
Sending mail can be disabled by the option -NoMail for one execution.


Usage examples

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

#Standard help for script sqwsyb_LoadAllDatabases.ksh:

$gvsqw_SybBin/sqwsyb_LoadAllDatabases.ksh -h
#Display online help for this script

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

$gvsqw_SybBin/sqwsyb_LoadAllDatabases.ksh -s
#Display usage examples for this script

$gvsqw_SybBin/sqwsyb_LoadAllDatabases.ksh -I $DSQUERY
#Generate commands but don't execute them !

$gvsqw_SybBin/sqwsyb_LoadAllDatabases.ksh -I $DSQUERY -Exec
#Run the sqwsyb_LoadDatabase.ksh script to load the dumps of all databases

$gvsqw_SybBin/sqwsyb_LoadAllDatabases.ksh -I $DSQUERY -Dist -Exec
#Analyze of all tables for all the databases for the non-local instance $DSQUERY with distant connection
#You need to register credentials to use for distant connection to the instance (user and so on) in file $gvsqw_DistPasswdFile

$gvsqw_SybBin/sqwsyb_LoadAllDatabases.ksh -I $DSQUERY -RD <DirName> -O <Type> -Exec
#Specify the dumps path, and type of target databases (on/off/ostb. by default on) 

$gvsqw_SybBin/sqwsyb_LoadAllDatabases.ksh -I $DSQUERY -Lock -Exec
#Lock all logins during dumps's load

$gvsqw_SybBin/sqwsyb_LoadAllDatabases.ksh -I $DSQUERY -Shut -Exec
#Execute \"dbcc dbreboot('shutdown_load',dbname)\" before loading of database

$gvsqw_SybBin/sqwsyb_LoadAllDatabases.ksh -I $DSQUERY -LtmIgnore -Exec
#Execute 'dbcc settrunc (ltm,ignore)' after dumps loading

$gvsqw_SybBin/sqwsyb_LoadAllDatabases.ksh -I $DSQUERY -CrossPlatform -Exec
#Execute sp_post_xpload after dumps's loading

$gvsqw_SybBin/sqwsyb_LoadAllDatabases.ksh -I $DSQUERY -AddFlagName -Exec
#Load dump files whose names ends by '.mflag'

$gvsqw_SybBin/sqwsyb_LoadAllDatabases.ksh -I $DSQUERY -Upgrade -Exec
#Execute sp_checkreswords,sp_checksource,dbcc upgrade_object after load

$gvsqw_SybBin/sqwsyb_LoadAllDatabases.ksh -I $DSQUERY -Type <TypedeDump> -Exec
#Execute generated commands and change dump type (full,inc,stb,fstb)

$gvsqw_SybBin/sqwsyb_LoadAllDatabases.ksh -I $DSQUERY -Kill -Rsync -Exec
#Kill users connection before Load and made synchronisation of syslogins/sysusers

$gvsqw_SybBin/sqwsyb_LoadAllDatabases.ksh -I $DSQUERY -AGR 20 -Exec
#Set the waiting time in seconds between two command run, 20s here

$gvsqw_SybBin/sqwsyb_LoadAllDatabases.ksh -I $DSQUERY -AGE 30 -Exec
#Set the waiting time in seconds between two end checks, 30s here

$gvsqw_SybBin/sqwsyb_LoadAllDatabases.ksh -I $DSQUERY -P <NumericValue> -Exec
#Run sqwsyb_LoadDatabase.ksh script with a parallel degree of '<NumericValue>'
#Use by default the variable gvsqw_NbThreadXXX in $gvsqw_SybBin/../etc/sqwsyb_GlobalVar.cfg
#You can change this default on all your environnement if you set this variable
#in configuration file $gvsqw_SybBin/../etc_cust/sqwsyb_GlobalVar.cfg

$gvsqw_SybBin/sqwsyb_LoadAllDatabases.ksh -I $DSQUERY -ID 'DbName1,DbName2' -Exec
#Execute generated commands for only the 2 specified databases

$gvsqw_SybBin/sqwsyb_LoadAllDatabases.ksh -I $DSQUERY -ED 'DbName3,DbName4' -Exec
#Execute generated commands except for the 2 specified databases

$gvsqw_SybBin/sqwsyb_LoadAllDatabases.ksh -I $DSQUERY -IL '%_PROD' -Exec
#Clause like to generate dynamic database list to include (example: 'dbprod%')

$gvsqw_SybBin/sqwsyb_LoadAllDatabases.ksh -I $DSQUERY -EL '%_TESTS' -Exec
#Clause like to generate dynamic database list to exclude (example: 'dbtest%')

$gvsqw_SybBin/sqwsyb_LoadAllDatabases.ksh -I $DSQUERY -WCD '<condition>' -Exec
#Clause where to generate dynamic database list to include

$gvsqw_SybBin/sqwsyb_LoadAllDatabases.ksh -I $DSQUERY -P <NumericValue> -Exec
#Run sqwsyb_LoadDatabase.ksh script with a parallel degree of '<NumericValue>'
#Use by default the variable gvsqw_NbThreadXXX in $gvsqw_SybBin/../etc/sqwpg_GlobalVar.cfg
#You can change this default on all your environnement if you set this variable
#in configuration file $gvsqw_SybBin/../etc_cust/sqwpg_GlobalVar.cfg

$gvsqw_SybBin/sqwsyb_LoadAllDatabases.ksh -I $DSQUERY -AddMail 'mymail1@mydomaine.com,mymail2@mydomaine.com' -Exec
#Add the mail list to the default address managed by the variable gvsqw_GlobalMail

$gvsqw_SybBin/sqwsyb_LoadAllDatabases.ksh -I $DSQUERY -SendReport -Exec
#Send the log by email at the end of the treatment even if there is no error

$gvsqw_SybBin/sqwsyb_LoadAllDatabases.ksh -I $DSQUERY -NoMail -Exec
#Disables sending an email on error to $gvsqw_GlobalMail (by default, send on error)

$gvsqw_SybBin/sqwsyb_LoadAllDatabases.ksh -I $DSQUERY -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_sqwsyb_LoadAllDatabases=<NumericValue>
#in configuration file $gvsqw_SybBin/../etc_cust/sqwsyb_GlobalVar.cfg
Note:
To be sure the examples are accurate, refer directly to the online help script -s option.


Retrieved from "https://wiki.dbsqware.com/index.php?title=SQWareProduction:sybase:bin:sqwsyb_LoadAllDatabases.ksh&oldid=18300"