SQWareProduction:sybase:bin:sqwsyb DumpDatabase.ksh

From Wiki_dbSQWare
Revision as of 16:44, 2 July 2021 by BatchUser (talk | contribs) (Updated by BatchUser)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Presentation

Script $gvsqw_SybBin/sqwsyb_DumpDatabase.ksh :


Generate Dump database
You can choose type of Dump (by default full):

  • full -> full Dump
  • inc -> Dump tran
  • stb -> Dump tran for standby
  • fstb -> full Dump plus Dump tran for standby


Script automatically determine how many stripes
Makes backup of master..syslogins (permet to make synchronisation on Load)
Makes purges of Dump generations
You can change default values:

  • compression level
  • force number of stripes
  • size max of a stripe
  • number of Dump generations to keep online



Online help

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

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

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

DESCRIPTION
   sqwsyb_DumpDatabase.ksh Dump $DumpType
SUPPORT
   Sybase supported versions: 12.5 <= v <= 16.0

PARAMETERS
     -I  dataserver     : Target dataserver.
     -D  database       : Database name.
OPTIONS
     -h                 : Display the full usage.
     -s                 : Display samples of usage.
     -NS Nb stripe      : Force number of stripes.
     -HI Nb             : Nb of generations to keep (by default 2).
     -RD directory      : Directory to write dump file (by default /$(echo ${HOME}|cut -d/ -f2)/syb_dump/$DSQUERY).
     -CL Level          : Compression level (by default 1).
     -CR Rate           : Estimated rate of compression (by default 22).
     -SMS Size          : Size max of a stripe (Mb, by default 4096).
     -FRT       code    : Force return code value on error.
     -OldSyntax         : Force dump old syntax (by default, 'NewSyntax').
     -NewSyntax         : Force dump new syntax (by default, 'NewSyntax').
     -NoSyslogins       : Do not backup syslogins tables.
     -NoMail            : Deactivate sendmail on error pmexpdba@gmail.com (by default, send on error).
     -AddMail   email   : Email address to add at 'pmexpdba@gmail.com'.
     -SendReport        : Send execution log report.
     -AddFlagName mflag : Put '.mflag' at end of dump name.
     -CrossPlatform     : Put db in 'single user' mode and execute sp_flushstats before Dump.
     -TryCum            : Try 'dump cumulative' if 'dump tran' error (need to customize lfsqw_TryCum function).
     -Type type         : Type of Dump full,inc,stb,fstb (by default full).
     -Locale    locale  : Force Locale for help display (fr,en).
     -Exec              : Run Dump $DumpType (by default, display generated commands).
Nuvola apps information.png
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_DumpDatabase.ksh [-h] -I <dataserver> [+ options]
For full help : sqwsyb_DumpDatabase.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).

Nuvola apps information.png
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).

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


Usage examples

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

#Standard help for script sqwsyb_DumpDatabase.ksh:


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

$gvsqw_SybBin/sqwsyb_DumpDatabase.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_DumpDatabase.ksh -s
#Display usage examples for this script

$gvsqw_SybBin/sqwsyb_DumpDatabase.ksh -I $DSQUERY -D <DbName>
#Generate commands but don't execute them !

$gvsqw_SybBin/sqwsyb_DumpDatabase.ksh -I $DSQUERY -D <DbName> -Exec
#Make a dump of target database 

$gvsqw_SybBin/sqwsyb_DumpDatabase.ksh -I $DSQUERY -D <DbName> -RD <DirName> -CR <NumericValue> -Exec
#Specify the path to write dump with an estimated compression ratio (by default, $gvsqw_DefCompRate=22)

$gvsqw_SybBin/sqwsyb_DumpDatabase.ksh -I $DSQUERY -D <DbName> -CL <NumericValue> -Exec
#Applies a compression rate to dump (by default, $gvsqw_DefCompLevel=1)

$gvsqw_SybBin/sqwsyb_DumpDatabase.ksh -I $DSQUERY -D <DbName> -SMS <NumericValue> -Exec
#Specify the max stripe size in Mo (by default, $gvsqw_DefMaxSizeStrip=4096)

$gvsqw_SybBin/sqwsyb_DumpDatabase.ksh -I $DSQUERY -D <DbName> -OldSyntax -Exec
#Force to write dump using the old syntax (by default, $gvsqw_DumpSyntaxType=NewSyntax)

$gvsqw_SybBin/sqwsyb_DumpDatabase.ksh -I $DSQUERY -D <DbName> -NewSyntax -Exec
#Force to write dump using the new syntax (by default, $gvsqw_DumpSyntaxType=NewSyntax)

$gvsqw_SybBin/sqwsyb_DumpDatabase.ksh -I $DSQUERY -D <DbName> -CrossPlatform -Exec
#Puts the database in 'single user' mode and execute sp_flushstats before dumping

$gvsqw_SybBin/sqwsyb_DumpDatabase.ksh -I $DSQUERY -D <DbName> -AddFlagName -Exec
#Puts '.mflag' at the end of dump's name

$gvsqw_SybBin/sqwsyb_DumpDatabase.ksh -I $DSQUERY -D <DbName> -HI <NumberOfGenerations> -Exec
#change the number of generation to keep

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

$gvsqw_SybBin/sqwsyb_DumpDatabase.ksh -I $DSQUERY -D <DbName> -NS <NumberOfStripes> -Exec
#Generate Dump on <NumberOfStripes> stripes

$gvsqw_SybBin/sqwsyb_DumpDatabase.ksh -I $DSQUERY -D <DbName> -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_DumpDatabase.ksh -I $DSQUERY -D <DbName> -SendReport -Exec
#Send the log by email at the end of the treatment even if there is no error

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

$gvsqw_SybBin/sqwsyb_DumpDatabase.ksh -I $DSQUERY -D <DbName> -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_DumpDatabase=<NumericValue>
#in configuration file $gvsqw_SybBin/../etc_cust/sqwsyb_GlobalVar.cfg
Nuvola apps information.png
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_DumpDatabase.ksh&oldid=18294"