Difference between revisions of "SQWareProduction:mssql"

Revision as of 23:52, 16 July 2010

Presentation

Usage

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

Explanation of directories

Directories located in $gvsqw_MsqBin:

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

sqwmsq_BackupAllDatabases.ksh

Script $gvsqw_MssBin/../bin/sqwmsq_BackupAllDatabases.ksh:
Lancement sqwmsq_BackupDatabase.ksh en // pour toutes les databases avec sqwmsq_ParallelRun.ksh
Voir l'aide détaillée pour sqwmsq_BackupAllDatabases.ksh

sqwmsq_BackupDatabase.ksh

Script $gvsqw_MssBin/../bin/sqwmsq_BackupDatabase.ksh:
Backup database
Voir l'aide détaillée pour sqwmsq_BackupDatabase.ksh

sqwmsq_CheckIndicators.ksh

Script $gvsqw_MssBin/../bin/sqwmsq_CheckIndicators.ksh:
Check des indicateurs:

Présence des indicateurs
Volumétrie des databases
...

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

sqwmsq_GatherIndicators.ksh

Script $gvsqw_MssBin/../bin/sqwmsq_GatherIndicators.ksh:
Collecte d'indicateurs Mssql:

Volumétrie et paramètres globaux
Volumétrie par database
...

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

sqwmsq_ParallelRun.ksh

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

sqwmsq_RebuildIndexAllDatabases.ksh

Script $gvsqw_MssBin/../bin/sqwmsq_RebuildIndexAllDatabases.ksh:
Lancement sqwmsq_RebuildIndexDatabase.ksh en // pour toutes les databases avec sqwmsq_ParallelRun.ksh
Voir l'aide détaillée pour sqwmsq_RebuildIndexAllDatabases.ksh

sqwmsq_RebuildIndexDatabase.ksh

Script $gvsqw_MssBin/../bin/sqwmsq_RebuildIndexDatabase.ksh:
Rebuild indexes
Voir l'aide détaillée pour sqwmsq_RebuildIndexDatabase.ksh

sqwmsq_RestoreAllDatabases.ksh

Script $gvsqw_MssBin/../bin/sqwmsq_RestoreAllDatabases.ksh:
Lancement sqwmsq_RestoreDatabase.ksh en // pour toutes les databases avec sqwmsq_ParallelRun.ksh
Voir l'aide détaillée pour sqwmsq_RestoreAllDatabases.ksh

sqwmsq_RestoreDatabase.ksh

Script $gvsqw_MssBin/../bin/sqwmsq_RestoreDatabase.ksh:
Restore database
Voir l'aide détaillée pour sqwmsq_RestoreDatabase.ksh

sqwmsq_RotateErrorLog.ksh

Script $gvsqw_MssBin/../bin/sqwmsq_RotateErrorLog.ksh:
Rotation de l'error log
Voir l'aide détaillée pour sqwmsq_RotateErrorLog.ksh

sqwmsq_RunJob.ksh

Script $gvsqw_MssBin/../bin/sqwmsq_RunJob.ksh:
Lancement de jobs Mssql à partir des action paramétrées dans le fichier $gvsqw_RootAdmin/sqwmsq_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 sqwmsq_RunJob.ksh

sqwmsq_StatisticsAllDatabases.ksh

Script $gvsqw_MssBin/../bin/sqwmsq_StatisticsAllDatabases.ksh:
Lancement sqwmsq_StatisticsDatabase.ksh en // pour toutes les databases avec sqwmsq_ParallelRun.ksh
Voir l'aide détaillée pour sqwmsq_StatisticsAllDatabases.ksh

sqwmsq_StatisticsDatabase.ksh

Script $gvsqw_MssBin/../bin/sqwmsq_StatisticsDatabase.ksh:
Update stats
Voir l'aide détaillée pour sqwmsq_StatisticsDatabase.ksh

etc

sqwmsq_DbRefVar.cfg

Fichier de configuration $gvsqw_MssBin/../etc/sqwmsq_DbRefVar.cfg:
Variables de connexion à SQWareRepository pour Mssql.

Note:
You can overload variables contain in $gvsqw_MssBin/../etc/sqwmsq_DbRefVar.cfg

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

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

sqwmsq_GlobalVar.cfg

Fichier de configuration $gvsqw_MssBin/../etc/sqwmsq_GlobalVar.cfg:
Il contient les variables globales de SQWareProduction.

Note:
You can overload variables contain in $gvsqw_MssBin/../etc/sqwmsq_GlobalVar.cfg

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

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

sqwmsq_Jobs.cfg

