Difference between revisions of "SQWareProduction:oracle"

Revision as of 21:56, 16 July 2010

Presentation

Usage

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

Explanation of directories

Directories located in $gvsqw_OraBin:

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

SqwArchmon

Script $gvsqw_OraBin/SqwArchmon:
Polling de sauvergarde par RMAN des archivelogs.
Voir l'aide détaillée pour SqwArchmon

sqwora_CheckIndicators.ksh

Script $gvsqw_OraBin/sqwora_CheckIndicators.ksh:
Check des indicateurs DBA:

Présence des indicateurs
Taux de remplissage des FS
Taux de remplissage des TBS
Présence de backups réussis
...

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

sqwora_CheckInstance.ksh

Script $gvsqw_OraBin/bin/sqwora_CheckInstance.ksh:
Check instance avec remontée des anomalies dans expdbDB:

Droits systèmes
Objets non SYS/SYTEM dans TBS SYSTEM
Quotas dangeureux
Droits/Roles dangeureux ou trop forts
...

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

sqwora_SqwArchmon.ksh

Script $gvsqw_OraBin/bin/sqwora_SqwArchmon.ksh:
Permet de commander le polling SqwArchmon, accessible par l'alias edtarchmon:

edtarchmon stop
edtarchmon start
edtarchmon status
edtarchmon reload

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

sqwora_Export.ksh

Script $gvsqw_OraBin/bin/sqwora_Export.ksh:
Permet de faire des exports (exp) de différents types (compressés ou pas):

full
schéma
structure
parfile

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

sqwora_GatherIndicators.ksh

Script $gvsqw_OraBin/bin/sqwora_GatherIndicators.ksh:
gather indicators
Voir l'aide détaillée pour sqwora_GatherIndicators.ksh

sqwora_GenerateAwr.ksh

Script $gvsqw_OraBin/bin/sqwora_GenerateAwr.ksh:
AWR report generation
Voir l'aide détaillée pour sqwora_GenerateAwr.ksh

sqwora_ParallelRun.ksh

Script $gvsqw_OraBin/bin/sqwora_ParallelRun.ksh:
Run of commands in // Voir l'aide détaillée pour sqwora_ParallelRun.ksh

sqwora_PartialRefresh.ksh

Script $gvsqw_OraBin/bin/sqwora_PartialRefresh.ksh:
Partial refresh by exp/imp
Voir l'aide détaillée pour sqwora_PartialRefresh.ksh

sqwora_PurgeAlert.ksh

Script $gvsqw_OraBin/bin/sqwora_PurgeAlert.ksh:
archiving/purge trace/alert files
Voir l'aide détaillée pour sqwora_PurgeAlert.ksh

sqwora_RmanBackup.ksh

Script $gvsqw_OraBin/bin/sqwora_RmanBackup.ksh:
RMAN backups
Voir l'aide détaillée pour sqwora_RmanBackup.ksh

sqwora_RmanClone.ksh

Script $gvsqw_OraBin/bin/sqwora_RmanClone.ksh:
RMAN clone
Voir l'aide détaillée pour sqwora_RmanClone.ksh

sqwora_RunJob.ksh

Script $gvsqw_OraBin/bin/sqwora_RunJob.ksh:
Run of oracle scripts
Voir l'aide détaillée pour sqwora_RunJob.ksh

sqwora_SchemaRefresh.ksh

Script $gvsqw_OraBin/bin/sqwora_SchemaRefresh.ksh:
Refresh one or more schemas by exp/imp
Voir l'aide détaillée pour sqwora_SchemaRefresh.ksh

etc

sqwora_Awr.cfg

Fichier de configuration $gvsqw_OraBin/../etc/sqwora_Awr.cfg:
config for AWR report generation

Note:
You can replace file $gvsqw_OraBin/../etc/sqwora_Awr.cfg

by $gvsqw_OraBin/../etc_cust/sqwora_Awr.cfg for all your environnement
or by $HOME/edtConfig/sqwora_Awr.cfg specifically for this user..

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

sqwora_CreDb_*.cfg

Fichiers de configuration $gvsqw_OraBin/../etc/sqwora_CreDb_*.cfg:
Templates servants à la génération des fichiers de configuration lors de la création d'une instance.

Note:
You can replace file $gvsqw_OraBin/../etc/sqwora_CreDb_*.cfg

by $gvsqw_OraBin/../etc_cust/sqwora_CreDb_*.cfg for all your environnement
or by $HOME/edtConfig/sqwora_CreDb_*.cfg specifically for this user..

Voir l'aide détaillée pour sqwora_CreDb_*.cfg

sqwora_DbRefVar.cfg

