SQWareProduction:sybrep

From Wiki_dbSQWare
Jump to: navigation, search

Presentation

Usage

It's the module locally operating of sybrep.
It is entirely written in ksh and sql.
It allows to manage the operation for sybrep.
Example uses of the tool:

  • Backup
  • Recovery
  • Compute statistics
  • Indicators collection to store in referential database SQWareRepository
  • Rotate logs
  • ....

This module is deployed locally on the machine hosting the authorities to manage, in order to avoid any points of weakness related to an NFS mount or whatever. The deployment is done through a simple command SQWareCentral module using inventory located in SQWareRepository !
Installation guide for SQWareProduction for sybrep

Explanation of directories

Directories located in $gvsqw_SybBin:

  • bin : Directory containing standard scripts
  • bin_cust : Directory containing customs scripts for your environnement
  • etc : Directory containing the standard files of configuration
  • etc_cust : Directory containing the customs files of configuration for your environnement (overload standards)
  • help : Directory containing the standard files of help
  • help_cust : Directory containing the customs files of help for your environnement
  • lib : Directory containing the generic shell function librairies
  • lib_cust : Directory containing the generic shell function librairies (overload standards)
  • spm : Contain sql query toolkit
  • tools : Directory containing the standard scripts used on an ad hoc
  • tools_cust : Directory containing the customs scripts used on an ad hoc for your environnement
  • menu : Directory containing the standard menus
  • menu_cust : Directory containing the custom menus for your environnement
Nuvola apps important.png
Warning:
Do not change the standard scripts and configuration files of dbSQWare.

Use directories *_cust for customizations. This will facilitate version upgrades.


Naming convention of files

The majority of files are named with suffixes:

  • *.ksh : for scripts
  • *.cfg : for configuration files
  • *.lib : for function librairies
  • *.hlp : for help files
Nuvola apps important.png
Warning:
Do not change the standard scripts and configuration files of dbSQWare.

Use directories *_cust for customizations. This will facilitate version upgrades.


Naming convention in scripts

In general, the following naming convention is used in all scripts of SQWareProduction:

  • gvsqw_ {} : global variable initialized by the environment and / or generic library
  • lvsqw_ {} : local variable initialized by the script and / or a specific library
  • gfsqw_ {} : function defined by a generic library
  • lfsqw_ {} : function defined by the script and / or a specific library

bin

sqwrs_ExecSQL.ksh

Script $gvsqw_SybBin/bin/sqwrs_ExecSQL.ksh:

execute SQL file on instance See the detailed help for sqwrs_ExecSQL.ksh

sqwrs_FailWithoutMail.ksh

Script $gvsqw_SybBin/bin/sqwrs_FailWithoutMail.ksh:

See the detailed help for sqwrs_FailWithoutMail.ksh

sqwrs_GatherIndicators.ksh

Script $gvsqw_SybBin/bin/sqwrs_GatherIndicators.ksh:

Gather SybaseRs indicators and put them in SQWareRepository
Summary of collection:

  • Volumetry (stable devices) of RS
  • Version, options, configuration, ... of RS

See the detailed help for sqwrs_GatherIndicators.ksh

sqwrs_NetBackup.ksh

Script $gvsqw_SybBin/bin/sqwrs_NetBackup.ksh:

backup with NetBackup dump/backup files See the detailed help for sqwrs_NetBackup.ksh

sqwrs_ParallelRun.ksh

Script $gvsqw_SybBin/bin/sqwrs_ParallelRun.ksh:

Manages the execution of unix commands in parallel
Takes in parameter file with unix command to execute
You can choose:

  • The parallel degree
  • Aggressiveness of run (number of seconds between two runs)
  • Aggressiveness of check end (number of seconds between two checks of end)


See the detailed help for sqwrs_ParallelRun.ksh

sqwrs_RunJob.ksh

Script $gvsqw_SybBin/bin/sqwrs_RunJob.ksh:

Run SybaseRs scripts and generate log and error file
based on $gvsqw_RootCfg/sqwrs_Jobs.cfg configuration file
compress and purge oldest log files See the detailed help for sqwrs_RunJob.ksh


etc

sqwrs_GlobalVar.cfg

Configuration file $gvsqw_SybBin/../etc/sqwrs_GlobalVar.cfg:
Global var for SybaseRs
It contains the operating variables of SQWareProduction.

Nuvola apps information.png
Note:
You can overload variables contain in $gvsqw_SybBin/../etc/sqwrs_GlobalVar.cfg

by the same variables in $gvsqw_SybBin/../etc_cust/sqwrs_GlobalVar.cfg for all your environnement
or in $HOME/sqwConfig/sqwrs_GlobalVar.cfg specifically for this user.

See the detailed help for sqwrs_GlobalVar.cfg

.profile

Sample file for .profile $gvsqw_SybBin/../etc/.profile:
Sample of lines to add to .profile of sybrep users.
See the detailed help for .profile

.profile_confort

File to put aliases $gvsqw_SybBin/../etc/.profile_confort:
Contains confort aliases of SQWareProduction for sybrep.

Nuvola apps information.png
Note:
You can overload confort environnement $gvsqw_SybBin/../etc/.profile_confort

with $gvsqw_SybBin/../etc_cust/.profile_confort for all your environnement
or with $HOME/edtConfig/.profile_confort specifically for this user .


See the detailed help for .profile_confort


lib

sqwrs_GatherIndicators.lib

shell functions library $gvsqw_SybBin/../lib/sqwrs_GatherIndicators.lib:
lib for sqwrs_GatherIndicators.ksh

