1.1 - Extract
Download the W3Perl package. Extract it on your web server root, it will create a /w3perl/ directory.
1.2 - Permission
Give execution permission to the scripts (chmod +x *.pl) if not.
Two directories shoud be readable/writeable by the server if you
want to use the administration interface :
/w3perl/config/ and /w3perl/resources/admin/, so chmod 777 if not.
1.3 - Installation
- Automatic
If you are running an Apache server, you can use
'install.pl -a' to install the package without editing anything. The 'a'
flag will install w3perl on the main server found in the apache
configuration file (Apache configuration file should be readable by
the script). In fact, the script is just looking for the ScriptAlias
directive to find where the cgi-bin is located.
- Manually
Edit the install.pl script. Modify if needed the perl location in the
first line. Then change $pathcgi and $pathw3perl according to your system.
$pathcgi is the location where the scripts will be installed, default is
/path_to_your_cgi-bin/cgi-bin/w3perl/.
$pathw3perl is the directory where the package have been extracted :
/path_to_your_server_root/w3perl/
Run install.pl. If your cgi-bin is root owner, you'll have to run
the script as root.
1.4 - Configuration file
Use your favourite browser and go to http://localhost/w3perl/admin/ . You'll see the w3perl administration interface.
Select 'Make configuration file' and fill the different forms.
Use default config filename. If you get into trouble, you could also fill
the configuration file by hand. The configuration
file have to be copied (not moved !) into your /path_to_your_cgi-bin/cgi-bin/w3perl/ (because server owner can't write to
/cgi-bin/ due to security restriction)
1.5 - Compute stats
Now you're ready to compute your stats !
You can use the 'Launch scripts' in the administration interface and
click on the different scripts to launch them or use the command
line to run the scripts. It's up to you. Avoid using both launch as
web user and login user have different file access permission.
1.6 - Crontab
If everything is right, edit cron-w3perl.pl, choose when
you want to launch the different scripts and finally add it in
your crontab.
When launch with the -a flag, cron-w3perl will update all stats for you.