1. check_multi downloaden .
2. Den Tarball auspacken und in das check_multi-Verzeichnis wechseln.
3. Dann wird der uebliche Dreischritt ausgefuehrt (gueltig fuer die 'default' Nagios-Installation in /usr/local/nagios):

   # ./configure; make all; make install

4. Beispiel-Konfigurationen gibts im Verzeichnis sample-config.
5. check_multi benoetigt eine Nagios-Version ab 3.0a4. Im Zweifelsfall lohnt es sich, eine Testumgebung mit der neuesten Nagios-Version aufzusetzen. Bitte auch die Buffer limits beachten.
6. check_multi in die Nagios-Konfiguration integrieren.
7. Die Nagios-Konfiguration fuer check_multi einmal neuladen, danach ist kein Neustart mehr notwendig!
8. Einen Blick in die Services or Extended Info werfen.
9. Viel Spass!

Hinweis: Hintergrundinformationen zum Thema Buffergroessen, Nagios transports und Multiline gibts auch in diesem Blog-Artikel.

Bitte die Buffer limits MAX_PLUGIN_OUTPUT_LENGTH und MAX_INPUT_BUFFER erweitern (es schadet nicht, beide auf 8192 zu setzen). Dazu ein Auszug aus der Nagios 3.x documentation:

Plugin Output Length Restrictions
  
Nagios will only read the first 4 KB of data that a plugin returns. 
This is done in order to prevent runaway plugins from dumping megs 
or gigs of data back to Nagios. This 4 KB output limit is fairly 
easy to change if you need. Simply edit the value of the
MAX_PLUGIN_OUTPUT_LENGTH definition in the include/nagios.h.in file 
of the source code distribution and recompile Nagios. There's 
nothing else you need to change!

Danach Nagios kompilieren und installieren.

Check_multi kann als normales Plugin natuerlich auch ueber NRPE betrieben werden.

Noch ein Hinweis zur Kompilierung von NRPE: Die buffer sizes in common.h MAX_INPUT_BUFFER and MAX_PACKETBUFFER_LENGTH sollten auch auf 8192 gesetzt werden.

Wer noch eine alte NRPE-Version (vor dem 8. Mai 2007) einsetzt: Multiline kann NRPE erst seit der Version 2.8.

check_by_ssh ist seit der Version 1.4.10 der offiziellen Nagios Plugins multiline-faehig. Fuer aeltere Versionen bitte den folgenden Patch verwenden.

Seit dem 1. Juli 2009 kann die NDO mit multiline Plugin-Output umgehen, bitte verwenden Sie eine aktuelle Version der ndoutils.
Die NDO ist nicht multiline-faehig, da im NEB-Modul ndomod nur das output-Feld, nicht aber long_output uebergeben wird. Dieser kleine Patch behebt das Problem.

Die Puffergroesse fuer ndomod.o wird durch NDOMOD_MAX_BUFLEN in der ndomod.h definiert und ist standardmaessig nur 4096 Bytes gross. Wenn der check_multi-Output groesser ist als 4KB, bitte diesen Wert heraufschrauben und ndomod.o neu kompilieren.

Seit der SVN222 bzw. der stable 0.20 gibt es auch fuer check_multi ein configure.

Wer sein Nagios unter /usr/local/nagios installiert, ist schnell fertig:

1. Tarball auspacken:

   # cd /tmp
   # tar xpzf check_multi-0.20-current.tgz

2. in das check_multi-Verzeichnis wechseln

   # cd check_multi-0.20-current

3. den ueblichen Dreischritt ausfuehren:

   # ./configure
   # make all
   # make install

Das war es auch schon.

Nun zu den Details:

• Wer andere Settings setzen moechte als die Defaults, rufe bitte die configure-Hilfe auf:

  # ./configure --help

• Tip: wer eine komplizierte Configure-Zeile verwendet, sollte sich diese als Shell-Script-Einzeiler abspeichern, um sie spaeter wieder aufrufen zu koennen.
• Ausserdem gibt es nun ausfuehrliche Tests, die auch per make ausgefuehrt werden koennen:

  # make test