Differences between revisions 9 and 10
Revision 9 as of 2007-10-25 11:48:10
Size: 2415
Editor: ?Alf Tonny
Comment:
Revision 10 as of 2007-10-25 11:50:18
Size: 2435
Editor: ?Alf Tonny
Comment:
Deletions are marked like this. Additions are marked like this.
Line 29: Line 29:
#
#
#
Alias /sitesummary /var/lib/sitesummary/www
#
ScriptAlias /cgi-bin/sitesummary-collector.cgi /usr/lib/cgi-bin/sitesummary-col$
#
#
<Directory /var/lib/sitesummary/www>
# AllowOverride None
# Options +SymLinksIfOwnerMatch -MultiViews
#  
#   Alias /sitesummary /var/lib/sitesummary/www            ScriptAlias /cgi-bin/sitesummary-collector.cgi /usr/lib/cgi-bin/sitesummary-col$

<Directory /var/lib/sitesummary/www>
    AllowOverride None
    Options +SymLinksIfOwnerMatch -MultiViews
Line 39: Line 39:
# Order deny,allow
# Deny from all
# Allow from 127.0.0.1
#</Directory>
    Order deny,allow
    Deny from all
    Allow from 127.0.0.1
</Directory>

How to set up sitesummary

Keeping track of a lot of machines isn't easy. It is hard to know when a machine disappears, and when new machines arrives. It can become a bit easier if the machines themselves assist. To make that possible, the sitesummary system is created. It consist of a server part collecting information, and a client part submitting it. The server can then based on the submitted information make reports helping the sysadmin keeping track of the site.

On the server

To use sitesummary, the server part need to be configured first. It need to run on a machine accessable from all the clients using HTTP.

Install the 'sitesummary' package, and configure apache to find the CGI file in /usr/lib/cgi-bin/.

('aptitude install sitesummary')

when i installed sitesummary, the configuration for apache2 automatical were added. but if not, you do that in /etc/apache2/conf.d/sitesummary

# # New URL http://<host>/sitesummary/ listing the current statistics, and # http://<host>/cgi-bin/sitesummary-collector.cgi to receive submissions. # # Alias /sitesummary /var/lib/sitesummary/www ?ScriptAlias /cgi-bin/sitesummary-collector.cgi /usr/lib/cgi-bin/sitesummary-col$

<Directory /var/lib/sitesummary/www>

  • ?AllowOverride None Options +?SymLinksIfOwnerMatch -?MultiViews

  • # allow only localhost per default
    • Order deny,allow Deny from all Allow from 127.0.0.1

</Directory>

this is how the file should look like.

A trivial report example is now available from [http://maintainer.skolelinux.no/sitesummary/ the debian-edu servers].

Munin integration

The server will by default generate a munin server configuration in /var/lib/sitesummary/munin.conf. The location of this file can be modified by adding for example MUNINDIR=/etc/munin in /etc/sitesummary/collector.cfg.

This way all hosts reporting to sitesummary will also be monitored using munin. This is done on the [http://maintainer.skolelinux.no/munin/ the debian-edu servers].

On the client

Install the sitesummary-client package, and use dpkg-reconfigure sitesummary-client to specify the URL to use when submitting reports. Also specify key information on the host to make the reports more useful.

The packages are available from http://ftp.skolelinux.org/skolelinux/pool/local/s/sitesummary/