diff --git a/README.md b/README.md index 0d9b6a6..a226c9b 100644 --- a/README.md +++ b/README.md @@ -1,19 +1,62 @@ -# monitord-activemq +# monitord -## Dependency -monitord-activemq depends on activemq-cpp. +monitord ist ein Funkauswerter fuer die Protokolle ZVEI, Pocsag und FMS. +Das eigentliche monitord-Projekt liegt auf www.monitord.de. +Da die Entwicklung allerdings nicht mehr sonderlich aktiv ist, habe ich hier bei Github das Repository geklont. -## Installation -Just push back this directory into /monitord/trunk. +## Infos +Dies Repo ist nur ein Klon vom SVN-Repo. Sollten dort Änderungen auftauchen, werde ich sie hier zurückspielen. +Ich bin weder Leiter des Projekts noch Ansprechpartner für irgendwelche Protokollfragen :-) -## Compiling on CentOS 6.2 - +## Kompilierung +### Cent OS 6.2 yum install autoconf automake libtool pkg-config alsa-lib-devel lua-devel aclocal -Im4 - ./configure --enable-plugins --with-activemq + ./configure && make && make install -## Configuration -Edit your monitord.xml: +## Features gegenüber der SVN-Basis +### Integration log4cxx +Die monitord-Version aus dem Subversion-Repository beinhaltet einen einfachen Logging-Mechanismus, der i.a.R. auch ausreicht. +Will man allerdings File-Rolling haben, braucht man einen anderen Logging-Provider. +Aus diesem Grund habe ich log4cxx integriert. +#### Kompilierung +log4cxx muss selbst gebaut werden. Die aktuelle Version 0.10.0 enthält zwei Fehler, die mit einem Patch gefixt werden können. + # nötige Libs + yum install apr apr-util apr-devel apr-util-devel + # log4cxx von einer passenden Location herunterladen + wget $apache-log4cxx-0.10.0.tar.gz + tar -xvf apache-log4cxx-0.10.0.tar.gz + # Patch von Markus Mazurczak einspielen + # siehe http://markus-mazurczak.de/?p=76 + ./configure && make && make install + +Da log4cxx standardmäßig keine pkg-config-Datei erzeugt, muss der Pfad zu den Include-Dateien bei der Kompilierung von monitord manuell mit angegeben werden: + ./configure --with-log4cxx --with-log4cxx-includes=/pfad-zu-log4cxx-includes + +#### Konfiguration +In der monitord.xml gibt es nur zwei Sachen zu konfigurieren: + + log4cxx + /pfad/zu/log4cxx.properties + ... + + +Sobald logfile auf 'log4cxx' gestellt ist, wird log4cxx auch benutzt. log4cxxConfig kann zu einer log4cxx.properties oder log4cxx.xml verweisen. Wird keine definiert, werden die Default-log4cxx-Einstellungen benutzt. + +### Integration ActiveMQ +ActiveMQ ist eine Messaging Queue, die nach dem Pub/Sub-Verfahren arbeitet. +Das Plugin libmplugin_activemq pusht automatisch alle eingehenden Nachrichten (ZVEI, Pocsag, FMS) in die hinterlegte Queue. +Andere Clients können darauf zugreifen und die Nachrichten dementsprechend verarbeiten. +#### Kompilierung +Entweder muss das Paket activemq-cpp selbst kompiliert werden oder aber man zieht es sich aus einem RPM-/Deb-Repository. + yum install activemq-cpp + +Danach muss monitord mit den Parametern + ./configure --enable-plugins --with-activemq +kompiliert werden. + +#### Konfiguration +Das Plugin wird in der monitord.xml folgendermaßen konfiguriert: @@ -50,3 +93,6 @@ + +Bitte beachten: Der XML-Parser von monitord unterstützt *keine* leeren Tags (also oder ). Sollte die Konfiguration dennoch einen solchen enthalten, gibt es einen Segmentation Fault. +