Introduction


Calamaris v2 is a logfile parser and report generator, originally written by Cord Beermann and distributed under the GNU Public License. This add-on integrates Calamaris into the IPCop 2.x.x GUI and gives you the ability to create customized, detailed, menu driven Proxy reports.



Report features of the Calamaris add-on

  • Summary
  • Request method (GET, HEAD, ...)
  • Incoming requests (TCP and UDP)
  • Outgoing requests
  • Requested first- and second-level domains
  • Protocol report (http, gopher, ftp, ...)
  • Requested content-types and file extensions
  • Size based distribution of objects
  • Performance in defined timeranges


Installation

  • Download the tar archive
  • Copy the tar archive via SCP to your IPCop box. Windows users can use WinSCP for this. Keep in mind that SSH must be enabled and you will have to use port 222 instead of 22.
  • Login as root on the console or via SSH. Windows users can use PuTTY for this.
  • chdir to the place where you put the archive
  • Extract the tar archive with the command:
    • tar -xvzf ipcop-calamaris-3.0.1.tgz
  • install Calamaris addon with the command:

    ./ipcop-calamaris-3.0.1/install





How to use

  • Open the Administration page in your browser
  • Go to "Logs" menu select "Proxy reports"
  • Enjoy the Calamaris reports!

Main Page Screenshot







FAQ

No. Calamaris v2 is already included in the add-on installation package.
Depending on the size of the log files, the selected report options and the speed of your CPU, it will usually take between 1 and 3 minutes for generating a report.
  • It doesn't modify any firewall rules.

  • It doesn't establish connections to external sites.

  • It doesn't install additional services, but it adds some binary files.
This software is free for personal and commercial use and is released under the GNU General Public License:

You are allowed to:

  • change code as long as you publish changes, who made changes and when it was changed

  • You have to give access to your changes (download) to any third-party. All changes are released under GPL too.
You are NOT allowed to:

  • rebrand Calamaris (just give it a different name and thinking it's a code change under GPL)

  • remove any copyright information

  • soften or change copyrights
English, German, Brazilian Portuguese, Spanish, Italian, Dutch, Polish and Russian.
Please read the installation,usage, and faq section before send any question about the addon.

Please enter the security code: