Sarg

From SME Server
Jump to: navigation, search

Sarg for SME Server

Maintainer

Stéphane de Labrusse AKA Stephdl

Dungog (Software)

Description

Sarg provides comprehensive reporting on the Squid web proxy usage.

Version

smeserver-sarg
The latest version of smeserver-sarg is available in the SME repository, click on the version number(s) for more information.


Installation

for sme8

This contrib can be found in the smecontribs repository.

yum --enablerepo=smecontribs install smeserver-sarg

No need to reboot.

Open yourserver/server-manager in a web browser

Administration > SARG reports

for sme9

You need to activate Stephdl

db yum_repositories set stephdl repository \
    BaseURL http://mirror.de-labrusse.fr/smeserver/\$releasever \
    EnableGroups no \
    GPGCheck yes \
    Name "Mirror de Labrusse" \
    GPGKey http://mirror.de-labrusse.fr/RPM-GPG-KEY \
    Visible yes \
    status disabled

and

signal-event yum-modify

then

yum --enablerepo=stephdl install smeserver-sarg
signal-event sarg-update
config set UnsavedChanges no

No need to reboot.

Open yourserver/server-manager in a web browser

Administration > SARG reports

Uninstall

rpm -e  sarg smeserver-sarg

Additional information

http://sarg.sourceforge.net/sarg.php

smeserver-sarg was was originally developed by Michel Van hees aka Master Sleepy, http://www.vanhees.cc Thanks Michel

User Identification

Enable Squid authentication for users to be correctly logged, see http://wiki.contribs.org/Dansguardian#Configuring_Proxy_to_use_Auth_login

Dansguardian

set sarg to use dansguardian logs

/usr/bin/sarglog dansguardian

also set dansguardian to save logs in squid format
edit /etc/dansguardian/dansguardian.conf and change following value:

logfileformat = 3

logs in dansguardian format are ignored, (you may need to force a rotation)

Sarg Options

optional settings for sarg, first option is default

config setprop sarg language [English|Dutch|French|German|Spanish|Italian|...]
config setprop sarg values [bytes|abbreviation]
config setprop sarg logfile [squid|dansguardian]
config setprop sarg lastlog [0|365|num.of.days.to.keep.logs]

expand-templates with

/usr/bin/sarglog

Troubleshooting

The first time you try to run reports from the Sarg server manager panel, you may receive errors, saying their is no data available.

Run the following commands to update sarg from the log files.

/usr/bin/sarg
/etc/cron.daily/sarg
/etc/cron.weekly/sarg
/etc/cron.monthly/sarg

Bugs

Please raise bugs under the SME-Contribs section in bugzilla and select the smeserver-sarg component or use this link .

"No open bugs found."

Changelog

Only versions released in smecontrib are listed here.


Tested software versions

  • Host: SME Server v7.2, v7.5.1
  • Installed: smeserver-sarg 2.2.1-6.el4.sme
  • Dependency Installed: sarg 2.2.3.1-1.el4.rf
  • Dependency Installed: gd 2.0.28-5.4E.el4_8.1