Logmonster Install

= Installation =

Download Logmonster

'''Step 1. Install''' like any other perl module:

perl Makefile.PL make test make install

If you are missing any dependencies, they will be listed in the first step. The dependent modules can be installed via CPAN, or if you are running FreeBSD, you can have these installed from ports by running the included script:

bin/install_freebsd_deps.sh

Required dependencies:
 * Compress::Zlib
 * Date::Parse (TimeDate)
 * Params::Validate

'''Step 2. Install the config file'''

make conf or make newconf

newconf will overwrite any existing config file, so use it only for new installs.

'''Step 3. Edit logmonster.conf''' vi /usr/local/etc/logmonster.conf

Documentation is included inline. Configure it to match the way your server is set up.

Step 4 - Edit web server config For Apache:

Adjust the CustomLog and ErrorLog directives. We make three changes, adding our custom LogFormat definition, CustomLog adding cronolog to automatically rotate the log files.

LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\" %v" logmonster CustomLog "| /usr/local/sbin/cronolog /var/log/http/%Y/%m/%d/access.log" logmonster ErrorLog "| /usr/local/sbin/cronolog /var/log/http/%Y/%m/%d/error.log"

For lighttpd:

accesslog.format = "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\" %v" accesslog.filename = "|/usr/local/sbin/cronolog /var/log/http/%Y/%m/%d/access.log" server.errorlog = "/var/log/http/error.log"

Step 5 - Test manually, then add to cron.

/usr/local/bin/logmonster.pl -i day -v crontab -u root -e 5 1 * * * /usr/local/bin/logmonster.pl -i day

Step 5 - Read the FAQ

Logmonster FAQ

Step 6 - Enjoy

Allow Logmonster to make your life easier by handling your log processing. Enjoy the daily summary emails, and then express your gratitude by making a small donation to support future development efforts.