Installation Instructions

1. Obtain latest release and checksum from the sourceforge project page located at http://sourceforge.net/projects/ravparse .
2. Download the corresponding .md5 file.
3. Verify the package you have is not corrupt using md5sum. With the md5sum package and the .md5 file, you can do this by issuing the following command ( while in the same directory as the downloaded file ):
   $ md5sum -c <md5 file>
   If there is an error, try re-downloading the archive. If that still doesn't work, submit a bug at the project page listed above.
4. Decompress the file. Use bunzip2 for the .bz2 files, and gunzip for the .gz file:
   $ gunzip <package file>.tar.gz
$ bunzip2 <package file>.tar.bz2
5. Extract the tar file:
   $ tar -xvf <package file>.tar
6. Configure the package according according to the docs/FAQ and docs/MANUAL files inside the installation directory.
7. Make sure you define the shell variable RAVKIT_HOME prior to execution. This can be either in your cron or the in the profile of the user you use to run the parser under. For example in the ~/.bash_profile add the following:
   export RAVKIT_HOME=/usr/local/ravparse
8. Create the mysql database using the $RAVKIT_HOME/lib/db_create_rav.sql .
9. Start parsing logs !

Sample Installation

sryan@scriptmonkey:~/code/build$ ls -al 
total 36 
drwxr-xr-x 3 sryan sryan 4096 Feb 16 00:28 . drwxr-xr-x 15 sryan sryan 4096 Feb 14 17:40 .. 
-rw-r--r-- 1 sryan sryan 19832 Feb 16 00:27 ravparse-0.1.tar.gz 
-rw-r--r-- 1 sryan sryan 54 Feb 16 00:27 ravparse-0.1.tar.gz.md5.gz 

sryan@scriptmonkey:~/code/build$ md5sum -c ravparse-0.1.tar.gz.md5.gz
sryan@scriptmonkey:~/code/build$ tar -zxvf ravparse-0.1.tar.gz 

ravparse-0.1/ 
ravparse-0.1/bin/
ravparse-0.1/bin/fetchlogs.sh 
ravparse-0.1/bin/importlogs.sh 
ravparse-0.1/bin/perl_time.pl 
ravparse-0.1/bin/ravlog_parser.pl 
ravparse-0.1/bin/ravlog_summarizer.pl 
ravparse-0.1/bin/ravlog_summary_flush.pl 
ravparse-0.1/README 
ravparse-0.1/conf/ 
ravparse-0.1/conf/ravkit_perl.conf 
ravparse-0.1/conf/ravkit.conf 
ravparse-0.1/cron/ 
ravparse-0.1/cron/cron.example 
ravparse-0.1/cron/README 
ravparse-0.1/docs/ 
ravparse-0.1/docs/MANUAL 
ravparse-0.1/docs/FAQ 
ravparse-0.1/htdocs/ 
ravparse-0.1/htdocs/db_connect.inc 
ravparse-0.1/htdocs/details.inc 
ravparse-0.1/htdocs/footer.inc 
ravparse-0.1/htdocs/form_output.inc 
ravparse-0.1/htdocs/form_processor.inc 
ravparse-0.1/htdocs/header.inc 
ravparse-0.1/htdocs/index.php 
ravparse-0.1/lib/ 
ravparse-0.1/lib/Database.pm 
ravparse-0.1/lib/db_create_rav.sql

sryan@scriptmonkey:~/code/build$ ln -s ravparse-0.1 ravparse
sryan@scriptmonkey:~/code/build$ ls -al
total 40
drwxr-xr-x    4 sryan    sryan        4096 Feb 16 00:38 .
drwxr-xr-x   15 sryan    sryan        4096 Feb 14 17:40 ..
lrwxrwxrwx    1 sryan    sryan          12 Feb 16 00:38 ravparse -> ravparse-0.1
drwxr-xr-x    8 sryan    sryan        4096 Feb 14 17:43 ravparse-0.1
-rw-r--r--    1 sryan    sryan       19832 Feb 16 00:27 ravparse-0.1.tar.gz
-rw-r--r--    1 sryan    sryan          54 Feb 16 00:27 ravparse-0.1.tar.gz.md5.gz

sryan@scriptmonkey:~/code/build/ravparse$ ls
README  bin  conf  cron  docs  htdocs  lib
sryan@scriptmonkey:~/code/build/ravparse$ pwd
/home/sryan/code/build/ravparse
sryan@scriptmonkey:~/code/build/ravparse$ export RAVKIT_HOME=/home/sryan/code/build/ravparse
sryan@scriptmonkey:~/code/build/ravparse$ echo $RAVKIT_HOME
/home/sryan/code/build/ravparse
sryan@scriptmonkey:~/code/build/ravparse$

sryan@scriptmonkey:~/code/build/ravparse$ mysqladmin create rav -p
Enter password:
You have new mail in /var/mail/sryan
sryan@scriptmonkey:~/code/build/ravparse$ cd lib
sryan@scriptmonkey:~/code/build/ravparse/lib$ pwd
/home/sryan/code/build/ravparse/lib
sryan@scriptmonkey:~/code/build/ravparse/lib$ ls
Database.pm  db_create_rav.sql
sryan@scriptmonkey:~/code/build/ravparse/lib$ cat db_create_rav.sql | mysql rav -p
Enter password:
sryan@scriptmonkey:~/code/build/ravparse/lib$

Basically that's it. You configure some of the options that you want in the conf directory, specifically the database connection information ( database, username, password, host, etc ). Most of the other options can be left to the default value. The only important thing to remember is to set the RAVKIT_HOME environment variable to the installation directory.

Hope this is helpful.
Sean Ryan
System Administrator