Carnivore Host Monitoring System
Copyright (c) 2003, Gumbynet & Damien Gardner Jnr
All rights reserved.

   Redistribution and use in source and binary forms, with or without modification,
   are permitted provided that the following conditions are met:

   * Redistributions of source code must retain the above copyright notice, this list
       of conditions and the following disclaimer.
   * Redistributions in binary form must reproduce the above copyright notice, this list
       of conditions and the following disclaimer in the documentation and/or other
       materials provided with the distribution.
   * Neither the name of GumbyNet nor the names of its contributors may be used to
       endorse or promote products derived from this software without specific prior written permission.

   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS
   OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
   AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER
   OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
   CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
   SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
   THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
   OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Brief Install Instructions

Ok, for a start, extract out the tgz file, you'll get a number of directories:

doc        - This documentation, a sample config file, and the db definitions
lib        - Contains any libraries required to run this package
php-web    - PHP site source
src        - The java source for the site..

Quick installation instructions:

* Create a new postgres db.  Whether you create a user to go with, or use an existing user is up to you..
drop the dbdefs.sql script into your db.. - something like the following should get you going:

psql carnivore < doc/dbdefs.sql

Note that you'll probably want to change the default hosts and host_services entries..  If you're installing on Windows rather than linux, edit the service entry for ping, and change PINGLinHelper to PINGWinHelper :).  Also make sure that ping is in your path :)

Edit the php-web/include/pgsql.inc to set your db location, username, password, and db name
Copy the doc/carnivore.server.properties file into your install directory, and setup the database properties

* Compile the java sources.. something like the following should do it:

mkdir classes
cd src
find ./ -name *.java | xargs javac -d ../classes -classpath ../classes


* Point your apache at php-web/

* You're now ready to run carnivore..

su
java -cp classes:lib/postgresql-8.3-604.jdbc3.jar org.gumbynet.carnivore.server.CarnivoreServer

The Carnivore daemon should now be running, and provided you've setup the host and host-service mappings in
the database, you should be able to hit the web pages, and view the status and history of your hosts.
