========================================================================== INSTALL SHORT NOTICE ========================================================================== This document is just a short notice for installation and may be outdated. If you want a more detailed documentation, go to the /w3perl/docs/uk/ directory and use for browser to open the index file. Only HTML files are provided. 1) - SECURITY 2) - UPGRADE 3) - INSTALL A] cgi-bin and ssh B] no cgi-bin but ssh C] cgi-bin without ssh D] Windows users E] RPM F] Debian G] No server H] Advice 1) - SECURITY ============= Don't forget to password protect your admin directory with an htaccess file or anyone will be able to change your configuration file or run the stats for you. 2) - UPGRADE ============ Download the latest w3perl package and untar it over your current w3perl directory. Then just run the upgrade.pl script. Will read your upgrade.txt file, update your configuration files and copy the scripts into your cgi-bin directory. 3) - INSTALL ============ As w3perl need to read logfiles, it must be install on your server host (except if you can access logfiles disk from NFS of course). Note that logfiles can be retrieved remotely; w3perl is able to download them (wget) before processing allowing you to install w3perl on a separate host from the server. If so, logfiles should be available from an URL, hidden and password protected from the world. If not and still you want to process locally your stats, you can always download manually the logfiles on your own hosts and install w3perl locally. A] INSTALLATION FOR UNIX USER (cgi-bin and ssh) ----------------------------------------------- <webdir> is your server root directory <w3perldir> is the location where the w3perl package have been extracted 1) Extract the package inside your web server tree cd /<webdir>/htdocs/ tar -zxvf w3perl.tar.gz /<webdir>/htdocs/w3perl/ will be created (<w3perldir>) 2) Edit the install.pl script and setup three variables a) the first line is your Perl path b) $pathcgi is the directory where the w3perl script will be placed : /<webdir>/cgi-bin/w3perl c) $pathw3perl is the directory where the w3perl package have been extracted (the directory where you are are reading this file from) : <w3perldir> 3) Run install.pl 4) Launch web interface Use your browser and go to http://localhost/w3perl/admin/ Select 'Make configuration files' (use default 'config' for filename) Fill the different forms.. You will have to move the configuration file you have built from <w3perldir>/config/<configfile> to /<webdir>/cgi-bin/w3perl/<configfile> 5) Compute stats Run first cron-hour.pl either from command line or from the admin interface. (Use your browser and go to http://localhost/w3perl/admin/, Select 'Launch scripts', Click on 'Hour stats') If no error is reported, run the init script : cron-w3perl.pl -a which will compute everything foy you. ========================================================================== B] INSTALLATION FOR UNIX USER (ssh without cgi-bin) --------------------------------------------------- <webdir> is your server root directory <w3perldir> is the location where the w3perl package have been extracted 1) Extract the package inside your web server tree cd /<webdir>/htdocs/ tar -zxvf w3perl.tar.gz /<webdir>/htdocs/w3perl/ will be created (<w3perldir>) 2) Edit the install.pl script and setup three variables a) the first line is your Perl path b) $pathcgi is the directory where the w3perl script will be placed. As you don't have any cgi-bin directory, you should keep the current directory as the target : <w3perldir> c) $pathw3perl is the directory where the w3perl package have been extracted (the directory where you are are reading this file from) : <w3perldir> 3) Run install.pl 4) Configuration files User without cgi-bin access can't use the administration interface. You'll have to make your configuration files by yourself. cd <w3perldir>/config/ Inside you'll find some default configuration files, edit and modify it with your own values. If you have some problem, you can read the documentation or ask for help in the forum. 5) Compute stats Run first cron-hour.pl to check everything is ok. If no error is reported, run cron-w3perl.pl which will compute everything foy you. ========================================================================== C] INSTALLATION FOR UNIX USER (cgi-bin without ssh) --------------------------------------------------- <webdir> is your remote server root directory <local_w3perldir> is the location where the w3perl package have been extracted <w3perldir> is the remote directory where the w3perl package will be installed You'll have to use ftp to upload w3perl files. 1) Extract the package on your computer tar -zxvf w3perl.tar.gz <local_w3perldir> will be created 2) Install w3perl files a) Create a /w3perl/ subdirectory in your remote server FTP : cd /<webdir>/www/ or whatever your www directory is. FTP : mkdir w3perl ==> <w3perldir> b) Put files FTP : cd /<webdir>/www/w3perl FTP : mput admin/* FTP : mput config/* FTP : mput docs/* FTP : mput resources/* c) Permission FTP : chmod 777 config FTP : chmod 777 resources/admin 3) Edit install.pl a) the first line is your remote Perl path b) $pathcgi is the remote directory where the w3perl script will be placed : /<webdir>/cgi-bin/w3perl/ c) $pathw3perl is the remote directory where the w3perl package have been installed : <w3perldir> 4) Install w3perl scripts files a) Create a /w3perl/ subdirectory in your remote cgi-bin FTP : cd /<webdir>/cgi-bin/ FTP : mkdir w3perl b) Move all the scripts in this cgi-bin subdirectory FTP : mput *.pl /<webdir>/cgi-bin/w3perl/ FTP : mput *.sh /<webdir>/cgi-bin/w3perl/ FTP : mput cgi-bin/w3perl/* /<webdir>/cgi-bin/w3perl/ c) Executable Check all scripts are runnable. If not FTP : chmod +x *.pl FTP : chmod +x *.sh 5) Configure path Use your browser and go to http://localhost/w3perl/admin/ Select 'Launch scripts' Click on 'Customisation' The list of files modified will be show. 6) Launch web interface Go back Select 'Make configuration files' (use default 'config' for filename) Fill the different forms.. You will have to move the configuration file you have built from /<w3perldir>/config/<configfile> to /<webdir>/cgi-bin/w3perl/<configfile> -- -- ---- If the above failed ----- ---- Manual configuration ----- ---- (but best is to use admin interface) ----- -- -- Example available in <local_w3perldir>/config/config-unix.pl You will have to move it to <webdir>/cgi-bin/w3perl Use config.pl filename for default configuration file. 7) Compute stats Run first cron-hour.pl from the admin interface. (Use your browser and go to /w3perl/admin/, Select 'Launch scripts', Click on 'Hour stats') ========================================================================== D] Windows users ---------------- a) Just run the w3perl-iis.exe (IIS server) or w3perl.exe (no web server). b) Before using the administration interface, be sure that the following directories are writeable by the server : - /w3perl/ (if you want to launch stats via the admin interface) - /config/ - /resources/admin/ c) go to the w3perl admin section http://localhost/w3perl/admin/ d) Use the provided iis configuration file if you are running an IIS server. e) If Create a configuration file and move it to the /cgi-bin/w3perl directory ========================================================================== E] RPM ------ a) download the fly rpm and rpm -i fly-1.6.5-1mdk.i686.rpm as root b) download w3perl and rpm -i w3perl-2.99-2mdv.noarch.rpm as root c) go to the admin http://127.0.0.1/w3perl/admin/ and alter the 'mandriva' configuration file if needed d) run the stats either with the admin or using command lines ========================================================================== F] Debian --------- a) download the fly package and install it. b) download the w3perl debian package and dpkg -i w3perl_2.99_all.deb as root c) go to the admin http://127.0.0.1/w3perl/admin/ and alter the 'ubuntu' configuration file if needed. d) run the stats either with the admin or using command lines ========================================================================== H] Advice --------- a) Best is to use the admin interface to generate your configuration file and to launch the scripts via ssh b) First test with one small script : cron-hour.pl c) If everything is OK, run cron-pages.pl for initialisation or cron-w3perl.pl -a to compute everything.
distrib
>
Mandriva
>
2010.0
>
i586
>
media
>
contrib-release
>
by-pkgid
>
c2fdda073db5d43adba7225a9d9f1abe
>
files
>
3
