Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- computer:icinga:icinga_mit_oracle_10g_xe [2011/03/09 19:14] – [Kompilierung] christian
+++ computer:icinga:icinga_mit_oracle_10g_xe [2012/06/17 22:51] (aktuell) – gelöscht christian
@@ Zeile 1: / Zeile 1: @@
-Icinga kann dank einer Erweiterung namens **IDOutils** auf vielen verschiedenen Datenbanksystemen betrieben werden. Neben MySQL und PostgreSQL kann es auch auf Oracle verwendet werden - besonders interessant ist dies für Firmen, die aus supportechnischen Gründen auf Oracle setzen.
-======Szenario======
-Dieses Tutorial widmet sich der Installation eines Oracle 10g Database Express- und Icinga-Monitoringsystems. Als Betriebssystem wird CentOS 5.5 verwendet, welches binärkompatibel zu RedHat Enterprise Linux ist. Folglich dürfte dieser Leitfaden auch beim Nachbau auf Produktivsystemen mit RHEL und Oracle Database Standard unterstützen.
-=====Voraussetzungen=====
-Für dieses Szenario wird benötigt:
-  * Ein- oder Mehrkern-Coprozessor
-  * Host oder virtuelle Maschine mit 2 GB Arbeitsspeicher
-  * Mindestens 1 GB Swap
-  * Mindestens 20 GB Speicherplatz
-  * CentOS 5.5-Abbild oder -Medium
-  * Oracle Database 10g Database Express Edition Installationspakete
-  * Oracle InstantClient und Linux SDK
-======Datenbank======
-Zuerst wird die Oracle 10g Database Express Edition Software installiert - diese Version ist gegenüber der Standard-Version von Oracle Database abgespeckt und für Evaluationen, wie diese, gedacht. Sie kann kostenfrei auf der [[http://www.oracle.com/technetwork/database/express-edition/overview/index.html|Oracle-Webseite]] bezogen werden.
-Ich setze vorraus, dass CentOS 5.5 bereits installiert wurde. Benötigt wird das Paket **oracle-xe-univ-10.2*.i386.rpm** von der Oracle-Webseite.
-<note tip>10.2* ist durch die aktuelle Version zu ersetzen.</note>
-Nachdem das Paket heruntergeladen wurde, kann es mittels **yum** installiert werden - danach wird die Datenbank konfiguriert:
-<code># yum localinstall --nogpgcheck oracle-xe-univ-10.2*.i386.rpm
-...
-Is this ok [y/N]: y
-...
-Complete!
-# /etc/init.d/oracle-xe configure
-Oracle Database 10g Express Edition Configuration
--------------------------------------------------
-This will configure on-boot properties of Oracle Database 10g Express
-Edition.  The following questions will determine whether the database should
-be starting upon system boot, the ports it will use, and the passwords that
-will be used for database accounts.  Press <Enter> to accept the defaults.
-Ctrl-C will abort.
-Specify the HTTP port that will be used for Oracle Application Express [8080]:
-Specify a port that will be used for the database listener [1521]:
-Specify a password to be used for database accounts.  Note that the same
-password will be used for SYS and SYSTEM.  Oracle recommends the use of
-different passwords for each database account.  This can be done after
-initial configuration:
-Confirm the password:
-Do you want Oracle Database 10g Express Edition to be started on boot (y/n) [y]:
-Starting Oracle Net Listener...Done
-Configuring Database...Done
-Starting Oracle Database 10g Express Edition Instance...Done
-Installation Completed Successfully.
-To access the Database Home Page go to "http://127.0.0.1:8080/apex"
-</code>
-<note>Sollen externe Zugriffe auf die Weboberfläche der Datenbank erfolgen, muss dies in der Datenbank konfiguriert werden. Hierzu wird zuerst ein Oracle-Profil geladen und dannach eine Verbindung zur Datenbank mittels SQLPLUS hergestellt, bevor ein Befehl abgesetzt wird, der den externen Zugriff erlaubt:
-<code>
-# source /usr/lib/oracle/xe/app/oracle/product/10.2.0/server/bin/oracle_env.sh
-# sqlplus
-SQL*Plus: Release 10.2.0.1.0 - Production on Mi Dez 29 15:12:48 2010
-Copyright (c) 1982, 2005, Oracle.  All rights reserved.
-Benutzernamen eingeben: system
-Kennwort eingeben:
-Verbunden mit:
-Oracle Database 10g Express Edition Release 10.2.0.1.0 - Production
-SQL> EXEC DBMS_XDB.SETLISTENERLOCALACCESS(FALSE);
-PL/SQL-Prozedur erfolgreich abgeschlossen.
-SQL> exit
-Verbindung zu Oracle Database 10g Express Edition Release 10.2.0.1.0 - Production beendet
-</code>
-Die Firewall, falls verwendet, muss angepasst werden, damit Zugriff auf TCP-Port 8080 möglich ist:
-<code>
-# iptables -A INPUT -p tcp -m tcp --dport 8080 -j ACCEPT
-# service iptables save
-# service iptables restart
-</code>
-Nach einem Neustart des Dienstes steht der externe Zugriff zur Verfügung:
-<code>/etc/init.d/oracle-xe restart
-</code></note>
-======Icinga======
-=====Vorbereitungen=====
-Bevor Icinga kompiliert wird, bedarf es noch einiger Vorbereitungen:
-====Pakete und Abhängigkeiten====
-Es müssen noch einige Bibliotheken installiert werden, die bei der Kompilierung benötigt werden:
-<code>
-# yum install gcc gcc-c++ httpd gd gd-devel glibc glibc-common libjpeg libjpeg-devel libpng libpng-devel openldap-devel php net-snmp net-snmp-devel net-snmp-utils openssl openssl-devel
-</code>
-<note tip>Die Pakete **net-snmp-devel** und **net-snmp-utils** werden benötigt, falls Icinga NMNP-Dienste verwenden können soll. Icinga kann Informationen verschlüsselt übertragen - hierfür werden die Pakete **openssl** und **openssl-devel** benötigt.</note>
-====SELinux====
-SELinux behindert Icinga in seiner Funktionsweise, es kann bei der Benutzung der Weboberfläche zu "Internal Server Error"-Meldungen kommen, wenn SELinux aktivert ist. Je nach Firmenvorschriften empfiehlt sich eine Anpassung oder Deaktivierung von SELinux. Es gibt die Möglichkeit für die von Icinga verwendeten CGI-Skripts Ausnahmen zu definieren (//siehe "Kompilierung"//) - alternativ kann über das CentOS-/RedHat Setup-Werkzeug SELinux deaktiviert werden. Auch eine Anpassung über die Kommandozeile ist einfach möglich:
-<code>
-# setenforce 0
-# nano /etc/selinux/config
-...
-SELINUX=disabled
-</code>
-<note>**setenforce 0** sorgt lediglich dafür, dass SELinux zur Laufzeit deaktiviert wird - nach einem Reboot wird es wieder aktiviert. Soll SELinux dauerhaft deaktiviert werden, muss die Konfigurationsdatei **/etc/selinux/config** angepasst werden. (//siehe Code-Schnippsel//)</note>
-====Oracle-Bibliothek====
-Damit Icinga auf der Oracle-Datenbank agieren kann, wird eine Bibliothek namens **ocilib** benötigt. Der Quellcode dieser Bibliothek kann kostenfrei auf der [[http://orclib.sourceforge.net/|Orclib-Projektseite]] bezogen werden.
-===Instant-Client und SDK===
-Damit die benötigte Oracle-Bibliothek kompiliert werden kann, werden der Oracle Instant Client und das Linux SDK benötigt. Beides erhält man ebenfalls kostenfrei [[http://www.oracle.com/technetwork/database/features/instant-client/index-097480.html|in der passenden Rubrik auf der Oracle-Webseite]].
-<code>
-~# yum localinstall --nogpgcheck oracle-instantclient11*basic*.rpm
-~# yum localinstall --nogpgcheck oracle-instantclient11.2-devel*.rpm
-~# yum localinstall --nogpgcheck oracle-instantclient11.2-sqlplus*.rpm
-~# yum localinstall --nogpgcheck oracle-instantclient11.2-tools*.rpm
-~# unzip instantclient-sdk-linux32*.zip
-</code>
-<note tip>Je nach verwendeten Architektur muss der Dateiname des SDK-Archivs ggf. angepasst werden</note>
-===Kompilierung===
-Wenn der Oracle Instantclient installiert und das SDK entpackt wurden, kann das muntere Kompilieren beginnen:
-<code>
-~# tar xvfz ocilib-3.8.1-gnu.tar.gz
-~# cd ocilib-3.8.1
-~# export LD_LIBRARY_PATH="/usr/lib/oracle/xe/app/oracle/product/10.2.0/server/lib:/usr/lib/oracle/11.2/client/lib:/usr/local/lib"
-~# source /usr/lib/oracle/xe/app/oracle/product/10.2.0/server/bin/oracle_env.sh
-ocilib-3.8.1# ./configure --with-oracle-headers-path=/root/instantclient_11_2/sdk/include --with-oracle-lib-path=/usr/lib/oracle/11.2/client/lib
-ocilib-3.8.1# make
-ocilib-3.8.1# make install
-</code>
-<note important>Nur, wenn die Kompilierung und Installation der Bibliothek ohne Fehler durchlaufen wurde, können die nachfolgenden Schritte ausgeführt werden!</note>
-Im Archiv befindet sich auch ein Beispielprogramm, welches die Verbindung zu einer Oracle-Instanz testet. Wenn dieses funktioniert, kann fortgefahren werden:
-<code>
-ocilib-3.8.1# cd demo
-demo# make -f Makefile_demo demo
-gcc -I/usr/local/include -DOCI_IMPORT_LINKAGE -DOCI_CHARSET_ANSI -c -o ocilib_demo.o ocilib_demo.c
-gcc -L/usr/lib/oracle/11.2/client/lib -lclntsh  -L/usr/local/lib -locilib -o demo ocilib_demo.o
-demo# ./demo xe system <Passwort>
-...
-errors
-warnings
-press any key to exit...
-</code>
-=====Kompilierung=====
-Zunächst werden eine Benutzerkonto und eine zugehörige Gruppe für den Icinga-Daemon erstellt - für die Bedienung des Dienstes über die Weboberfläche wird eine dedizierte Gruppe erstellt - dieser Gruppe wird das Apache-Benutzerkonto hinzugefügt.
-<code>
-# useradd -m icinga
-# passwd icinga
-...
-# groupadd icinga
-# groupadd icinga-cmd
-# usermod -a -G icinga-cmd icinga
-# usermod -a -G icinga-cmd apache
-</code>
-<code>
-# ln -s /usr/lib/oracle/11.2/client/lib/libclntsh.so.11.1 /usr/lib/libclntsh.so.11.1
-# ldd /usr/local/lib/libocilib.so.3.8.1
-linux-gate.so.1 =>  (0x00e17000)
-        libclntsh.so.11.1 => /usr/lib/libclntsh.so.11.1 (0x00f3d000)
-        libc.so.6 => /lib/libc.so.6 (0x00110000)
-        libnnz11.so => not found
-        libdl.so.2 => /lib/libdl.so.2 (0x00269000)
-        libm.so.6 => /lib/libm.so.6 (0x00d88000)
-        libpthread.so.0 => /lib/libpthread.so.0 (0x00a24000)
-        libnsl.so.1 => /lib/libnsl.so.1 (0x006e6000)
-        libaio.so.1 => /usr/lib/libaio.so.1 (0x0026e000)
-        /lib/ld-linux.so.2 (0x00801000)
-        TODO: LINK ENTFERNEN
-# export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/lib/oracle/11.2/client/lib
-#export LD_LIBRARY_PATH="/usr/lib/oracle/xe/app/oracle/product/10.2.0/server/lib:/usr/lib/oracle/xe/app/oracle/product/10.2.0/server/lib:/usr/lib/oracle/11.2/client/lib:/usr/local/lib"
-cd demo
-make -f Makefile_demo demo
-gcc -L/usr/lib/oracle/11.2/client/lib -lclntsh  -L/usr/local/lib -locilib -o demo ocilib_demo.o
-./demo
-*** Configuration summary for icinga-core 1.3.0 02-16-2011 ***:
- General Options:
- -------------------------
-        Icinga executable:  icinga
-        Icinga user/group:  icinga,icinga
-       Command user/group:  icinga,icinga-cmd
-            Embedded Perl:  no
-             Event Broker:  yes
-           Build IDOUtils:  yes
-        Install ${prefix}:  /usr/local/icinga
-                Lock file:  ${prefix}/var/icinga.lock
-   Check result directory:  ${prefix}/var/spool/checkresults
-           Init directory:  /etc/rc.d/init.d
-  Apache conf.d directory:  /etc/httpd/conf.d
-             Mail program:  /bin/mail
-                  Host OS:  linux-gnu
- Web Interface Options:
- ------------------------
-                 HTML URL:  http://localhost/icinga/
-                  CGI URL:  http://localhost/icinga/cgi-bin/
- Traceroute (used by WAP):  /bin/traceroute
-Review the options above for accuracy.  If they look okay,
-type 'make all' to compile the main program and CGIs.
-!!! Please take care about the upgrade documentation !!!
-</code>
-GIT
-<code>
-# cd /usr/src
-# w3m http://sourceforge.net/projects/icinga/files/icinga/1.3.0/icinga-1.3.0.tar.gz/download
-# tar xvfz icinga-1.3.0.tar.gz
-...
-# cd icinga-1.3.0
-# ./configure --with-command-group=icinga-cmd --enable-idoutils --enable-ssl --enable-oracle --with-ocilib-inc=/root/ocilib-3.8.1/include
-==> INSERT
-</code>
-<code>
-icinga-1.3.0 # make
-...
-icinga-1.3.0 # make fullinstall
-...
-icinga-1.3.0 # make install-config
-...
-icinga-1.3.0 # cp module/idoutils/db/oracle/oracle.sql $ORACLE_HOME
-</code>
-=====Konfiguration=====
-<code>
-icinga-1.3.0 # cd /usr/local/icinga/etc
-etc # nano objects/contacts.cfg
-==> MAIL
-etc # mv idomod.cfg-sample idomod.cfg
-etc # mv ido2db.cfg-sample ido2db.cfg
-etc # nano idomod.cfg
-...
-use_ssl=1
-output_type=tcpsocket
-output=127.0.0.1
-...
-etc # nano ido2db.cfg
-...
-use_ssl=1
-socket_type=tcp
-...
-db_servertype=oracle
-db_port=1521
-db_user=icinga
-db_pass=test123
-...
-etc # nano /usr/local/icinga/etc/icinga.cfg
-...
-broker_module=/usr/local/icinga/bin/idomod.o config_file=/usr/local/icinga/etc/idomod.cfg
-...
-etc # su - oracle
-su - oracle
--bash-3.2$ cd $ORACLE_HOME
--bash-3.2$ source /usr/lib/oracle/xe/app/oracle/product/10.2.0/server/bin/oracle_env.sh
--bash-3.2$ sqlplus Benutzer/Passwort
-SQL> @oracle.sql
-...
-SQL> quit
--bash-3.2$ exit
-etc # cd /usr/src/icinga-1.3.0
-icinga-1.3.0 # make cgis
-icinga-1.3.0 # make install-cgis
-icinga-1.3.0 # make install-html
-icinga-1.3.0 # make install-webconf
-icinga-1.3.0 # htpasswd -c /usr/local/icinga/etc/htpasswd.users icingaadmin
-New password:
-Re-type new password:
-Adding password for user icingaadmin
-icinga-1.3.0 # service httpd restart
-</code>
-<note>Falls der Zugriff von außen auf den Webserver noch nicht erlaubt wurde, kann die Anpassung der Firewall an dieser Stelle übernommen werden:
-<code>
-# iptables -A INPUT -p tcp -m tcp --dport 80 -j ACCEPT
-# service iptables save
-# service iptables restart
-</code></note>
-<code>
-# cd /usr/src
-src # links http://sourceforge.net/projects/nagiosplug/files/nagiosplug/1.4.15/nagios-plugins-1.4.15.tar.gz/download?use_mirror=netcologne
-src # tar xvfz nagios-plugins-1.4.15.tar.gz
-src # cd nagios-plugins-1.4.15
-nagios-plugins-1.4.15 # ./configure --prefix=/usr/local/icinga --with-cgiurl=/icinga/cgi-bin --with-htmurl=/icinga --with-nagios-user=icinga --with-nagios-group=icinga
-...
-nagios-plugins-1.4.15 # make
-...
-nagios-plugins-1.4.15 # make install
-...
-</code>
-<code>
-# ln -s /usr/lib/oracle/11.2/client/lib/libnnz11.so /usr/lib/libnnz11.so
-# service ido2db start
-ido2db PID  not running. Removing lockfile.
-Starting ido2db: done.
-# chkconfig --add ido2db
-# chkconfig ido2db on
-# /usr/local/icinga/bin/icinga -v /usr/local/icinga/etc/icinga.cfg
-...
-Things look okay - No serious problems were detected during the pre-flight check
-# service icinga start
-# chkconfig --add icinga
-# chkconfig icinga on
-</code>
-======Internetverweise======
-  * Icinga-Projektseite: http://www.icinga.org
-  * Icinga-Handbuch (//Version 1.3.0//): http://docs.icinga.org/1.3.0/Icinga_v13_de.pdf
-  * Oracle Database 10g Express Edition: http://www.oracle.com/technetwork/database/express-edition/overview/index.html
-  * orclib/ocilib-Webpräsenz: http://orclib.sourceforge.net/
-  * Oracle Instant Client und SDK: http://www.oracle.com/technetwork/database/features/instant-client/index-097480.html

Benutzer-Werkzeuge

Webseiten-Werkzeuge

Unterschiede

Seiten-Werkzeuge