ANTEATER README

$Id: README,v 1.3 2003/10/23 15:33:02 drzoom Exp $

Install

Follow the instructions in the "INSTALL" File to compile and install this Tool. It's very easy:

Type

        ./configure --prefix=/usr/local
        make

and as root:

make install

Documentation

You will find a german html-documentation in "anteater/docs/de" in this distribution.

For a list of new features and changes, check first the "ChangeLog" file in the distribution. And please read the "TODO" File too.

Run

To get your first analyse you need the syslog with the sendmail entrys, and the "aliases" file from the mailserver. Virtursetable and other important configuration-files are not implemented but have a look to the source code: it's very simple to add new features to this tool.

In this example, the sendmail logfile is in "/home/myself/maillog" and the aliases file is in "/home/myself/aliases". Type this:

anteater --filter-sendmail --domain=yourdomain.xxx

      --aliases-file=/home/myself/aliases
      --analyse-all --limit=50 --filter-file=/home/myself/maillog
      --report-html --report-html-file=anteater_report.html

An example with a postfix logfile:

anteater --filter-postfix --domain=yourdomain.xxx

      --analyse-all --limit=50 --filter-file=/home/myself/maillog
      > ascii_report.txt

And you get all current implemented analyses in html. If you search for a special parameter or more features, you can use the debug Parameter...

anteater -mhtml > allparameters.html

...to get a (big) list over all modules, parameters etc. in the current Version of anteater. Or use...

anteater -m | less

...t get the same on the console.

Have Fun!

Tobias

Known "bugs" ...

Old Compilers:
Use the configure option --enable-sprintf to use sprintf instead of "stringstreams".

Contact

see http://www.sourceforge.net/projects/anteater/