SQWareProduction:oracle

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:
Collecte un certain nombre d'indicateurs et les remonte dans SQWareRepository:

Volumétrie et paramètres généreaux
Volumétrie par TBS
Volumétrie par FS
Volumétrie par SCHEMA >= x Mo
Volumétrie par SEGMENTS >= y Mo
...

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

sqwora_GenerateAwr.ksh

Script $gvsqw_OraBin/bin/sqwora_GenerateAwr.ksh:
Génération automatique de rapports AWR entre dates définies avec remontée d'indicateurs dans SQWareRepository et accessibilité des rapports dans SQWareWeb:

Rapports complets text+html
Résumé du rapport avec tops elapsed, CPU, Gets, Physicals, Execution
Rapports AWR par sql_id apparaissants dans le résumé
...

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

sqwora_ParallelRun.ksh

Script $gvsqw_OraBin/bin/sqwora_ParallelRun.ksh:
Permet l'exécution de commandes Unix mises dans un fichier en //
Utilisé notamment dans les copies de backups pour clone d'environnement et dans bien d'autres cas ...
Voir l'aide détaillée pour sqwora_ParallelRun.ksh

sqwora_PartialRefresh.ksh

Script $gvsqw_OraBin/bin/sqwora_PartialRefresh.ksh:
Permet le refresh partiel (d'une liste de tables) par exp/imp.
Voir l'aide détaillée pour sqwora_PartialRefresh.ksh

sqwora_PurgeAlert.ksh

Script $gvsqw_OraBin/bin/sqwora_PurgeAlert.ksh:
Archage/purge des fichiers de traces, logs, alerte, core, audit, ...
Voir l'aide détaillée pour sqwora_PurgeAlert.ksh

sqwora_RmanBackup.ksh

Script $gvsqw_OraBin/bin/sqwora_RmanBackup.ksh:
Gère les backups RMAN:

full/incrémentaux/log
hot/cold
gestion catalogue
gestion historiques
...

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

sqwora_RmanClone.ksh

Script $gvsqw_OraBin/bin/sqwora_RmanClone.ksh:
Permet de faire des clones d'instances par RMAN.
Voir l'aide détaillée pour sqwora_RmanClone.ksh

sqwora_RunJob.ksh

Script $gvsqw_OraBin/bin/sqwora_RunJob.ksh:
Lancement de jobs Oracle à partir des action paramétrées dans le fichier $gvsqw_RootAdmin/sqwora_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 sqwora_RunJob.ksh

sqwora_SchemaRefresh.ksh

Script $gvsqw_OraBin/bin/sqwora_SchemaRefresh.ksh:
Permet le rafraichissement de shéma par 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:
Il contient les variables de cponnexion à SQWareRepository pour 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:
Il contient les variables globales au 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:
Contient les variables servant au script de clone RMAN.

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 pour le script 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 de surcharge pour le script 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 pour le script 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 pour surcharge du script 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 pour le script 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 pour surcharge du script 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 pour le script sqwora_GenerateAwr.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 pour le script sqwora_GenerateCreateDatabase.ksh

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:
Lib centrale pour l'ensemble des scripts.
Voir l'aide détaillée pour sqwora_Global.lib

sqwora_InsertIndicators.lib

Librairie de fonctions shell $gvsqw_OraBin/../lib/sqwora_InsertIndicators.lib:
Lib générique de fonctions pour insert des indicateurs dans SQWareRepository.

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 pour le script sqwora_RmanBackup.ksh

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 pour le script sqwora_RmanClone.ksh.

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:

Lib de positionnement de l'environnement pour $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:
Génération des fichier de configuration pour créer une nouvelle instance:

create database
fichier d'init
fichier de gestion des jobs
crontab par défaut
tnsnames.ora et listener.ora
...

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

sqwora_RmanConfigure.ksh

Script $gvsqw_OraBin/../tools/sqwora_RmanConfigure.ksh:
Réalise une configuration par défaut de l'instance pour les sauvegardes:

Enregistrement dans le catalogue RMAN
Paramètres par défaut RMAN (retention, compression, snapshot, autobackup,...)
Activation du block change tracking

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

sqwora_RmanCrosscheck.ksh

Script $gvsqw_OraBin/../tools/sqwora_RmanCrosscheck.ksh:
Lance les commandes RMAN suivantes:

crosscheck backup
crosscheck copy
delete expired backup
delete expired copy

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

sqwora_RmanRegister.ksh

Script $gvsqw_OraBin/../tools/sqwora_RmanRegister.ksh:
Enregistre la base dans le catalogue RMAN.
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:
Outil qui permet de lancer dans sqlplus un certain nombre de requêtes déjà écrites (dont le résultat est formaté):

Volumétries
Sessions
Objets
...

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

spm

Ensemble de requêtes sql usuelles déjà écrites qui produisent un résultat formaté.
Voir l'aide détaillée pour spm