Fichier de configuration $gvsqw_OraBin/../etc/sqwora_DbRefVar.cfg:
Global var for indicators
Il contient les variables de fonctionnement de SQWareProduction.

Note:
You can overload variables contain in $gvsqw_OraBin/../etc/sqwora_DbRefVar.cfg

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

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

sqwora_GlobalVar.cfg

Fichier de configuration $gvsqw_OraBin/../etc/sqwora_GlobalVar.cfg:
Global var
Il contient les variables de fonctionnement de SQWareProduction.

Note:
You can overload variables contain in $gvsqw_OraBin/../etc/sqwora_GlobalVar.cfg

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

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

sqwora_Rman.cfg

Fichier de configuration $gvsqw_OraBin/../etc/sqwora_Rman.cfg:
Contient les variables servants aux différents scripts RMAN.

Note:
You can replace file $gvsqw_OraBin/../etc/sqwora_Rman.cfg

by $gvsqw_OraBin/../etc_cust/sqwora_Rman.cfg for all your environnement
or by $HOME/edtConfig/sqwora_Rman.cfg specifically for this user..

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

sqwora_RmanClone.cfg

Fichier de configuration $gvsqw_OraBin/../etc/sqwora_RmanClone.cfg:
var for RMAN duplicate scripts

Note:
You can replace file $gvsqw_OraBin/../etc/sqwora_RmanClone.cfg

by $gvsqw_OraBin/../etc_cust/sqwora_RmanClone.cfg for all your environnement
or by $HOME/edtConfig/sqwora_RmanClone.cfg specifically for this user..

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

.profile

Fichier d'exemple $gvsqw_OraBin/../etc/.profile:
Exemple de profile pour un user propriétaire d'une instance Oracle. Voir l'aide détaillée pour .profile

.profile_confort

Fichier de positionnement d'alias $gvsqw_OraBin/../etc/.profile_confort:
Variables et alias de confort pour le user unix.

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

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

sqwora_CheckIndicators.lib

Librairie de fonctions shell $gvsqw_OraBin/../lib/sqwora_CheckIndicators.lib:
lib for sqwora_CheckIndicators.ksh

Note:
You can overload functions contained in $gvsqw_OraBin/../lib/sqwora_CheckIndicators.lib

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

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

sqwora_CheckIndicators_Overload.lib

Librairie de fonctions shell $gvsqw_OraBin/../lib/sqwora_CheckIndicators_Overload.lib:
template lib for overload sqwora_CheckIndicators.ksh

Note:
You can overload functions contained in $gvsqw_OraBin/../lib/sqwora_CheckIndicators_Overload.lib

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

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

sqwora_CheckInstance.lib

Librairie de fonctions shell $gvsqw_OraBin/../lib/sqwora_CheckInstance.lib:
lib for sqwora_CheckInstance.ksh

Note:
You can overload functions contained in $gvsqw_OraBin/../lib/sqwora_CheckInstance.lib

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

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

sqwora_CheckInstance_Overload.lib

Librairie de fonctions shell $gvsqw_OraBin/../lib/sqwora_CheckInstance_Overload.lib:
lib for overload sqwora_CheckInstance.ksh

Note:
You can overload functions contained in $gvsqw_OraBin/../lib/sqwora_CheckInstance_Overload.lib

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

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

sqwora_GatherIndicators.lib

Librairie de fonctions shell $gvsqw_OraBin/../lib/sqwora_GatherIndicators.lib:
lib for sqwora_GatherIndicators.ksh

Note:
You can overload functions contained in $gvsqw_OraBin/../lib/sqwora_GatherIndicators.lib

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

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

sqwora_GatherIndicators_Overload.lib

Librairie de fonctions shell $gvsqw_OraBin/../lib/sqwora_GatherIndicators_Overload.lib:
lib for overload sqwora_GatherIndicators.ksh

Note:
You can overload functions contained in $gvsqw_OraBin/../lib/sqwora_GatherIndicators_Overload.lib

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

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

sqwora_GenerateAwr.lib

Librairie de fonctions shell $gvsqw_OraBin/../lib/sqwora_GenerateAwr.lib:
lib for sqwora_GatherIndicators.ksh

Note:
You can overload functions contained in $gvsqw_OraBin/../lib/sqwora_GenerateAwr.lib

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

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

sqwora_GenerateCreateDatabase.lib

Librairie de fonctions shell $gvsqw_OraBin/../lib/sqwora_GenerateCreateDatabase.lib:
lib for generate create database

Note:
You can overload functions contained in $gvsqw_OraBin/../lib/sqwora_GenerateCreateDatabase.lib

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

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

sqwora_Global.lib

