INSTALL file for Logdog, a daemon for monitoring syslog messages.


Installing LogDog
=================
Synopsis: make install

Make sure to read AND FOLLOW the notes displayed after running
the "make install"!

Logdog consists of two main files: logdog.pl and logdog.conf
Running a "make install" copies logdog.pl to /usr/local/sbin/
and copies logdog.conf to /etc/.
It also creates a fifo device at /var/log/fifo.logdog

After the "make install" is complete you need to MANUALLY 
edit your syslog.conf and add an entry like this:
*.info                       |/var/log/fifo.logdog

and then restart syslogd by running "killall -HUP syslogd" 
before attempting to start LogDog.  If you don't do this Logdog
will hang at startup!


Starting Logdog
===============
After this has been done you can start Logdog with a command like:
/usr/local/sbin/logdog.pl -d

By default it will create a log file at /var/log/logdog and start logging
to it.  If you have problems be sure to check that file or start Logdog
with debugging enabled by adding a -v or -vvv to the command line.

For your convenience there is also a rc.logdog script in the distribution
directory that you can use it to start and stop Logdog.  To use it just run
"rc.logdog start" or "rc.logdog stop", etc.


Brandon Zehm <caspian@dotconf.net>