Fichier de configuration $gvsqw_MssBin/../etc/sqwmsq_Jobs.cfg:
Fichier d'exemple de job pour Mssql.
Voir l'aide détaillée pour sqwmsq_Jobs.cfg

.profile

Fichier d'exemple $gvsqw_MssBin/../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_MssBin/../etc/.profile_confort:
Position de l'environnement de confort (alias, variables, ...).

Note:
You can overload confort environnement $gvsqw_MssBin/../etc/.profile_confort

with $gvsqw_MssBin/../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

sqwmsq_BackupDatabase.lib

Librairie de fonctions shell $gvsqw_MssBin/../lib/sqwmsq_BackupDatabase.lib:
Lib pour le script sqwmsq_BackupDatabase.ksh

Note:
You can overload functions contained in $gvsqw_MssBin/../lib/sqwmsq_BackupDatabase.lib

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

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

sqwmsq_CheckIndicators.lib

Librairie de fonctions shell $gvsqw_MssBin/../lib/sqwmsq_CheckIndicators.lib:
Lib pour le script sqwmsq_CheckIndicators.ksh

Note:
You can overload functions contained in $gvsqw_MssBin/../lib/sqwmsq_CheckIndicators.lib

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

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

sqwmsq_CheckIndicators_Overload.lib

Librairie de fonctions shell $gvsqw_MssBin/../lib/sqwmsq_CheckIndicators_Overload.lib:
temple lib pour surcharger le script sqwmsq_CheckIndicators.ksh

Note:
You can overload functions contained in $gvsqw_MssBin/../lib/sqwmsq_CheckIndicators_Overload.lib

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

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

sqwmsq_GatherIndicators.lib

Librairie de fonctions shell $gvsqw_MssBin/../lib/sqwmsq_GatherIndicators.lib:
Lib pour le script sqwmsq_GatherIndicators.ksh

Note:
You can overload functions contained in $gvsqw_MssBin/../lib/sqwmsq_GatherIndicators.lib

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

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

sqwmsq_GatherIndicators_Overload.lib

Librairie de fonctions shell $gvsqw_MssBin/../lib/sqwmsq_GatherIndicators_Overload.lib:
Lib pour le script overload sqwmsq_GatherIndicators.ksh

Note:
You can overload functions contained in $gvsqw_MssBin/../lib/sqwmsq_GatherIndicators_Overload.lib

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

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

sqwmsq_Global.lib

Librairie de fonctions shell $gvsqw_MssBin/../lib/sqwmsq_Global.lib:
Lib de fonctions génériques pour tous les scripts.
Voir l'aide détaillée pour sqwmsq_Global.lib

sqwmsq_InsertIndicators.lib

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

Note:
You can overload functions contained in $gvsqw_MssBin/../lib/sqwmsq_InsertIndicators.lib

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

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

sqwmsq_RestoreDatabase.lib

Librairie de fonctions shell $gvsqw_MssBin/../lib/sqwmsq_RestoreDatabase.lib:
Lib pour le script sqwmsq_RestoreDatabase.ksh

Note:
You can overload functions contained in $gvsqw_MssBin/../lib/sqwmsq_RestoreDatabase.lib

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

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

sqwmsq_SetEnv.lib

Librairie de fonctions shell $gvsqw_MssBin/../lib/sqwmsq_SetEnv.lib:
fonction to set env for Mssql

Note:
You can overload functions contained in $gvsqw_MssBin/../lib/sqwmsq_SetEnv.lib

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

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

tools

spm

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

@@ Line 116: / Line 116: @@
 === sqwmsq_BackupDatabase.lib ===
 Librairie de fonctions shell $gvsqw_MssBin/../lib/sqwmsq_BackupDatabase.lib:<br>
-lib for sqwmsq_BackupDatabase.ksh
+Lib pour le script sqwmsq_BackupDatabase.ksh<br>
-<br>
 {{SQWareProductionSurchargeLib|mssql|Mss|sqwmsq_BackupDatabase.lib}}