Nuvola apps information.png
Note:
You can overload functions contained in $gvsqw_SybBin/../lib/sqwrs_GatherIndicators.lib

by function with same name in $gvsqw_SybBin/../lib_cust/sqwrs_GatherIndicators.lib for all your environnement
or by $HOME/sqwConfig/sqwrs_GatherIndicators.lib specifically for this user .


See the detailed help for sqwrs_GatherIndicators.lib

sqwrs_GatherIndicators_Overload.lib

shell functions library $gvsqw_SybBin/../lib/sqwrs_GatherIndicators_Overload.lib:
lib for overLoad sqwrs_GatherIndicators.ksh

Nuvola apps information.png
Note:
You can overload functions contained in $gvsqw_SybBin/../lib/sqwrs_GatherIndicators_Overload.lib

by function with same name in $gvsqw_SybBin/../lib_cust/sqwrs_GatherIndicators_Overload.lib for all your environnement
or by $HOME/sqwConfig/sqwrs_GatherIndicators_Overload.lib specifically for this user .


See the detailed help for sqwrs_GatherIndicators_Overload.lib

sqwrs_Global.lib

shell functions library $gvsqw_SybBin/../lib/sqwrs_Global.lib:
central lib of generic fonctions for SybaseRs

Nuvola apps information.png
Note:
You can overload functions contained in $gvsqw_SybBin/../lib/sqwrs_Global.lib

by function with same name in $gvsqw_SybBin/../lib_cust/sqwrs_Global.lib for all your environnement
or by $HOME/sqwConfig/sqwrs_Global.lib specifically for this user .


See the detailed help for sqwrs_Global.lib

sqwrs_NetBackup.lib

shell functions library $gvsqw_SybBin/../lib/sqwrs_NetBackup.lib:
lib for sqwgen_NetBackup.ksh

Nuvola apps information.png
Note:
You can overload functions contained in $gvsqw_SybBin/../lib/sqwrs_NetBackup.lib

by function with same name in $gvsqw_SybBin/../lib_cust/sqwrs_NetBackup.lib for all your environnement
or by $HOME/sqwConfig/sqwrs_NetBackup.lib specifically for this user .


See the detailed help for sqwrs_NetBackup.lib

sqwrs_SetEnv.lib

shell functions library $gvsqw_SybBin/../lib/sqwrs_SetEnv.lib:
fonction to set env for $DSQUERY

Nuvola apps information.png
Note:
You can overload functions contained in $gvsqw_SybBin/../lib/sqwrs_SetEnv.lib

by function with same name in $gvsqw_SybBin/../lib_cust/sqwrs_SetEnv.lib for all your environnement
or by $HOME/sqwConfig/sqwrs_SetEnv.lib specifically for this user .


See the detailed help for sqwrs_SetEnv.lib


menu


tools

sqwrs_Crypt.ksh

Script $gvsqw_SybBin/../tools/sqwrs_Crypt.ksh:
Generic script to crypt file with openssl See the detailed help for sqwrs_Crypt.ksh

sqwrs_GetSaPass.ksh

Script $gvsqw_SybBin/../tools/sqwrs_GetSaPass.ksh:
set env for $DSQUERY

Nuvola apps information.png
Note:
You can replace the file in $gvsqw_SybBin/../tools/sqwrs_GetSaPass.ksh

by $gvsqw_SybBin/../tools_cust/sqwrs_GetSaPass.ksh for all your environnement
or by $HOME/edtConfig/sqwrs_GetSaPass.ksh specifically for this user .

See the detailed help for sqwrs_GetSaPass.ksh

sqwrs_ListAsyncFilesGlobal.ksh

Script $gvsqw_SybBin/../tools/sqwrs_ListAsyncFilesGlobal.ksh:
List Async files (sql, log, mail) to upload in SQWareCentral (all in a directory) See the detailed help for sqwrs_ListAsyncFilesGlobal.ksh

sqwrs_ListAsyncFiles.ksh

Script $gvsqw_SybBin/../tools/sqwrs_ListAsyncFiles.ksh:
List Async files (sql, log, mail) to upload in SQWareCentral See the detailed help for sqwrs_ListAsyncFiles.ksh

sqwrs_SetEnv.ksh

Script $gvsqw_SybBin/../tools/sqwrs_SetEnv.ksh:
set env for $DSQUERY

Nuvola apps information.png
Note:
You can replace the file in $gvsqw_SybBin/../tools/sqwrs_SetEnv.ksh

by $gvsqw_SybBin/../tools_cust/sqwrs_SetEnv.ksh for all your environnement
or by $HOME/edtConfig/sqwrs_SetEnv.ksh specifically for this user .

See the detailed help for sqwrs_SetEnv.ksh

sqwrs_Spm.ksh

Script $gvsqw_SybBin/../tools/sqwrs_Spm.ksh:
request for SybaseRs See the detailed help for sqwrs_Spm.ksh

sqwrs_TestMySQL.ksh

Script $gvsqw_SybBin/../tools/sqwrs_TestMySQL.ksh:
Generic test MySQL connection script See the detailed help for sqwrs_TestMySQL.ksh

sqwrs_TestSendmail.ksh

Script $gvsqw_SybBin/../tools/sqwrs_TestSendmail.ksh:
Generic test sendmail script See the detailed help for sqwrs_TestSendmail.ksh

sqwrs_Uncrypt.ksh

Script $gvsqw_SybBin/../tools/sqwrs_Uncrypt.ksh:
Generic script to uncrypt file with openssl See the detailed help for sqwrs_Uncrypt.ksh


help

Contains help files for "-s" option of bin scripts.


spm

SQL query toolkit
See the detailed help for spm