################################################################################ # # # "WEBALIZER Xtended" # # # ################################################################################ INSTALL Version: RB-15 Date : July 01, 2006 (3nd edition: July 17, 2006) Author : Patrick Frei Copyright (c) 2005-2006 Patrick Frei. All rights reserved. ================================================================================ INDEX 1. IMPORTANT NOTE ON UPGRADING FROM PRIOR VERSIONS 2. PREREQUISITES 3. INSTALLATION INSTRUCTIONS FOR PATCH ONLY 4. INSTALLATION INSTRUCTIONS FOR COMPLETE PATCHED SOURCE CODE 5. INSTALLATION INSTRUCTIONS FOR GENTOO USERS 6. INSTALLATION INSTRUCTIONS FOR DEBIAN USERS 7. INSTALLATION INSTRUCTIONS FOR DNS, LANGUAGE AND HTTP-404-ERROR SUPPORT 8. KNOWN ISSUES ================================================================================ 1. IMPORTANT NOTES ON UPGRADING FROM PRIOR VERSIONS a. Whenever you install Webalizer Xtended for the first time or upgrade the original Webalizer to Webalizer Xtended, you need to make sure that your system no longer has an old version of the webalizer.current data file installed! This file saves the previously stored data for the current month if you are using incremental mode. You can typically find the offending file in the same directory as the generated reports are located, e.g. in /usr/local/apache/htdocs/stat. To upgrade you can REMOVE or MODIFY that file: 1. If you REMOVE the webalizer.current data file, you will probably lose some previously cached data. That depends on your system configuration, e.g. if you are using logrotate, etc. 2. If you MODIFY your webalizer.current data file you won't lose any data. Proceed as described below: - Backup the original file by executing the following command: cp webalizer.current webalizer.current.orig - Execute the following command: sed "$ a\0\n\# -notfounderrors- \n\# End Of Table - notfounderrors" \ webalizer.current > webalizer.current.tmp - Execute the following command: mv webalizer.current.tmp webalizer.current Now go to section 3 or 4 of this manual to install Webalizer Xtended. If you don't get an error like "Error: Unable to restore run data (15)" after running Webalizer Xtended the upgrade was successful. b. No action has to be taken if you upgrade from an already patched Webalizer Xtended version to a new one, e.g. from Webalizer Xtended RB14 to RB15. c. If you'd like to profit from the browser / user agent grouping and already have an old Webalizer version installed, you first need the remove the old webalizer.conf for the changes to take effect. Don't forget to adjust the file to your previous configuration options. d. The 404 Not Found Errors will be unreliable of course if you start processing them e.g. at the end or in the middle of the month (i.e. if you are using incremental processing). ================================================================================ 2. PREREQUISITES Depending on your system you additionally need software packages to make Webalizer Xtended run successfully. Normally these necessary packages are called: - libpng - libpng-devel - gd - gd-devel - zlib - zlib-devel If you need DNS support or want to change the default language please refer to chapter 6. INSTALLATION INSTRUCTIONS FOR DNS, LANGUAGE AND 404 SUPPORT. DEBIAN users need the following packages instead of the above ones (installation via aptitude install): - libpng3 - libpng3-dev - libgd - libgd-dev - zlib1g - zlib1g-dev If you need DNS support or want to change the default language please refer to chapter 6. INSTALLATION INSTRUCTIONS FOR DNS, LANGUAGE AND 404 SUPPORT. ================================================================================ 3. INSTALLATION INSTRUCTIONS FOR PATCH ONLY a. Download the complete source distribution (tar/gzip-archive) of Webalizer Version 2.01-10 (webalizer-2.01-10-src.tgz) from http://www.webalizer.com/ into a directory on your server (e.g. /home/user/). b. Download the patch for Webalizer (webalizer-2.01-10-RB15-patch.tar.gz) from http://www.patrickfrei.ch/webalizer/ into the same directory where you have already saved the Webalizer source code (e.g. /home/user/). c. Extract the Webalizer source code (webalizer-2.01-10-src.tgz) and the Webalizer patch (webalizer-2.01-10-RB15-patch.tar.gz): tar -xvzf webalizer-2.01-10-src.tgz tar -xvzf webalizer-2.01-10-RB15-patch.tar.gz d. Change to the directory of Webalizer: cd webalizer-2.01-10/ e. Apply the Webalizer patch (webalizer-2.01-10-RB15-patch): patch -Np1 -i ../webalizer-2.01-10-RB15-patch f. Configure, compile and install the Webalizer (see 6. INSTALLATION INSTRUCTIONS FOR DNS, LANGUAGE AND 404 SUPPORT, too): ./configure make make install g. Adjust the configuration in /etc/webalizer.conf and run the Webalizer: /usr/local/bin/webalizer ================================================================================ 4. INSTALLATION INSTRUCTIONS FOR COMPLETE PATCHED SOURCE CODE a. Download the patched Webalizer version (webalizer-2.01-10-RB15-src.tar.gz) from http://www.patrickfrei.ch/webalizer/ into a directory on your server (e.g. /home/user/). b. Extract the patched source code (webalizer-2.01-10-RB15-src.tar.gz): tar -xvzf webalizer-2.01-10-RB15-src.tar.gz c. Change to the directory of the patched Webalizer version: cd webalizer-2.01-10-RB15/ d. Configure, compile and install the Webalizer (see 6. INSTALLATION INSTRUCTIONS FOR DNS, LANGUAGE AND 404 SUPPORT, too): ./configure make make install e. Adjust the configuration in /etc/webalizer.conf and run the Webalizer: /usr/local/bin/webalizer ================================================================================ 5. INSTALLATION INSTRUCTIONS FOR GENTOO USERS a. Download and unpack the webalizer-Xtended-XX.tar.bz2 archive (contains all webalizer ebuilds) to your portage overlay, which is specified as $PORTDIR_OVERLAY in /etc/make.conf. You will also need to execute the following command: echo "app-admin/webalizer-Xtended" >> /etc/portage/package.keywords b. 1] If you install the ebuild for the first time, execute: emerge -av webalizer-Xtended 2] If you upgrade from the original Webalizer to Webalizer Xtended, execute: emerge unmerge webalizer && emerge -av webalizer-Xtended c. Adjust the configuration in /etc/webalizer.conf and run the Webalizer: /usr/bin/webalizer or simply: webalizer ================================================================================ 6. INSTALLATION INSTRUCTIONS FOR DEBIAN USERS a. Download the webalizer-2.01-10-rbXX_RBXX-1_i386.deb package into a directory on your server (e.g. /home/user/). b. Install the package: dpkg --force-overwrite -i webalizer-2.01-10-rbXX_RBXX-1_i386.deb ================================================================================ 7. INSTALLATION INSTRUCTIONS FOR DNS, LANGUAGE AND HTTP-404-ERROR SUPPORT a. DNS: If you'd like to enable DNS support for the Webalizer you additionally need the following packages on your system: - db - db-devel - db40 - db40-devel DEBIAN users need the following packages instead of the above ones (installation via aptitude install): - libdb4.2 - libdb4.2-dev b. LANGUAGE: If you'd like to change the default language you need the following configuration directive: --with-language=language Use 'language' (default is english) Furthermore you have to configure Webalizer like this for using DNS support (you may also need to adjust the paths for db and dblib corresponding to your system). Execute the following command: ./configure --with-language=german --enable-dns \ --with-db=/usr/include/db40/ --with-dblib=/usr/lib/ Don't forget to adjust the configuration in /etc/webalizer.conf to enable the DNS feature (Directives: DNSCache and DNSChildren). c. 404 ERROR's: If you'd like to change the default value of 404 error entries in the 404 error monthly table you can change that value with the "CodeNotFound" keyword in /etc/webalizer.conf. Additionally all 404 errors can be display on a separate HTML page with the keyword "AllErrors" (please refer to the README of Webalizer Xtended for further information about the new configuration keywords). ================================================================================ 8. KNOWN ISSUES a. Note that Internet Explorer may rename Unix files to *.tar.tar while downloading. If so, rename them to *.tar.gz before extracting. b. DEBIAN SYSTEMS INSTALLATION: Some users reported a problem with "make install". You may have this problem if you see the following messages after executing "make install": /usr/bin/install -c webalizer /usr/local/bin/webalizer /usr/bin/install -c -m 644 webalizer.1 /usr/local/man/man1/webalizer.1 /usr/bin/install: cannot create regular file `/usr/local/man/man1/webalizer.1': No such file or directory make: *** [install] Error 1 To work around this, you have to create the following directories before executing "make install": mkdir /usr/local/man/man1/ mkdir /usr/local/man/man1/webalizer.1 c. If compiling fails due to a missing package or another problem, you should delete the whole folder "webalizer-2.01-10" and extract the tar.gz again. Otherwise even after installing a missing package you might get the same compiling problems again because the configure script keeps some old information stored in the "webalizer-2.01-10" folder (you can check that if you execute the configure command and each line will additionally show the comment "(cache)" at its end). d. If you receive "Error: Unable to restore run data (15)" go to section 1. IMPORTANT NOTES ON UPGRADING FROM PRIOR VERSIONS in this manual. e. Using gcc version 4 will show you a bunch of compiler warnings when compiling Webalizer with 'make'. You can safely ignore them. ================================================================================