SQWareProduction:sybase

Presentation

Usage

It's the module locally operating of Sybase.
It is entirely written in ksh and sql.
It allows to manage the operation for Sybase.
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 Sybase

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

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

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

sqwsyb_CheckIndicators.ksh

Script $gvsqw_SybBin/sqwsyb_CheckIndicators.ksh:
Check des indicateurs DBA:

Présence des indicateurs
Volumétrie des databases
Volumétrie des FS
Présence de backups
...

Voir l'aide détaillée pour sqwsyb_CheckIndicators.ksh

sqwsyb_CheckstorageAllDatabases.ksh

Script $gvsqw_SybBin/sqwsyb_CheckstorageAllDatabases.ksh:
Lancement de sqwsyb_CheckstorageDatabase.ksh en // avec sqwsyb_ParallelRun.ksh
Voir l'aide détaillée pour sqwsyb_CheckstorageAllDatabases.ksh

sqwsyb_CheckstorageDatabase.ksh

Script $gvsqw_SybBin/sqwsyb_CheckstorageDatabase.ksh:
checkstorage database
Voir l'aide détaillée pour sqwsyb_CheckstorageDatabase.ksh

sqwsyb_CopyDumpDatabase.ksh

Script $gvsqw_SybBin/sqwsyb_CopyDumpDatabase.ksh:
Copie les fichiers de dump par scp
Voir l'aide détaillée pour sqwsyb_CopyDumpDatabase.ksh

sqwsyb_DbccAllDatabases.ksh

Script $gvsqw_SybBin/sqwsyb_DbccAllDatabases.ksh:
Lancement de sqwsyb_DbccDatabase.ksh en // avec sqwsyb_ParallelRun.ksh
Voir l'aide détaillée pour sqwsyb_DbccAllDatabases.ksh

sqwsyb_DbccDatabase.ksh

Script $gvsqw_SybBin/sqwsyb_DbccDatabase.ksh:
dbcc database
Voir l'aide détaillée pour sqwsyb_DbccDatabase.ksh

sqwsyb_DumpAllDatabases.ksh

Script $gvsqw_SybBin/sqwsyb_DumpAllDatabases.ksh:
Lancement de sqwsyb_DumpDatabase.ksh en // avec sqwsyb_ParallelRun.ksh
Voir l'aide détaillée pour sqwsyb_DumpAllDatabases.ksh

sqwsyb_DumpDatabase.ksh

Script $gvsqw_SybBin/sqwsyb_DumpDatabase.ksh:
dump script
Voir l'aide détaillée pour sqwsyb_DumpDatabase.ksh

sqwsyb_GatherIndicators.ksh

Script $gvsqw_SybBin/sqwsyb_GatherIndicators.ksh:
Collecte d'indicateurs Sybase remontés dans SQWareRepository:

Volumétrie et paramètres globaux
Volumétrie par database
Volumétrie par table >= x Mo
Volumétrie par FS
...

Voir l'aide détaillée pour sqwsyb_GatherIndicators.ksh

sqwsyb_KillSessions.ksh

Script $gvsqw_SybBin/sqwsyb_KillSessions.ksh:
Kill des connexions sybase
Voir l'aide détaillée pour sqwsyb_KillSessions.ksh

sqwsyb_LoadDatabase.ksh

Script $gvsqw_SybBin/sqwsyb_LoadDatabase.ksh:
Load database sybase
Voir l'aide détaillée pour sqwsyb_LoadDatabase.ksh

sqwsyb_ParallelRun.ksh

Script $gvsqw_SybBin/sqwsyb_ParallelRun.ksh:
Lancement de commandes unix en //
Voir l'aide détaillée pour sqwsyb_ParallelRun.ksh

sqwsyb_RebuildAllDatabases.ksh

Script $gvsqw_SybBin/sqwsyb_RebuildAllDatabases.ksh:
Lancement de sqwsyb_ReorgDatabase.ksh en // avec sqwsyb_ParallelRun.ksh
Voir l'aide détaillée pour sqwsyb_RebuildAllDatabases.ksh

sqwsyb_RebuildDatabase.ksh

Script $gvsqw_SybBin/sqwsyb_RebuildDatabase.ksh:
reorg tables
Voir l'aide détaillée pour sqwsyb_RebuildDatabase.ksh

sqwsyb_RunJob.ksh

Script $gvsqw_SybBin/sqwsyb_RunJob.ksh:
Lancement de jobs Sybase à partir des action paramétrées dans le fichier $gvsqw_RootAdmin/sqwsyb_Jobs.cfg, permet la gestion transparente des logs (compression/purge) et de décoréler le lancement de job de son paramétrage.
Voir l'aide détaillée pour sqwsyb_RunJob.ksh

sqwsyb_StatisticsAllDatabases.ksh

Script $gvsqw_SybBin/sqwsyb_StatisticsAllDatabases.ksh:
Lancement de sqwsyb_StatisticsDatabase.ksh en // avec sqwsyb_ParallelRun.ksh
Voir l'aide détaillée pour sqwsyb_StatisticsAllDatabases.ksh

sqwsyb_StatisticsDatabase.ksh

Script $gvsqw_SybBin/sqwsyb_StatisticsDatabase.ksh:
update statistics
Voir l'aide détaillée pour sqwsyb_StatisticsDatabase.ksh

etc

CrontabRef

Fichier de configuration $gvsqw_SybBin/../etc/CrontabRef:
Exemple de crontab pour Sybase.
Voir l'aide détaillée pour CrontabRef

sqwsyb_DbRefVar.cfg

