


<h1><a name="installation" id="installation">Installation</a></h1>
<div class="level1">

<p>

Im Folgenden wird die Installation von PNP beschrieben.  Dabei wird davon ausgegangen, dass Nagios aus den Sourcen &uuml;bersetzt und im Verzeichnis /usr/local/nagios installiert wurde.<br/>

<strong>Achtung:</strong> Die Beschreibung bezieht sich auf die Developer-Version PNP 0.6.0.<br/>

Bitte vergessen Sie nicht, dass PNP nach der Installation noch konfiguriert werden muss. 
</p>

</div>
<!--  SECTION "Installation" [1-385] -->
<h2><a name="make_und_co" id="make_und_co">Make und Co</a></h2>
<div class="level2">

<p>

Die Installation von PNP wird wie bei Nagios auch &uuml;ber <a href="http://de.wikipedia.org/wiki/Makefile" class="interwiki iw_wpde" title="http://de.wikipedia.org/wiki/Makefile">Makefile</a>s gesteuert.  Dabei wird durch den Aufruf von ./configure das System analysiert und die ermittelten Werte in Makefiles &uuml;bernommen. 
</p>

<p>
Als User root wird PNP in /usr/local/src entpackt. 

</p>
<pre class="code">
tar -xvzf pnp4nagios-HEAD.tar.gz
cd pnp4nagios
</pre>

<p>
Im Verzeichnis pnp4nagios wird nun ./configure aufgerufen. 
</p>
<pre class="code">
./configure
</pre>

<p>

<strong>Hinweis:</strong> Ohne weitere Optionen werden als Benutzer und Gruppe “nagios” verwendet.  Bei abweichenden Werten sind die Parameter ”--with-nagios-user” und ”--with-nagios-group” zu benutzen.  Im Falle von Icinga k&ouml;nnte der Aufruf so aussehen

</p>
<pre class="code">
./configure --with-nagios-user=icinga --with-nagios-group=icinga
</pre>

<p>
Es laufen einige Zeilen &uuml;ber den Bildschirm.  Wichtig ist die Ausgabe zum Schluss. 
</p>
<pre class="code">
*** Configuration summary for pnp4nagios-0.6.2 23-12-2009 ***

  General Options:
  -------------------------         -------------------
  Nagios user/group:                nagios nagios
  Install directory:                /usr/local/pnp4nagios
  HTML Dir:                         /usr/local/pnp4nagios/share
  Config Dir:                       /usr/local/pnp4nagios/etc
  Location of rrdtool binary:       /usr/bin/rrdtool Version 1.2.12
  RRDs Perl Modules:                FOUND (Version 1.2012)
  RRD Files stored in:              /usr/local/pnp4nagios/var/perfdata
  process_perfdata.pl Logfile:      /usr/local/pnp4nagios/var/perfdata.log
  Perfdata files (NPCD) stored in:  /usr/local/pnp4nagios/var/spool

  Web Interface Options:  -------------------------         -------------------
  HTML URL:                         http://localhost/pnp4nagios/
  Apache Config File:               /etc/apache2/conf.d/pnp4nagios.conf


  Review the options above for accuracy.   If they look okay,
  type &#039;make all&#039; to compile.</pre>

<p>
Die angezeigten Pfade sollten nun gepr&uuml;ft werden.  Falls die gezeigten Werte nicht passen, kann durch einen erneuten Aufruf von ./configure mit den passenden Optionen Abhilfe geschaffen werden.<br/>

<strong>ACHTUNG:</strong> Nachdem es immer wieder Schwierigkeiten gibt: “Location of rrdtool binary” bedeutet inkl.  Namen des Binary!  Bei Bedarf kann man das beim ./configure als Parameter angeben:

</p>
<pre class="code"> ./configure --with-rrdtool=/usr/local/rrdtool-1.2.xx/bin/rrdtool</pre>
<pre class="code"> ./configure --help </pre>

<p>

zeigt, welche Optionen m&ouml;glich sind.<br/>
<br/>

Ein
</p>
<pre class="code">make all</pre>

<p>
kompiliert nun die in C geschriebenen Komponenten wie NPCD
</p>
<pre class="code">make install</pre>

<p>
kopiert alles an die richtige Stelle im Filesystem.  Die Pfade wurden ja beim ./configure bereits gezeigt. 
</p>

