Difference between revisions of "Sarg"
From SME Server
Jump to navigationJump to searchUnnilennium (talk | contribs) |
|||
| (28 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 === | ||
| − | + | [http://sarg.sourceforge.net/ Sarg] provides comprehensive reporting on the Squid web proxy usage. | |
| − | + | === Version === | |
| − | + | {{ #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 | ||
| − | + | 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 | ||
| − | yum --enablerepo= | + | 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 === | === Uninstall === | ||
| − | + | rpm -e sarg 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 |
| − | |||
==== 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: 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 | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
---- | ---- | ||
| Line 97: | Line 113: | ||
[[Category: Contrib]] | [[Category: Contrib]] | ||
[[Category: Dungog]] | [[Category: Dungog]] | ||
| + | [[Category: Administration:Monitoring]] | ||
Latest revision as of 04:45, 20 August 2022
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
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