Librairie de fonctions shell $gvsqw_OraBin/../lib/sqwora_Global.lib:
central lib of generic fonctions
Voir l'aide détaillée pour sqwora_Global.lib

sqwora_InsertIndicators.lib

Librairie de fonctions shell $gvsqw_OraBin/../lib/sqwora_InsertIndicators.lib:
generic fonctions to insert into referential

Note:
You can overload functions contained in $gvsqw_OraBin/../lib/sqwora_InsertIndicators.lib

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

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

sqwora_RmanBackup.lib

Librairie de fonctions shell $gvsqw_OraBin/../lib/sqwora_RmanBackup.lib:
lib for RMAN backup

Note:
You can overload functions contained in $gvsqw_OraBin/../lib/sqwora_RmanBackup.lib

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

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

sqwora_RmanClone.lib

Librairie de fonctions shell $gvsqw_OraBin/../lib/sqwora_RmanClone.lib:
lib for RMAN clone

Note:
You can overload functions contained in $gvsqw_OraBin/../lib/sqwora_RmanClone.lib

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

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

sqwora_SetEnv.lib

Librairie de fonctions shell $gvsqw_OraBin/../lib/sqwora_SetEnv.lib:

fonction to set env for $ORACLE_SID

Note:
You can overload functions contained in $gvsqw_OraBin/../lib/sqwora_SetEnv.lib

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

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

tools

sqwora_GenerateCreateDatabase.ksh

Script $gvsqw_OraBin/../tools/sqwora_GenerateCreateDatabase.ksh:
Generate create database files
Voir l'aide détaillée pour sqwora_GenerateCreateDatabase.ksh

sqwora_RmanConfigure.ksh

Script $gvsqw_OraBin/../tools/sqwora_RmanConfigure.ksh:
default paraters for RMAN and block change tracking
Voir l'aide détaillée pour sqwora_RmanConfigure.ksh

sqwora_RmanCrosscheck.ksh

Script $gvsqw_OraBin/../tools/sqwora_RmanCrosscheck.ksh:
Crosscheck and delete expired RMAN
Voir l'aide détaillée pour sqwora_RmanCrosscheck.ksh

sqwora_RmanRegister.ksh

Script $gvsqw_OraBin/../tools/sqwora_RmanRegister.ksh:
default paraters for RMAN and block change tracking
Voir l'aide détaillée pour sqwora_RmanRegister.ksh

sqwora_SetEnv.ksh

Script $gvsqw_OraBin/../tools/sqwora_SetEnv.ksh:
set env for $ORACLE_SID

Note:
You can replace the file in $gvsqw_OraBin/../tools/sqwora_SetEnv.ksh

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

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

sqwora_Spm.ksh

Script $gvsqw_OraBin/../tools/sqwora_Spm.ksh:
Sqlplus tools
Voir l'aide détaillée pour sqwora_Spm.ksh

spm

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

@@ Line 11: / Line 11: @@
 == bin ==
 === SqwArchmon ===
