################################################################################ # # # "WEBALIZER Xtended" # # # ################################################################################ INSTALL Version: RB-07 Date : December 13, 2005 Author : Patrick Frei Copyright (c) 2005 Patrick Frei. All rights reserved. ================================================================================ INDEX 1. IMPORTANT NOTE ON INSTALLING OR UPGRADING FROM PRIOR VERSIONS 2. PREREQUISITES 3. INSTALLATION INSTRUCTIONS FOR PATCH ONLY 4. INSTALLATION INSTRUCTIONS FOR COMPLETE PATCHED SOURCE CODE 5. INSTALLATION INSTRUCTIONS FOR DNS, LANGUAGE AND 404 SUPPORT 6. KNOWN ISSUES ================================================================================ 1. IMPORTANT NOTES ON INSTALLING OR UPGRADING FROM PRIOR VERSIONS a. Whenever you install Webalizer Xtended for the first time or upgrade the original Webalizer software, you need to make sure that your system no longer has older versions of the following files: - webalizer.current - webalizer.hist Keeping one or both of these files on your system can cause corruption of the internally stored Webalizer data or can result in unreliable statistical output. If you see problems about processing the logfile, chances are good you have one or more old files someplace. You can typically find the offending files in the same directory as the generated reports are located, e.g. in /usr/local/apache/htdocs/stat. b. No action has to be taken when upgrading from an already patched Webalizer version to a new Webalizer Xtended version, e.g. from Webalizer Xtended RB06 to RB07. ================================================================================ 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 5. INSTALLATION INSTRUCTIONS FOR DNS AND LANGUAGE 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 5. INSTALLATION INSTRUCTIONS FOR DNS AND LANGUAGE 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-RB07-patch.tar.gz) from http://www.webalizer.go.to/ 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-RB07-patch.tar.gz): tar -xvzf webalizer-2.01-10-src.tgz tar -xvzf webalizer-2.01-10-RB07-patch.tar.gz d. Change to the directory of Webalizer: cd webalizer-2.01-10/ e. Apply the Webalizer patch (webalizer-2.01-10-RB07-patch): patch -Np1 -i ../webalizer-2.01-10-RB07-patch f. Configure, compile and install the Webalizer (see 5. INSTALLATION INSTRUCTIONS FOR DNS AND LANGUAGE 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-RB07-src.tar.gz) from http://www.webalizer.go.to/ into into a directory on your server (e.g. /home/user/). b. Extract the patched source code (webalizer-2.01-10-RB07-src.tar.gz): tar -xvzf webalizer-2.01-10-RB07-src.tar.gz c. Change to the directory of the patched Webalizer version: cd webalizer-2.01-10/ d. Configure, compile and install the Webalizer (see 5. INSTALLATION INSTRUCTIONS FOR DNS AND LANGUAGE 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 DNS, LANGUAGE AND 404 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): ./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" directive in /etc/webalizer.conf: The 404 error table may be disabled by using zero (0) for the value. Using one (1) for the value shows all 404 errors in the table. A value of greater than 1 shows the number of entries in the table according to that value. ================================================================================ 6. 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: Some users reported a problem with "make install". You may have this problem if you see the following 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. GENTOO SYSTEMS: The "ebuild" has to be copied into "portdir-overlay" of "app-admin/webalizer". Then execute: ebuild webalizer-2.01.10-r15.ebuild digest and compile it with: USE="trace404" emerge =app-admin/webalizer-2.01.10-r15 d. 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. Whenever you install Webalizer Xtended for the first time or upgrade the software, you need to make sure that your system no longer has older versions of the files "webalizer.current" and "webalizer.hist". That can cause corruption of the internal stored data. If you see problems about processing the logfile, chances are good you have an old file someplace. You can typically find the offending files in the same directory as the generated reports are located (e.g. /usr/local/apache/htdocs/stat). e. Using gcc version 4 will show you a bunch of compiler warnings when compiling Webalizer with 'make'. You can safely ignore them. ================================================================================