-<br>
 [[SQWareProduction:mssql:lib:sqwmsq_BackupDatabase.lib|Voir l'aide détaillée pour sqwmsq_BackupDatabase.lib]]<br>
 === sqwmsq_CheckIndicators.lib ===
 Librairie de fonctions shell $gvsqw_MssBin/../lib/sqwmsq_CheckIndicators.lib:<br>
-lib for sqwmsq_CheckIndicators.ksh
+Lib pour le script sqwmsq_CheckIndicators.ksh<br>
-<br>
 {{SQWareProductionSurchargeLib|mssql|Mss|sqwmsq_CheckIndicators.lib}}
-<br>
 [[SQWareProduction:mssql:lib:sqwmsq_CheckIndicators.lib|Voir l'aide détaillée pour sqwmsq_CheckIndicators.lib]]<br>
 === sqwmsq_CheckIndicators_Overload.lib ===
 Librairie de fonctions shell $gvsqw_MssBin/../lib/sqwmsq_CheckIndicators_Overload.lib:<br>
-temple lib for overload sqwmsq_CheckIndicators.ksh
+temple lib pour surcharger le script sqwmsq_CheckIndicators.ksh<br>
-<br>
 {{SQWareProductionSurchargeLib|mssql|Mss|sqwmsq_CheckIndicators_Overload.lib}}
-<br>
 [[SQWareProduction:mssql:lib:sqwmsq_CheckIndicators_Overload.lib|Voir l'aide détaillée pour sqwmsq_CheckIndicators_Overload.lib]]<br>
 === sqwmsq_GatherIndicators.lib ===
 Librairie de fonctions shell $gvsqw_MssBin/../lib/sqwmsq_GatherIndicators.lib:<br>
-lib for sqwmsq_GatherIndicators.ksh
+Lib pour le script sqwmsq_GatherIndicators.ksh<br>
-<br>
 {{SQWareProductionSurchargeLib|mssql|Mss|sqwmsq_GatherIndicators.lib}}
-<br>
 [[SQWareProduction:mssql:lib:sqwmsq_GatherIndicators.lib|Voir l'aide détaillée pour sqwmsq_GatherIndicators.lib]]<br>
 === sqwmsq_GatherIndicators_Overload.lib ===
 Librairie de fonctions shell $gvsqw_MssBin/../lib/sqwmsq_GatherIndicators_Overload.lib:<br>
-lib for overload sqwmsq_GatherIndicators.ksh
+Lib pour le script overload sqwmsq_GatherIndicators.ksh<br>
-<br>
 {{SQWareProductionSurchargeLib|mssql|Mss|sqwmsq_GatherIndicators_Overload.lib}}
-<br>
 [[SQWareProduction:mssql:lib:sqwmsq_GatherIndicators_Overload.lib|Voir l'aide détaillée pour sqwmsq_GatherIndicators_Overload.lib]]<br>
 === sqwmsq_Global.lib ===
 Librairie de fonctions shell $gvsqw_MssBin/../lib/sqwmsq_Global.lib:<br>
-central lib of generic fonctions
+Lib de fonctions génériques pour tous les scripts.<br>
-<br>
-{{SQWareProductionSurchargeLib|mssql|Mss|sqwmsq_Global.lib}}
-<br>
 [[SQWareProduction:mssql:lib:sqwmsq_Global.lib|Voir l'aide détaillée pour sqwmsq_Global.lib]]<br>
 === sqwmsq_InsertIndicators.lib ===
 Librairie de fonctions shell $gvsqw_MssBin/../lib/sqwmsq_InsertIndicators.lib:<br>
-generic fonctions to insert into referential
+Lib générique de fonctions d'insert dans SQWareRepository<br>
-<br>
 {{SQWareProductionSurchargeLib|mssql|Mss|sqwmsq_InsertIndicators.lib}}
-<br>
 [[SQWareProduction:mssql:lib:sqwmsq_InsertIndicators.lib|Voir l'aide détaillée pour sqwmsq_InsertIndicators.lib]]<br>
 === sqwmsq_RestoreDatabase.lib ===
 Librairie de fonctions shell $gvsqw_MssBin/../lib/sqwmsq_RestoreDatabase.lib:<br>
-lib for sqwmsq_RestoreDatabase.ksh
+Lib pour le script sqwmsq_RestoreDatabase.ksh<br>
-<br>
 {{SQWareProductionSurchargeLib|mssql|Mss|sqwmsq_RestoreDatabase.lib}}
-<br>
 [[SQWareProduction:mssql:lib:sqwmsq_RestoreDatabase.lib|Voir l'aide détaillée pour sqwmsq_RestoreDatabase.lib]]<br>
 === sqwmsq_SetEnv.lib ===
 Librairie de fonctions shell $gvsqw_MssBin/../lib/sqwmsq_SetEnv.lib:<br>
-fonction to set env for Mssql
+fonction to set env for Mssql<br>
-<br>
 {{SQWareProductionSurchargeLib|mssql|Mss|sqwmsq_SetEnv.lib}}
-<br>
 [[SQWareProduction:mssql:lib:sqwmsq_SetEnv.lib|Voir l'aide détaillée pour sqwmsq_SetEnv.lib]]<br>