Fichier de configuration $gvsqw_SybBin/../etc/sqwsyb_DbRefVar.cfg:
Contient les variables de connexion à SQWareRepository pour Sybase.
Il contient les variables de fonctionnement de SQWareProduction.

Note:
You can overload variables contain in $gvsqw_SybBin/../etc/sqwsyb_DbRefVar.cfg

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

Voir l'aide détaillée pour sqwsyb_DbRefVar.cfg

sqwsyb_GlobalVar.cfg

Fichier de configuration $gvsqw_SybBin/../etc/sqwsyb_GlobalVar.cfg:
Contient les variables globales pour SQWareProduction pour Sybase.

Note:
You can overload variables contain in $gvsqw_SybBin/../etc/sqwsyb_GlobalVar.cfg

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

Voir l'aide détaillée pour sqwsyb_GlobalVar.cfg

jobs.cfg

Fichier de configuration $gvsqw_SybBin/../etc/jobs.cfg:
Fichier d'exemple de job Sybase.
Voir l'aide détaillée pour jobs.cfg

template.cfg

Fichier de configuration $gvsqw_SybBin/../etc/template.cfg:
Template pour surcharger les paramètres par défaut de tous les scripts pour une database.
Voir l'aide détaillée pour template.cfg

.profile

Fichier d'exemple $gvsqw_SybBin/../etc/.profile:
Exemple de .profile pour un user unix.
Voir l'aide détaillée pour .profile

.profile_confort

Fichier de positionnement d'alias $gvsqw_SybBin/../etc/.profile_confort:
Positionne l'environnement de confort (alias, variables, ...).

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 .

Voir l'aide détaillée pour .profile_confort

lib

sqwsyb_CheckIndicators.lib

Librairie de fonctions shell $gvsqw_SybBin/../lib/sqwsyb_CheckIndicators.lib:
Lib pour le script sqwora_CheckIndicators.ksh

Note:
You can overload functions contained in $gvsqw_SybBin/../lib/sqwsyb_CheckIndicators.lib

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

Voir l'aide détaillée pour sqwsyb_CheckIndicators.lib

sqwsyb_CheckIndicators_Overload.lib

Librairie de fonctions shell $gvsqw_SybBin/../lib/sqwsyb_CheckIndicators_Overload.lib:
template lib pour surcharger le script sqwora_CheckIndicators.ksh

Note:
You can overload functions contained in $gvsqw_SybBin/../lib/sqwsyb_CheckIndicators_Overload.lib

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

Voir l'aide détaillée pour sqwsyb_CheckIndicators_Overload.lib

sqwsyb_DumpDatabase.lib

Librairie de fonctions shell $gvsqw_SybBin/../lib/sqwsyb_DumpDatabase.lib:
Lib pour le script sqwsyb_DumpDatabase.ksh

Note:
You can overload functions contained in $gvsqw_SybBin/../lib/sqwsyb_DumpDatabase.lib

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

Voir l'aide détaillée pour sqwsyb_DumpDatabase.lib

sqwsyb_GatherIndicators.lib

Librairie de fonctions shell $gvsqw_SybBin/../lib/sqwsyb_GatherIndicators.lib:
Lib pour le script sqwsyb_GatherIndicators.ksh

Note:
You can overload functions contained in $gvsqw_SybBin/../lib/sqwsyb_GatherIndicators.lib

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

Voir l'aide détaillée pour sqwsyb_GatherIndicators.lib

sqwsyb_Global.lib

Librairie de fonctions shell $gvsqw_SybBin/../lib/sqwsyb_Global.lib:
Lib centrale pour tous les scripts.

Note:
You can overload functions contained in $gvsqw_SybBin/../lib/sqwsyb_Global.lib

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

Voir l'aide détaillée pour sqwsyb_Global.lib

sqwsyb_InsertIndicators.lib

Librairie de fonctions shell $gvsqw_SybBin/../lib/sqwsyb_InsertIndicators.lib:
Lib générique de fonctions d' insert dans SQWareRepository

Note:
You can overload functions contained in $gvsqw_SybBin/../lib/sqwsyb_InsertIndicators.lib

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

Voir l'aide détaillée pour sqwsyb_InsertIndicators.lib

sqwsyb_SetEnv.lib

Librairie de fonctions shell $gvsqw_SybBin/../lib/sqwsyb_SetEnv.lib:
Fonction to set env for $DSQUERY

Note:
You can overload functions contained in $gvsqw_SybBin/../lib/sqwsyb_SetEnv.lib

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

Voir l'aide détaillée pour sqwsyb_SetEnv.lib

tools

sqwsyb_GetSaPass.ksh

Script $gvsqw_SybBin/../tools/sqwsyb_GetSaPass.ksh:
Récupère le mdp du user sa.

Note:
You can replace the file in $gvsqw_SybBin/../tools/sqwsyb_GetSaPass.ksh

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

Voir l'aide détaillée pour sqwsyb_GetSaPass.ksh

sqwsyb_SetEnv.ksh

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

Note:
You can replace the file in $gvsqw_SybBin/../tools/sqwsyb_SetEnv.ksh

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

Voir l'aide détaillée pour sqwsyb_SetEnv.ksh

sqwsyb_Spm.ksh

Script $gvsqw_SybBin/../tools/sqwsyb_Spm.ksh:
Lance des requêtes sybase avec résultat formaté.
Voir l'aide détaillée pour sqwsyb_Spm.ksh

spm

Ensemble de requêtes sql usuelles déjà écrites
Voir l'aide détaillée pour spm