# monitord 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. ## 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 :-) ## Kompilierung ### Cent OS 6.2 yum install autoconf automake libtool pkg-config alsa-lib-devel lua-devel aclocal -Im4 ./configure && make && make install ## 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: <monitordconfig> <logfile>log4cxx</logfile> <log4cxxConfig>/pfad/zu/log4cxx.properties</log4cxxConfig> ... </monitordconfig> 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: <dataplugins> <plugin name="activemq"> <file>plugins/libmplugin_activemq.so</file> <parameters> <logfile>activemq.log</logfile> <loglevel>DEBUG</loglevel> <brokerUri>tcp://127.0.0.1:61616</brokerUri> <username>your_username_or_empty</username> <password>your_password_or_empty</password> <clientId>your_clientid_or_empty</clientId> <sendTimeout>5</sendTimeout> <closeTimeout>5</closeTimeout> <producerWindowSize>5</producerWindowSize> <useCompression>1</useCompression> <clientAck>0</clientAck> <!-- generic configuration --> <useTopic>1</useTopic> <deliveryModePersistent>0</deliveryModePersistent> <destUri>zabos</destUri> <!-- overwrite generic configuration for FMS --> <topic type="fms"> <destUri>zabos.fms</destUri> </topic> <!-- overwrite gneric configuration for POCSAG --> <topic type="pocsag"> <useTopic>0</useTopic> <!-- destUri is still zabos, imported by generic configuration --> </topic> <!-- ZVEI is not defined, so generic configuration is used --> </parameters> </plugin> </dataplugins> Bitte beachten: Der XML-Parser von monitord unterstützt *keine* leeren Tags (also <tag/> oder <tag></tag>). Sollte die Konfiguration dennoch einen solchen enthalten, gibt es einen Segmentation Fault.