Menu

Provider installation

This manual have been written thanks to Lawrence Gray

HOW TO USE FTP TO SET UP THE W3PERL SCRIPT ON YOUR WEB SITE


- Note :

From W3Perl 2.98, you do not have to install W3Perl on your provider server if you have access to your logs from a web interface.
If so, just install W3Perl locally (W3Perl for Windows without a server is available) and activate in the configuration file the option to retrieve automatically your logfiles.
It is really easier to install W3Perl this way and it will save your provider CPU .. who will be very happy.

- 1st STAGE : Pre-requis

- Things to check :

  • First of all, do you have access to your log files ?
  • Do you know the path to your log files ?
  • Do you have cgi-bin rights ?

If the answer is yes, then you can use this script.

- The next things to know are the PATH to your account, the CGI PATH (location where you can upload cgi scripts), and the Perl PATH of your provider.
- If you do not know what the path are, ask your ISP. It's the most basic piece of information that you need for setting up CGI scripts.
- Now make two directories called w3perl in your web. Make one for your cgi-bin (W3Perl CGI PATH) and one for your root directory (W3Perl PATH).

- 2nd STAGE : Configure path

- Next you need the w3perl package. Download and unzip this on your own computer.
- Now open fixperlpath.pl in notepad or use the WSFTP edit function.
- Check your Perl path is right (first line)
- Set $pathcgi = "/www/yourpath/cgi-bin/w3perl"; (W3Perl CGI PATH) and $pathw3perl = "/www/yourpath/w3perl"; (W3Perl PATH)

- 3rd STAGE : Install the scripts

- What you have here may confuse you because various files are scattered through a number of directories, but essentially find all the .pl files in the collection and put them into your cgi-bin's w3perl directory (W3Perl CGI PATH).
- Here are the files that I use in my cgi-bin and I assume that if you have them then yours will also work:

  • cron-agent.pl
  • cron-day.pl
  • cron-error.pl
  • cron-hour.pl
  • cron.inc.pl
  • cron-month.pl
  • cron-pages.pl
  • cron-history.pl
  • cron-refer.pl
  • cron-session.pl
  • cron-url.pl
  • cron-w3perl.pl
  • cron-week.pl
  • fixerlpath.pl
  • install.pl
  • libw3perl.pl
  • confstat.pl
  • delconf.pl
  • runconf.pl
  • init.pl
  • pagegraph.pl
  • schedule.pl
  • check_modules.pl

- Upload them in ASCII not Binary mode.
- Set them all to CHMOD 755

- 4th STAGE : Install the resource files

- In the w3perl directory (W3Perl PATH) in your root directory load in the following directories:

  • admin
  • config
  • docs
  • resources
  • tools

With all their contents!
- Set /config/ and /resources/admin/ with CHMOD 777

- 5th STAGE : Graphic tool installation

- If you want a Graphical display of your statistics you need a programme called FLY
- Ask your ISP what Operation System they are using and then go to http://www.unimelb.edu.au/fly/fly.html
- Download the READY COMPILED BINARY for that operating system. If they do not have one for your particular operation system then you can try asking the people there or you can get hold of the SOURCE file and give it to your ISP and ask them to do you one.
- If you can get hold of a READY COMPILED BINARY all you need do is download the zipped package,
- Unzip and ignore everything in the package apart from one file called FLY.
- Place this in your cgi-bin and CHMOD it 775
- Remember where you put it because you will have to fill that in during the configuration process.
- If you cannot get hold of a copy, the programme will still work except you won't be able to see some nice histograms and pie charts.

- 6th STAGE : Build configuration file

- Now open up your browser and go to http://<localhost>/w3perl/admin where <localhost> is the server name where files have been uploaded.
- Click on Update scripts. If there is something wrong, check the paths you wrote in fixperlpath.pl (This should set all the paths in all the files).
- Then click on Make configuration files and follow the procedures outlined. By filling in the details you will create a file called config.pl
- Once created, look for this file in http://your_url/w3perl/config and copy it to the w3perl directory in your cgi-bin (if you have a warning message at the end of the process).
- CHMOD to 755

- 7th STAGE : Ready

- You should now be able to analyse your logs.
- Return to your browser. Go to admin and click on Launch scripts
- Select the cron-w3perl scripts to launch stats that will start your statistics from zero.
- Then run the incremental statistics function every week to accumulate your statistics.
- You should be aware you could get some timeout if the scripts take too long to compute .... providers can't allow scripts to run too long. If it happens, try to compute stats within a shorter number of days.