- DBMonipro
Werbung
check_oracle Documentaton © 2011, alle Rechte vorbehalten. DBMonipro ist ein Produkt von DBConcepts Daten- und Informationsverarbeitungsges.m.b.H. Agenda AGENDA...................................................................................................................................... 2 DOCUMENTATION ..................................................................................................................... 3 1 ÄNDERUNGSVERZEICHNIS ................................................................................................ 3 2 ÜBERSICHT .......................................................................................................................... 4 3 VORRAUSSETZUNGEN ....................................................................................................... 4 4 INSTALLATION ..................................................................................................................... 4 5 USAGE .................................................................................................................................. 5 5.1 5.2 5.3 connectdata (required) .................................................................................................................................... 5 accessdata (required) ...................................................................................................................................... 5 option (required) .............................................................................................................................................. 6 © 2011, alle Rechte vorbehalten. DBMonipro ist ein Produkt von DBConcepts Daten- und Informationsverarbeitungsges.m.b.H. Seite 2 von 7 Documentation Betreff check_oracle Version v4 Name Letztes Update Status check_oracledocu_online.doc 20.06.2011 Done Datei Verfasser D.H. Dokumentation 2.0 1 Änderungsverzeichnis Version Erstellt Autor Änderungen 1.0 11.01.2011 DH Erstellung 2.0 29.06.2011 MH Veröffentlichung © 2011, alle Rechte vorbehalten. DBMonipro ist ein Produkt von DBConcepts Daten- und Informationsverarbeitungsges.m.b.H. Seite 3 von 7 2 Übersicht Dieses Dokument erläutert die Installation und Usage des check_oracle Tools, welches gemeinsam mit Nagios und den check_scripts das Monitoring von Oracle Datenbanken ermöglicht. Das check_oracle Tool und die check_scripts werden als Produkt „DBMonipro Basis Edition“ zusammengefasst. Weitere Informationen zu Features, Add-On und Lizenzumfang finden Sie auf http://www.dbmonipro.at 3 Vorraussetzungen Um das check_oracle Tool verwenden zu können, sind folgende Voraussetzungen notwendig: Nagios 3.x libclntsh.so ab version 11.1 (libclntsh.so.11.1) Diese wird bei allen gängigen 11g Installationen mitgeliefert. Für den Betrieb des check_oracle Tools ist mindestens ein Oracle Instant Client 11g (Basic) notwendig. Den dafür notwendigen Download Link ist unter 4.2 angeführt. 4 Die Umgebungsvariable LD_LIBRARY_PATH sollte gesetzt werden. Installation 1. Wählen Sie entsprechend Ihrer Plattform die passende check_oracle Version aus. Aktuell werden folgende Betriebsysteme unterstützt: 1. RedHat Enterprise Linux (RHEL) 5.x (Intel/AMD x86 32 sowie 64 Bit) 2. RedHat Enterprise Linux (RHEL) 6.x (Intel/AMD x86 32 sowie 64 Bit) 3. Suse Enterprise Linux (SELS) 10.x (Intel/AMD x86 32 sowie 64 Bit) 4. Suse Enterprise Linux (SELS) 11.x (Intel/AMD x86 32 sowie 64 Bit) 2. Oracle Instant Client 11.x Basic herunterladen und installieren. a. Die Pakete für Ihr System finden Sie unter folgenden Link: http://www.oracle.com/technetwork/database/features/instant-client/index-097480.html b. Installation des Pakets [root@machine]# rpm -ivh oracle-instantclient11.2-basic-11.2.0.2.0.i386.rpm Preparing... ########################################### [100%] 1:oracle-instantclient11.########################################### [100%] © 2011, alle Rechte vorbehalten. DBMonipro ist ein Produkt von DBConcepts Daten- und Informationsverarbeitungsges.m.b.H. Seite 4 von 7 3. Erster Verbindungstest a. Exportieren des LD_LIBRARY_PATH=<oracle_instantclient_home>/lib b. Führen Sie check_oracle mit der logon option aus c. ./check_oracle –H <hostname> -P <port> -T <db service name> -u <username> -p <password> -r <role> -o logon –w <warning threshold> -c <critical threshold> Beispiel: $ export LD_LIBRARY_PATH=/usr/lib/oracle/11.2/client64/lib $ ./check_oracle -H localhost -P 1521 -T XE -u sys -p <password> -r sysdba -o logon -w 10 -c 20 5 LOGON successful, rta=0.02s ( OK ) | SHORTSERVICEOUTPUT LOGON successful, rta=0.02s ( OK ) | LONGSERVICEOUTPUT rta=0.02s Performancedata./check_oracle Usage check_oracle [connectdata] [accessdata] [option] [outputmanipulation (optional)] 5.1 connectdata (required) -t tnsnames.ora Eintrag -H Hostname -P Port -T Database Servicename Use -t for tnsnames.ora entry or -H -P -T 5.2 accessdata (required) -u Username/Schema -p Passwort -r Rolle (optional sysdba,sysasm,sysoper) Um das Passwort aus Sicherheitsgründen nicht im Programaufruf mitzuliefern, kann durch --pwdfile ein Passwortfile genutzt werden. Dafür muss ein File mit dem Namen „auth.pwd“ im selben Ordner erstellt werden. Dieses File ist wie folgt aufgebaut: tnsentry:username:passwort:role © 2011, alle Rechte vorbehalten. DBMonipro ist ein Produkt von DBConcepts Daten- und Informationsverarbeitungsges.m.b.H. Seite 5 von 7 Beispiel: XE.world:sys:oracle:sysdba XE2.world:sys:oracle:sysdba Voraussetzung für die --pwdfile Option ist die –t option. Diese muss genutzt werden, damit die TNS Einträge gemappt werden können. 5.3 option (required) -o logon: returns logontime to database -w warning thresold -c critical thresold -o metric: statement is executed -w warning thresold -c critical thresold -C comparator l,le,eq,ne,ge,g [l=less,le=less equal,eq=equal,ne=not equal, ge=greater equal,g=greater] -m -m <metricname> Name of provided SQL (without .sql) -v statement type: single,two,multi single one column and row will be returned by statement to applicate two two columns and n rows will be returned by statement: column 1 is key value, column 2 is value multi n columns and rows will be returned by statement: column 1 is key value -col must be spezifed for columns sould be checked (multiple, comma separated, thresolds and comparators can be spezified) -o standby: standby drift (for physical standby) will be checked, please provied all instances with -t option comma separated -w warning thresold -c critical thresold outputmanipulation (optional): --string if strings should be checked * -C is not required, by default is eq checked * if -C is set, then eq and ne is allowed only --minver statement only executed if database version >= specified --maxver statement only executed if database version =< specified © 2011, alle Rechte vorbehalten. DBMonipro ist ein Produkt von DBConcepts Daten- und Informationsverarbeitungsges.m.b.H. Seite 6 von 7 --standby --html if database is a physical standby, then statment is ignored SERVICELONGOUTPUT in HTML --noperfdata --errisok no perfdata is applicated if error occurs, then manipulate to OK --erriswarning if error occurs, then manipulate to WARNING --erriscritical if error occurs, then manipulate to CRITICAL --errisunkown if error occurs, then manipulate to UNKOWN DBConcepts Daten- und Informationsverarbeitungsges.m.b.H. Simmeringerhauptstraße 24, 1110 Wien, Austria Tel. +43 1 890 89 99-0 Firmenbuchummer FN 200402, Handelgericht Wien Fax +43 1 890 89 99-1810 UID: ATU50593806 www.dbconcepts.at Erste Bank, Konto-Nr.: 28317522400, BLZ: 20111 www.dbmonipro.at BIC: GIBAATWW, IBAN: AT92 2011 1283 1752 2400 © 2011, alle Rechte vorbehalten. DBMonipro ist ein Produkt von DBConcepts Daten- und Informationsverarbeitungsges.m.b.H. Seite 7 von 7
