If you are running Ubuntu or Debian, this is the easy way to install the package.
It have been tested with Ubuntu 14.04 . You need to be logged as root.
Default location is :
|
Ubuntu / Debian |
Webserver |
/var/www/html/ (*) |
Cgi |
/usr/lib/cgi-bin/ |
Logfiles |
/var/log/apache2/ |
(*) Ubuntu 12.04 and previous use /var/www/ so upgrade to the latest one
or install manually
Default logfile format is ECLF.
The default configuration file is config-example-ubuntu.pl
* First Step : Requirement
You should have an Apache webserver running with cgi enable. Use
'a2enmod cgi' and then restart with 'service apache2 restart' as
default apache have cgi disabled.
Make sure your apache2.conf file contains :
ScriptAlias /cgi-bin/ /usr/lib/cgi-bin/
<Directory /var/www/votre_site/cgi-bin/>
Options ExecCGI
AddHandler cgi pl py
</Directory>
* 2nd Step : Install W3Perl
Just type :
dpkg -i w3perl_<version>.deb where <version> is the current release number.
Ressources files will be installed in /var/www/html/w3perl/ and scripts in /usr/lib/cgi-bin/w3perl/. Files Group/Owner are root.
If you need to remove the package, just use
dpkg -r w3perl_<version>.deb
* 3rd Step : Permission
Two directories shoud be writeable by the server if you want to use the administration interface :
- /w3perl/config/ and /w3perl/resources/admin/, so chmod 777 if not
or allow apache to write into.
- Also /w3perl/resources/admin/locconf and /w3perl/config/ should be
writeable so chmod 666 or allow apache to write in.
- Edit the admin/pass.txt file if your IP doesn't match 127.0.0.1 and add your local IP
* 4th Step : Configuration
W3Perl need a configuration file to run.
A default configuration file (config-example-ubuntu.pl) is provided so the scripts are ready to run. But some fields need
to be edited as your server domain name. Go to the administration interface (http://127.0.0.1/w3perl/admin/)
and use the config-example-ubuntu file as a template ('clone' option)
That's all !
If your browser want to save the perl scripts, you should enabled cgi in your apache configuration.
* 5th Step : Optional software
Geo-IPfree or Geo-IP perl module allow geographical mapping from IP
addresses. Install the libgeo-ip-perl and libgeoip1 using your package
manager.
If you can't install these packages, you can them download them and install them manually :
- Flydraw : generate GIF graphics (latest W3Perl version use a
javascript library)
- GeoIP : You need first to install the GeoIP C Library (configure, make, make install) then the Geo-IP perl module (perl Makefile.PL, make, make test, make install)
- Geo-IPfree : Same as GeoIP but free (perl Makefile.PL, make, make test, make install)
- HTMLDoc to allow PDF output
- Perl MIME::Lite module to allow report to be send by email
See the plug-in page to get more informations.