-Script $gvsqw_OraBin/../bin/SqwArchmon:<br>
+Script $gvsqw_OraBin/SqwArchmon:<br>
 Polling de sauvergarde par RMAN des archivelogs.<br>
 [[SQWareProduction:oracle:bin:SqwArchmon|Voir l'aide détaillée pour SqwArchmon]]<br>
@@ Line 17: / Line 17: @@
 === sqwora_CheckIndicators.ksh ===
-Script $gvsqw_OraBin/../bin/sqwora_CheckIndicators.ksh:<br>
+Script $gvsqw_OraBin/sqwora_CheckIndicators.ksh:<br>
 Check des indicateurs DBA:<br>
 *Présence des indicateurs
@@ Line 28: / Line 28: @@
 === sqwora_CheckInstance.ksh ===
-Script $gvsqw_OraBin/../bin/sqwora_CheckInstance.ksh:<br>
+Script $gvsqw_OraBin/bin/sqwora_CheckInstance.ksh:<br>
 Check instance avec remontée des anomalies dans expdbDB:<br>
 *Droits systèmes
@@ Line 39: / Line 39: @@
 === sqwora_SqwArchmon.ksh ===
-Script $gvsqw_OraBin/../bin/sqwora_SqwArchmon.ksh:<br>
+Script $gvsqw_OraBin/bin/sqwora_SqwArchmon.ksh:<br>
 Permet de commander le polling SqwArchmon, accessible par l'alias edtarchmon:<br>
 *edtarchmon stop
@@ Line 49: / Line 49: @@
 === sqwora_Export.ksh ===
-Script $gvsqw_OraBin/../bin/sqwora_Export.ksh:<br>
+Script $gvsqw_OraBin/bin/sqwora_Export.ksh:<br>
 Permet de faire des exports (exp) de différents types (compressés ou pas):<br>
 *full
@@ Line 59: / Line 59: @@
 === sqwora_GatherIndicators.ksh ===
-Script $gvsqw_OraBin/../bin/sqwora_GatherIndicators.ksh:<br>
+Script $gvsqw_OraBin/bin/sqwora_GatherIndicators.ksh:<br>
 gather indicators<br>
 [[SQWareProduction:oracle:bin:sqwora_GatherIndicators.ksh|Voir l'aide détaillée pour sqwora_GatherIndicators.ksh]]<br>
@@ Line 65: / Line 65: @@
 === sqwora_GenerateAwr.ksh ===
-Script $gvsqw_OraBin/../bin/sqwora_GenerateAwr.ksh:<br>
+Script $gvsqw_OraBin/bin/sqwora_GenerateAwr.ksh:<br>
 AWR report generation<br>
 [[SQWareProduction:oracle:bin:sqwora_GenerateAwr.ksh|Voir l'aide détaillée pour sqwora_GenerateAwr.ksh]]<br>
@@ Line 71: / Line 71: @@
 === sqwora_ParallelRun.ksh ===
-Script $gvsqw_OraBin/../bin/sqwora_ParallelRun.ksh:<br>
+Script $gvsqw_OraBin/bin/sqwora_ParallelRun.ksh:<br>
 Run of commands in //
 [[SQWareProduction:oracle:bin:sqwora_ParallelRun.ksh|Voir l'aide détaillée pour sqwora_ParallelRun.ksh]]<br>
@@ Line 77: / Line 77: @@
 === sqwora_PartialRefresh.ksh ===
-Script $gvsqw_OraBin/../bin/sqwora_PartialRefresh.ksh:<br>
+Script $gvsqw_OraBin/bin/sqwora_PartialRefresh.ksh:<br>
 Partial refresh by exp/imp<br>
 [[SQWareProduction:oracle:bin:sqwora_PartialRefresh.ksh|Voir l'aide détaillée pour sqwora_PartialRefresh.ksh]]<br>
@@ Line 83: / Line 83: @@
 === sqwora_PurgeAlert.ksh ===
-Script $gvsqw_OraBin/../bin/sqwora_PurgeAlert.ksh:<br>
+Script $gvsqw_OraBin/bin/sqwora_PurgeAlert.ksh:<br>
 archiving/purge trace/alert files<br>
 [[SQWareProduction:oracle:bin:sqwora_PurgeAlert.ksh|Voir l'aide détaillée pour sqwora_PurgeAlert.ksh]]<br>
@@ Line 89: / Line 89: @@
 === sqwora_RmanBackup.ksh ===
-Script $gvsqw_OraBin/../bin/sqwora_RmanBackup.ksh:<br>
+Script $gvsqw_OraBin/bin/sqwora_RmanBackup.ksh:<br>
 RMAN backups<br>
 [[SQWareProduction:oracle:bin:sqwora_RmanBackup.ksh|Voir l'aide détaillée pour sqwora_RmanBackup.ksh]]<br>
@@ Line 95: / Line 95: @@
 === sqwora_RmanClone.ksh ===
-Script $gvsqw_OraBin/../bin/sqwora_RmanClone.ksh:<br>
+Script $gvsqw_OraBin/bin/sqwora_RmanClone.ksh:<br>
 RMAN clone<br>
 [[SQWareProduction:oracle:bin:sqwora_RmanClone.ksh|Voir l'aide détaillée pour sqwora_RmanClone.ksh]]<br>
@@ Line 101: / Line 101: @@
 === sqwora_RunJob.ksh ===
-Script $gvsqw_OraBin/../bin/sqwora_RunJob.ksh:<br>
+Script $gvsqw_OraBin/bin/sqwora_RunJob.ksh:<br>
 Run of oracle scripts<br>
 [[SQWareProduction:oracle:bin:sqwora_RunJob.ksh|Voir l'aide détaillée pour sqwora_RunJob.ksh]]<br>
@@ Line 107: / Line 107: @@
 === sqwora_SchemaRefresh.ksh ===
-Script $gvsqw_OraBin/../bin/sqwora_SchemaRefresh.ksh:<br>
+Script $gvsqw_OraBin/bin/sqwora_SchemaRefresh.ksh:<br>
 Refresh one or more schemas by exp/imp<br>
 [[SQWareProduction:oracle:bin:sqwora_SchemaRefresh.ksh|Voir l'aide détaillée pour sqwora_SchemaRefresh.ksh]]<br>