- SDBM Version 0.01 (2011/07/05)
Tables des matières Simple Database Monitoring - SDBM.1.1 Tables des matières2 Architecture3 Installation..4 Installation sur Linux (image virtuelle pré-configuré)..4 Changement du nom du serveur (étape optionnelle)4 Utilisation du adresse IP fixe (étape optionnelle)..5 Installation sur Windows..6 Configuration initiale7 Paramètres généraux7 Destinations de notification.7 Modification des événements de base7 Installation des agents SDBM (optionnel).8 Installation de l'agent SDBM sur Linux / Unix.9 Installation du java jre 5 (Linux / Unix).9 Installation du jre à partir de l'archive fournie (Linux / Solaris)9 Installation de l'agent SDBM sur Unix.10 Installation de l'agent SDBM sur Windows.12 Configuration avancée.13 Fichier de configuration.14 Opérations15 Ajout d'un évenement..15 Ajout d'une cible.15 Base de données régulière..15 Base de données Oracle RAC15 Base de données Oracle DataGuard..15 Instance Oracle ASM.15 Page 2
Architecture Serveur SDBM Linux / Windows Oracle Express Database 10.2 (port d'écoute 1521) Oracle Apex 4.0 (port d'écoute 8080) Apache 2.2 (port d'écoute 443) Service Java SDBMSrv Service Java SDBMAgt (agent local) Agent SDBM (Windows, Linux ou Unix) Service Java SDBMAgt Browser HTTPS Serveur BD Serveur SDBM Apache (httpd) SDBMAgt (java) errorlog MS SQL HTTP SQL*Net alert.ora Oracle SDBMAgt (java) SQL*Net SDBMSrv (java) SQL*Net Oracle XE - APEX (lsnr 8080) - SDBM (lsnr 1521) Page 3
Installation Deux types d'installation sont disponible pour SDBM. L'installation sur Linux est une image virtuelle pré-configuré pleinement fonctionnelle. Le dévelopement étant fait sur Linux, c'est l'installation à privillégier. La deuxième option est le script d'installation Windows. Installation sur Linux (image virtuelle pré-configuré) En fonction de la solution de virtualisation, la procédure de déploment sera différente. Deux images virtuelles sont disponibles : Image utilisant le standard OVF Une image de type VMDK (disque VMware). Le nom du serveur Linux pré-configuré est sdbm et il utilise DHCP pour obtenir une adresse IP initiale. Changement du nom du serveur (étape optionnelle) Voici les étape pour changer le nom d'un serveur Linux SDBM : Modification du fichier listener.ora et tnsnames.ora Changement de HOST = sdbm pour HOST = nouveau_nom dans : /usr/lib/oracle/xe/app/oracle/product/10.2.0/server/network/admin/listener.ora /usr/lib/oracle/xe/app/oracle/product/10.2.0/server/network/admin/tnsnames.ora Modification du fichier /etc/sysconfig/network Changement du HOSTNAME=sdbm par HOSTNAME=nouveau_nom Changement de nom du système # hostname nouveau_nom Page 4
Utilisation du adresse IP fixe (étape optionnelle) Voici les étape pour changer l'adresse IP d'un serveur Linux SDBM : Modification du fichier /etc/hosts L'entrée sdbm sur la première ligne du fichier doit être retirée. Une ligne doit être ajoutée au fichier contenant l'adresse du serveur et l'alias sdbm. ex : # Do not remove the following line, or various programs # that require network functionality will fail. 127.0.0.1 localhost.localdomain localhost ::1 localhost6.localdomain6 localhost6 10.10.10.1 nom_serveur.nom_domaine nom_serveur sdbm Modification du fichier /etc/sysconfig/network-scripts/ifcfg-eth0 L'entrée BOOTPROTO=dhcp doit être retirée. Les information statiques requise doivent être ajoutées. ex : DEVICE=eth0 ONBOOT=yes # DHCP configuration #BOOTPROTO=dhcp # FIXED configuration BOOTPROTO=none IPADDR=10.10.10.1 NETWORK=10.10.10.0 GATEWAY=10.10.10.254 NETMASK=255.255.255.0 Modification du fichier /etc/resolv.conf Le domaine de recherche ainsi que les adresses du DNS doivent être ajoutés. ex : search nom_domaine nameserver 10.10.10.253 Redémarrage du réseau Pour rendre les changements effectif, un redémarrage du réseau est requis : # service network restart (ou reboot) Page 5
Installation sur Windows Contrairement à l'image pré-configuré Linux, l'installation Windows requiert un système d'exploitation Windows pleinement fonctionnel. De plus, pour utiliser le script d'installation, les conditions suivantes doivent être respectées : Vous devez avoir les privilèges «Administrateurs» dans Windows Vous devez avoir au moins 5GB d'espace disque libre (sur un même disque) Oracle Database Express Edition ne doit pas être installé sur le système Le script d'installation effectura les tâches suivantes : Installation de Oracle Database Express Edition 10.2.0 (XE) Installation du service Windows SDBMSrv (SDBM Server) Installation du service Windows SDBMAgt (SDBM Agent) En option, vous pourez choisir de : Procéder à la création d'un usager d'exécution pour l'agent SDBM (au lieu d'utiliser l'usager par défaut Windows «LOCAL\SYSTEM») Effectuer la création de tâches de prise de copie votre base de données SDBM Si vous choissisez de ne pas exécuté ces étapes optionnelle au moment de l'installation, il vous sera possible d'exécuter ces scripts de façon unitaire ultérieurement. Exécution du script d'installation SDBM Si vous souhaitez utilisé le protocole https pour accèder à la console de gestion SDBM, vous pourrez pouvez procéder à l'installation d'un proxy Apache à l'aide de InstallSSLOption.cmd. Page 6
Configuration initiale Paramètres généraux Destinations de notification Modification des événements de base Page 7
Installation des agents SDBM (optionnel) L'agent SDBM doit s'exécuter sur chaque serveurs de bases de données. Il est requis pour effectuer les actions suivantes : Vérification des journaux d'exécution des SGBD (ex. alert.ora, ERRORLOG). Collecte des statistiques du systèmes d'exploitation Déclanchement des tâches SDBM Page 8
Installation de l'agent SDBM sur Linux / Unix Installation du java jre 5 (Linux / Unix) Source : agent-sdbm.release.n.nn.zip/unix ou source propre à votre système d'exploitation Pour fonctionner, l'agent SDBM à besoin du jre java version 5. Si un jre java 5 est déjà disponible sur votre serveur vous pourrez l'utiliser (dans ce cas, vous pouvez passer à la section «Installation de l'agent SDBM sur Unix» immédiatement). Si votre serveur est un serveur Linux ou Solaris, vous pouvez utilisé le contenu du réperoire./unix/java de l'archive source pour procéder à l'installation de java. Dans le cas contraire, référer vous à la documentation de votre système d'exploitation pour la mise en place du java jre 5. Installation du jre à partir de l'archive fournie (Linux / Solaris) Un répertoire racine SDBM sera requis pour y déposer les composants exécutable de l'agent. Les exemples suivant utiliserons /opt/sdbm (mais ce répertoire pourrait être n'importe quoi). L'installation qui suit utilise le mode usager (sans devoir utiliser l'usager root). Vous devez déposer une copie de l'outil d'installation java sur votre serveur à partir de./unix/java/jre- 1_5_0_22-{os}-{architecture}.{sh bin} dans le répertoire /opt/sdbm/java, faire un chmod 755 /opt/sdbm/java/jre-1_5_0_22-{os}-{architecture}.{sh bin} et exéuter l'outil d'installation java (/opt/sdbm/java/jre-1_5_0_22-{os}-{architecture}.{sh bin}). Vous pouvez détruire l'utilitaire d'installation (rm /opt/sdbm/java/jre-1_5_0_22-{os}-{architecture}.{sh bin}). Page 9
Installation de l'agent SDBM sur Unix Source : agent-sdbm.release.n.nn.zip/unix Une fois le java jre 5 disponible sur votre serveur, vous pouvez procéder à l'installation de l'agent. Un répertoire racine SDBM sera requis pour y déposer les composants exécutable de l'agent. Les exemples suivant utiliserons /opt/sdbm (mais ce répertoire pourrait être n'importe quoi). À partir de la source, vous devez déposer les répertoires jdbc et sdbmagt dans le réperoire racine SDBM. Votre répertoire racine SDBM devrait maintenant ressembler à ceci : /opt/sdbm/java (optionnel) /opt/sdbm/jdbc /opt/sdbm/sdbmagt L'usager qui exécutera l'agent SDBM doit avoir les permission d'accès «rwxr-x---» au répertoire racine SDBM (de façon récursive). Exemple : chmod -R 750 /opt/sdbm usager:groupe_primaire_usager De plus, l'usager qui exécutera l'agent SDBM doit avoir les privilèges de lecture sur les fichiers de journalisation qui seront surveillée (ex. alert[instance].log). En fonction de votre environnement, le fichier suivant doit être ajusté : /opt/sdbm/sdbmagt/sdbmagtctl : Exemple (/opt/sdbm) : # Root directory Java - SDBM export JAVA_DIR=/opt/sdbm/java/jre1.5.0_22; export SDBM_DIR=/opt/sdbm; Page 10
Démarrage de l'agent sur démarrage du serveur (optionnel) Idéalement, l'agent devrait être lancé par les scripts de démarrage du serveur. Si vous exécuté l'agent sur une des distributions Linux qui offre l'utilitaire «chkconfig» : Déplacer le fichier sdbmagt (en provenance de /opt/sdbm/sdbmagt/) Faire l'ajustement requis en fonction du répertoire racine SDBM (Exemple : SDBM_DIR=/opt/sdbm;) Faire l'ajustement requis en fonction du l'usager d'exécution (si différent de oracle) (Exemple : su - oracle su - nom_usager) Exécuter la commande de création du service Linux (avec root) # chkconfig --add sdbmagt Si vous exécuté l'agent sur un autre saveur de Unix, vous devrez adapter le script rc.sdbmagt (en provenance de /opt/sdbm/sdbmagt/) et l'ajouter aux procédure de démarrage de votre système. Page 11
Installation de l'agent SDBM sur Windows Source : agent-sdbm.release.n.nn.zip/windows Un répertoire racine SDBM sera requis pour y déposer les composants exécutable de l'agent. Les exemples suivant utiliserons c:\sdbm (mais ce répertoire pourrait être n'importe quoi). À partir de la source, vous devez déposer les répertoires java, jdbc et sdbmagt dans le réperoire racine SDBM. Votre répertoire racine SDBM devrait maintenant ressembler à ceci : c:\sdbm\java c:\sdbm\jdbc c:\sdbm\sdbmagt Par défaut, l'usager «LOCAL\SYSTEM» sera utilisé pour l'exécution de l'agent. Si vous ne souhaitez pas exécuté de tâches via SDBM, c'est la façon la plus simple (voir la section «Fichier de configuration» pour la désactivation du système de tâche SDBM). Dans le cas contraire, l'usager qui exécutera l'agent SDBM doit avoir les permission d'accès en écriture au répertoire racine SDBM (de façon récursive). De plus, l'usager qui exécutera l'agent SDBM doit avoir les privilèges de lecture sur les fichiers de journalisation qui seront surveillée (ex. alert[instance].log ou ERRORLOG). Installation du service Windows SDBMAgt La mise en place du service Windows est effectué à l'aide du fichier de commande InstallSDBMAgt.cmd. Il suffit de : Ouvrir un invite de commande Se positionner sur le repertoire de l'agent SDBM (Exemple : c: && cd \sdbm) Exécuter le fichier de commande d'installation c:\sdbm\sdbmagt> InstallSDBMAgt.cmd Si vous avez choisi d'exécuté l'agent SDBM avec un compte différent du l'usager de service par défaut Windows, vous pouvez maitenant (après avoir créer votre usager), faire les modifications requise via le panneau des services de Windows. Page 12
Configuration avancée Toute les configuration possible ne sont pas énoncées dans ce guide. Vous êtes invités à contacter le support SDBM (support@sdbm.ca) pour toutes questions pouvant subsisté après la lecture de ce guide. Page 13
Fichier de configuration Le fichier de configuration de l'agent SDBM est SDBMAgt.properties. Il contient les paramètres suivants : # Database section SDBMConnection = Chaine jdbc de connexion au référentiel SDBM SDBMUserName = Usager de connexion au référentiel SDBM SDBMPassword = Mot de passe de l'usager de connexion au référentiel SDBM # Log level (NORMAL DEBUG) SDBMLogLevel = Niveau de journalisation (NORMAL DEBUG) # Override of the hostname SDBMHostName = Surcharge du nom du serveur (optionnel) # Task scheduler (AC IN) SDBMTaskScheduler = Fanion d'activation du système de tâche # System statistics (AC IN) SDBMSysStatistics = Fanion d'activation de la collecte des statistiques OS # CPU statistics (AC IN) SDBMCPUStatistics = Fanion d'activation de la collecte des statistiques des CPUs (le sommaire pour tous les CPUs n'est pas affectée par cette option) Minimalement, les paramètres suivants doivent être modifiés : Nom DNS ou adresse IP du serveur SDBM référentiel Exemple : # Database section SDBMConnection = nom_dns_ou_adresse_ip_du_serveur_sdbm:1521:xe SDBMUserName = SDBMAGT SDBMPassword = testagt Page 14
Opérations Ajout d'un évenement Ajout d'une cible Base de données régulière Base de données Oracle RAC Base de données Oracle DataGuard Instance Oracle ASM Page 15