Difference between revisions of "Sarg"

From SME Server
Jump to navigationJump to search
 
(27 intermediate revisions by 9 users not shown)
Line 1: Line 1:
 +
{{Languages|Sarg}}
 
== Sarg for SME Server ==
 
== Sarg for SME Server ==
  
 
=== Maintainer ===
 
=== Maintainer ===
 +
[mailto:stephdl@de-labrusse.fr Stéphane de Labrusse] AKA [[User:Stephdl|Stephdl]]<br />
 +
 
[http://www.dungog.net Dungog] (Software)
 
[http://www.dungog.net Dungog] (Software)
  
 
=== Description ===
 
=== Description ===
  
−
*Sarg provides comprehensive reporting on the Squid web proxy usage.  
+
[http://sarg.sourceforge.net/ Sarg] provides comprehensive reporting on the Squid web proxy usage.
−
 
+
=== Version ===
−
Orginates from http://www.dungog.net/sme/dansguardian.php#sarg  
+
{{ #smeversion: smeserver-sarg}}
 +
{{ #smeversion: sarg}}
 +
[[Version::contrib9|stephdl]][[Has SME9::true| ]]
  
 
=== Installation ===
 
=== Installation ===
 +
====for sme8====
 +
This contrib can be found in the smecontribs repository.
 +
yum --enablerepo=smecontribs install smeserver-sarg
  
−
1. Log in (with username root) to the SMEserver console.
+
No need to reboot.
  
−
2. If you already enabled Dungog repo, skip down to 4.
+
Open yourserver/server-manager in a web browser
  
−
3. {{Repository|Dungog}}
+
Administration > SARG reports
  
−
4. Install sarg and smeserver-sarg
+
====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
  
−
  yum --enablerepo=dungog install smeserver-sarg
+
then
 +
  yum --enablerepo=stephdl install smeserver-sarg
 +
signal-event sarg-update
 +
config set UnsavedChanges no
  
−
5. The following commands are not required:
+
No need to reboot.
  
−
signal-event post-upgrade; signal-event reboot
+
Open yourserver/server-manager in a web browser
  
−
6. Open YOURSERVER/server-manager in a web browser
+
Administration > SARG reports
−
 
 
−
Configuration > web statistics and review settings.
 
−
 
 
−
=== Check installed version ===
 
−
yum info installed *sarg
 
−
That will show both packages.
 
  
 
=== Uninstall ===
 
=== Uninstall ===
−
  yum remove sarg
+
  rpm -e  sarg smeserver-sarg
−
This will also remove smeserver-sarg.
 
  
 
=== Additional information ===
 
=== Additional information ===
Line 47: Line 62:
 
==== User Identification ====
 
==== User Identification ====
  
−
Enable Squid authentication for users to be correctly logged
+
Enable Squid authentication for users to be correctly logged, see http://wiki.contribs.org/Dansguardian#Configuring_Proxy_to_use_Auth_login
−
* todo
 
  
 
==== Dansguardian ====
 
==== Dansguardian ====
Line 55: Line 69:
  
 
also set dansguardian to save logs in squid format<br>
 
also set dansguardian to save logs in squid format<br>
 +
edit /etc/dansguardian/dansguardian.conf and change following value:
 +
logfileformat = 3
 
logs in dansguardian format are ignored, (you may need to force a rotation)
 
logs in dansguardian format are ignored, (you may need to force a rotation)
  
Line 66: Line 82:
 
expand-templates with
 
expand-templates with
 
  /usr/bin/sarglog
 
  /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 ===
 
=== Bugs ===
 
Please raise bugs under the SME-Contribs section in {{BugzillaFileBug|product=|component=|title=bugzilla}}and select the smeserver-sarg component or use {{BugzillaFileBug|product=SME%20Contribs|component=smeserver-sarg|title=this link}}.
 
Please raise bugs under the SME-Contribs section in {{BugzillaFileBug|product=|component=|title=bugzilla}}and select the smeserver-sarg component or use {{BugzillaFileBug|product=SME%20Contribs|component=smeserver-sarg|title=this link}}.
 +
 +
{{#bugzilla:columns=id,product,version,status,summary |sort=id |order=desc |component=smeserver-dansguardian-sarg |noresultsmessage="No open bugs found."}}
 +
 +
===Changelog===
 +
Only versions released in smecontrib are listed here.
 +
 +
{{ #smechangelog: smeserver-sarg}}
  
 
=== Tested software versions ===
 
=== Tested software versions ===
−
* Host: SMEserver v7.2
+
* Host: SME Server v7.2, v7.5.1
−
* Installed: smeserver-sarg 2.2.1-4.el4.sme
+
* Installed: smeserver-sarg 2.2.1-6.el4.sme
−
* Dependency Installed: sarg 2.2.1-1.el4.rf
+
* Dependency Installed: sarg 2.2.3.1-1.el4.rf
 +
* Dependency Installed: gd 2.0.28-5.4E.el4_8.1
  
 
----
 
----
Line 79: Line 113:
 
[[Category: Contrib]]
 
[[Category: Contrib]]
 
[[Category: Dungog]]
 
[[Category: Dungog]]
 +
[[Category: Administration:Monitoring]]

Latest revision as of 05:45, 20 August 2022

Geographylogo.png Languages: 

English  • français


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.


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


stephdl

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
Retrieved from "https://wiki.koozali.org/index.php?title=Sarg&oldid=41603"