This README is incomplete, please feel free to send me a nice README :)

Overview
--------

syslogForwarder.pl and syslogReceiver.pl are designed to work
together to create an encrypted syslog tunnel for your secure
syslog needs.  

syslogReciever:
  Listens on a network port (UDP/514) for incoming messages and 
  sends them to the local syslog daemon via /dev/log.
  
syslogForwarder: 
  Listens on a network port (usually 127.0.0.2:514) for incoming
  messages from the local syslog daemon, encrypts the messages
  and sends them to the syslogReceiver process listening on your
  central syslog server.



Installation
------------

Central syslog server:

1. Copy syslogReciever.pl to /usr/local/sbin
2. Edit the pass-phrase in the top of the script.
   This pass-phrase needs to be the same in both 
   syslogForwarder.pl and syslogReceiver.pl!  Make
   sure you specify the pass-phrase in hex format!
3. Start syslogReceiver.pl with a command like this:
   
   $ /usr/local/syslogReceiver.pl -d -p 514 
   
   or if you want syslogReciever to track message ID's 
   (if you need to know if a message is lost in transit)
   start it like this:
   
   $ /usr/local/syslogReceiver.pl -d -p 514 --track-messages
   
   or if you want to know when a host has not syslogged a
   message in 15 minutes start it like this:
   
   $ /usr/local/syslogReceiver.pl -d -p 514 --track-messages --track-hosts 15
   
   if you need to receive encrypted as well as non-encrypted 
   messages start it like this:
   
   $ /usr/local/syslogReceiver.pl -d -p 514 --accept-all
   

Remote workstation/server installation:

1. Copy syslogForwarder.pl to /usr/local/sbin
2. Edit the pass-phrase in the top of the script.
   This pass-phrase needs to be the same in both 
   syslogForwarder.pl and syslogReceiver.pl!  Make
   sure you specify the pass-phrase in hex format!
3. Start syslogForwarder.pl with a command like this:
   
   $ /usr/local/syslogForwarder.pl -d syslogserver.company.com:514

4. Configure your local syslog daemon to send important messages
   to syslogForwarder on 127.0.0.2.  Add a line like this to 
   /etc/syslog.conf:
   
   # Send almost everything to syslogForwarder
   *.info;mail.none     @127.0.0.2

5. Tell syslogd to re-read it's configuration
   
   # killall -HUP syslogd

