• Home
• About
  • Copyright
  • Contents
    • Main stats
    • Time stats
      • Hourly
      • Daily
      • Weeky
      • Monthly
      • Yearly
    • Optional stats
  • Glossary
  • Features
  • Download
• Package
  • Requirements
  • Whats new
  • Upgrading
  • Futur
  • Known bugs
  • Speed
• Configuration
  • Building
    • Admin
    • Manually
    • Online
  • Accuracy
  • Log Format
  • Log Filename
• Installation
  • Unix
    • Local
    • Provider
    • User
    • Webmaster
    • VHosts
    • RPM
    • Ubuntu/Debian
  • Windows
    • IIS
    • Apache
    • Abyss
    • No server
  • Mac
  • Plugin
  • Page tagging
  • Counter
• Support
  • FAQ
  • Hints
  • Forum
  • Mailing List
  • Bug report
• Ressources
  • Demo
    • Web
    • FTP
    • Squid
    • Mail
  • Others packages
  • Logfile tools
  • Reviews
  • Code size
  • History
  • Greetings

If you are running Ubuntu or Debian, this is the easy way to install the package. W3Perl have been built on Ubuntu (using alien to convert the rpm into debian package). It have been tested with Ubuntu 11.04 . You need to be logged as root.
Default location is :

• /var/www/ for webserver root
• /usr/lib/cgi-bin/ for cgi-bin and
• /var/log/apache2/ for logfiles

Default logfile format is ECLF.

The default configuration file is config-example-ubuntu.pl

* First Step : Requirement

You should have an Apache webserver running.

* 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/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.
- Also /w3perl/resources/admin/locconf and /w3perl/config/ should be writeable so chmod 666.

- 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 !

* 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.