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

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

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

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.

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.

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.

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.

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.

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.

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

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

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

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

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

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

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

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

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.

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

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.

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.

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

menu

sqwora_MenuRman.ksh

Menu $gvsqw_OraBin/../menu/sqwora_MenuRman.ksh:
Menu shel de gestion de commandes RMAN:

• Lancement de backups (full, inc, log)
• Lancement de restaurations (complète, incomplète, cross incarnation, ...)
• Validation de la structure FS à partir du catalogue
• Restauration par clone partiel
• Gestion du catalogue (delete, crosscheck, report, list, ...)
• ...

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

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

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
Voir l'aide détaillée pour spm