<p>
Nach der Installation der Programm- und <acronym title="HyperText Markup Language">HTML</acronym>-Dateien wird mit 
</p>
<pre class="code">make install-webconf</pre>

<p>
eine Konfigurationsdatei in das Konfigurationsverzeichnis des Apache-Web-Servers kopiert. 
</p>

<p>
Optional kann noch
</p>
<pre class="code">make install-config</pre>

<p>
aufgerufen werden.  Damit werden Config-Files f&uuml;r process_perfdata.pl und npcd nach etc/pnp kopiert.  
</p>

<p>
Wird das INIT Script f&uuml;r den NPCD ben&ouml;tigt, so sorgt
</p>
<pre class="code">make install-init</pre>

<p>
f&uuml;r die Installation nach /etc/init.d 
</p>

<p>
Zusammenfassen lassen sich diese einzelnen Commands durch
</p>
<pre class="code">make fullinstall</pre>

<p>
<strong>Hinweis:</strong> Wie oben schon beschrieben wird standardm&auml;ssig mit den Nagios-Einstellungen installiert.  Wird Icinga genutzt, muss in der Datei ”/etc/apache2/conf.d/pnp4nagios.conf” der Pfad zum AuthUserFile angepasst werden (Pfad evtl.  je nach Distri anpassen):
</p>
<pre class="code">
#       AuthUserFile /usr/local/nagios/etc/htpasswd.users
        AuthUserFile /usr/local/icinga/etc/htpasswd.users
</pre>

<p>
<strong>Achtung:</strong> Nach dem Kopieren der Konfigurationsdatei f&uuml;r den Web-Server bzw. & Auml;ndern des AuthUserFile ist ein Restart des Web-Servers notwendig (<code>service httpd restart</code> bzw.  <code>/etc/init.d/apache2 restart</code>). 
</p>

</div>
<!--  SECTION "Make und Co" [386-4176] -->
<h2><a name="update" id="update">Update</a></h2>
<div class="level2">

<p>

Das Update einer 0.6.x-Version funktioniert (fast) genauso wie die Installation.  Bitte beachten Sie, dass Sie beim ”./configure” die gleichen Optionen wie bei der Erstinstallation benutzen! 
Bitte pr&uuml;fen Sie außerdem, ob Sie &Auml;nderungen im Verzeichnis <code>share/templates.dist</code> vorgenommen haben.  Eigene Templates sollten im Ordner <code>share/templates</code> abgelegt werden.<br/>

<strong>Achtung</strong>:  Wenn Sie in der Datei config.php &Auml;nderungen vorgenommen haben, sollten Sie diese Datei sichern, bevor sie bei einem “make install-config” &uuml;berschrieben wird. 
</p>

<p>
Sie k&ouml;nnen die Schritte <code>make install-webconf</code> und <code>make install-init</code> &uuml;berspringen, denn zwischen den 0.6.x-Versionen gab es an dieser Stelle keine &Auml;nderungen. 
</p>

</div>
<!--  SECTION "Update" [4177-4912] -->
<h2><a name="die_komponenten" id="die_komponenten">Die Komponenten</a></h2>
<div class="level2">

<p>

Nach der Installation sind einige Komponenten von PNP an die passenden Stellen im Dateisystem kopiert worden. 
</p>

<p>
Im Folgenden sind dies die <acronym title="Hypertext Preprocessor">PHP</acronym>-Files f&uuml;r das Web-Frontend unter 

</p>
<pre class="code"> /usr/local/pnp4nagios/share</pre>

<p>

Der Datensammler process_perfdata.pl in 

</p>
<pre class="code"> /usr/local/pnp4nagios/libexec</pre>

<p>

Beispiel-Config-Files mit der Dateierweiterung <code>-sample</code> in

</p>
<pre class="code"> /usr/local/pnp4nagios/etc</pre>

<p>

Die Config-Datei config.php f&uuml;r das Web-Frontend in 

</p>
<pre class="code"> /usr/local/pnp4nagios/etc</pre>

<p>
<a href="/de/pnp-0.6/start" class="wikilink1" title="de:pnp-0.6:start">Zur&uuml;ck zur &Uuml;bersicht</a> | <a href="/de/pnp-0.6/config" class="wikilink1" title="de:pnp-0.6:config">Konfiguration</a>

</p>

</div>
<!--  SECTION "Die Komponenten" [4913-] -->