Installation Instructions:

Required software:

1. Perl
2. http server (Apache, lighthttpd, etc)
3. Squid
4. Cron

or equivalent

in example i use Apache

1. Extract lightsquid.tgz into any folder

cd /var/www/htdocs/
mkdir lightsquid
cd lightsquid
tar -xzf lightsquid.tgz

set 'executable' flag for scrip

chmod +x *.cgi
chmod +x *.pl

change owner

chown -R apache:apache *
(where apache = httpd user)

2. Configure your Apache server

.cgi files must execute as CGI scrip

<Directory "/var/www/html/lightsquid">
   AddHandler cgi-script .cgi
   AllowOverride All
</Directory>

Restart apache

3. Edit lightsquid.cfg

4. If you want GROUP reports - edit group.cfg

format:

esl	01	SysAdmin
karlos	01	SysAdmin
thy	01	SysAdmin
Ivanov	02	Developer
Ivanov2	02	Developer
Petrov	03	Commerial
Petrova	03	Commerial
vasyav	04	room 312
petyava	04	room 312

5. If you want use REALNAME - edit realname.cfg

format:

esl	Sergey Erokhin
karlos	Super User1
thy	Tech Good
Ivanov	Developer numer one
Ivanov2	Developer numbe two
Petrov	Good Commerial
Petrova	Bad Commerial
vasyav	Some User1
petyava	Some User2

6. if you want graphics report

check graph report

7. run check-setup.pl

if all done try next step
else check config file.

8. Try run lightparser.pl

if everything is ok no messages will be produced

parse old statistic
./lightparser.pl access.log.1.{gz|bz2}
./lightparser.pl access.log.2.{gz|bz2}
./lightparser.pl access.log.3.{gz|bz2}
...

9. Try to use lightsquid

Using your favorite browser enter http://<host where we live>/lightsquid/

10. Setup crontab to run lightparser once per hour

crontab -e
This example will execute parser every 20 minutes

*/20 * * * * /var/www/htdocs/lightsquid/lightparser.pl today

if you have small log and fast machine, you may run lightparser with smaller delay
warning not set interval less 10 min

11. All done!

12. If you have problems, define $debug variable in lightsquid.cfg and rerun lightparser.