Général:FAQ NouvelleInstanceOracle

Généralités

Dans ce chapitre, on considèrera que SQWareCentral a été installé sur dbsqware@sqwarebox ...

Limites de cette section

Ce chapitre ne traite que de l'ajout d'une nouvelle instance sur un socle déjà paramétré et fonctionnel. Utilisez les portions qui concernent votre environnement et utilisez la méthode match ou manuelle au choix !

MODOP général d'intégration d'une nouvelle instance Oracle

Il y aura potentiellement 1 ou 2 cas de connexion à traiter

• "locale", pour les machines unix où l'on va faire du "/ as sysdba" sur la machine qui porte l'instance (connexion ssh depuis dbsqware@sqwarebox)
• "distante", pour générer les AWR (éventuellement) ou pour le cas où l'on n'a accès à la machine en ssh (Windows, RDS, etc, ...)

Etapes classiques :

• Vérification des prérequis système pour la partie "locale" (ksh + rsync)
• Mise en place de l'environnement
• Tests "manuels"
• Mise en exploitation de l'instance

Vous verrez que ces étapes peuvent être traitée une par une ou par batch !

Intégration d'une instance Oracle

Vérification des prérequis système pour la partie "locale" (ksh + rsync)

Ne traitez cette partie que pour une connexion "locale". SQWareProduction étant écrit essentiellement en shell ksh et étant synchronisé depuis SQWareCentral avec rsync, il nous faut donc "ksh" et "rsync" installé !

Vérification

Adaptez à votre nom de user et nom de machine. ksh:

# oracle@my_oracle_host
type ksh
#ou
which ksh

rsync:

# oracle@my_oracle_host
type rsync
#ou
which rsync

Installation

Adaptez à votre type de machine (sudo si vous n'êtes pas root).
RedHat/CentOS:...:

yum install -y ksh rsync

Ubuntu/debian/...:

apt install -y ksh rsync

Mise en place de l'environnement

Général

Explication du "DbAlias" (la clé unique dbSQWare)

La clé dbSQWare doit être unique et raccord avec ce qui aura été paramétré pour la variable gvsqw_DbAlias dans sqwora_GlobalVar.cfg !
On a plus ou moins 3 cas ...

• Votre environnement est "standalone" et vos ORACLE_SID sont unique sur l'ensemble du parc => gvsqw_DbAlias='$ORACLE_SID'
• Votre environnement est "standalone" mais vous avez des "doublons" d'ORACLE_SID => gvsqw_DbAlias='$ORACLE_SID:$(hostname|cut -d '.' -f1)'
• Vous avez du RAC et/ou DG => gvsqw_DbAlias='$gvsqw_DB_UNIQUE_NAME:$gvsqw_HOST_UNIQUE_NAME' (gvsqw_DB_UNIQUE_NAME, on supprime le numéro du node !)

+ tout autre cas qui pourrait arrivé ou qui "vous arrange" !

Explication des statuts

Une instance "ouverte" sera traitée en mode "local", c’est-à-dire que l’on va se connecter en "/ as sysdba" en local sur la machine qui porte l’instance (accès ssh depuis dbsqware@sqwarebox), statut "ON".
Une instance "fermée", type dataguard sera traitée en mode "local", c’est-à-dire que l’on va se connecter en "/ as sysdba" en local sur la machine qui porte l’instance (accès ssh depuis dbsqware@sqwarebox), statut "DG".
Une instance où l’on n’aurait pas d'accès unix local serait gérée en mode "distant" (style Windows, RDS, ...), statut "DIST".
Le statut "OFF" fait "disparaître" l’instance de la visu web.
Le statut "NEW" est utilisé comme statut intermédiaire entre le début et la fin du paramétrage d'une nouvelle instance.
Tous les autres statuts permettent d’afficher l’instance dans le référentiel (notamment "KEEP") mais ne seront pas pris en compte par les traitements automatiques.

Résumé des statuts :

• ON  : gestion locale sous unix (le plus courant)
• DIST : gestion uniquement à distance
• KEEP : statut temporaire, lors d'une maintenance par exemple ou avant suppression complète
• NEW  : statut temporaire, lors du paramétrage
• OFF  : suppression visuelle de l'instance (sans suppression de son paramétrage)
• XXX  : non pris en charge ...

Statut	Description
ON	gestion locale sous unix (le plus courant)
DIST	gestion uniquement à distance
KEEP	statut temporaire, lors d'une maintenance par exemple ou avant suppression complète
NEW	statut temporaire, lors du paramétrage
OFF	suppression visuelle de l'instance (sans suppression de son paramétrage)
XXX	non pris en charge ...

Déclaration de l'instance dans SQWareRepository avec SQWareWeb

Nous allons déclarer la nouvelle instance depuis l'interface d'administration de SQWareWeb.

Déclarez la nouvelle instance en statut "NEW" (Ajout ou Duplicate)

Explication des champs :

• Db Alias  : Clé unique qui identifie l'instance dans dbSQWare (sera utilisée comme SERVICE_NAME pour la génération du tnsname.ora, pour sa partie avant le ":" si présent)
• Dbms Name  : type de SGBD
• Virtual Host  : host virtuel (meme que Host si pas cluster, sera utilisé pour la génération du tnsname.ora)
• Host Name  : hostname de l'instance
• User Name  : user qui porte l'instance
• Port  : port d'écoute de l'instance (sera utilisé pour la génération du tnsname.ora)
• Comments  : une courte description de ce que porte l'instance
• Status  : instance statut (cf plus haut pour les explications)
• Contact  : un contact si besoin
• Environnement : Environnement de l'instance (PRD, PPR, REC, DEV, TST, ...)
• Client  : Utilisé uniquement pour filtrer (mettre un nom de client et/ou de département et/ou service ...
• GlobalHost  : Champ libre dans lequel on met souvent l'hôte de hyperviseur par exemple
• Custom1  : Champ libre 1
• Custom2  : Champ libre 2