################################################################################ # # # "WEBALIZER-Xtended" # # # ################################################################################ INSTALL Version: RB-03 Date : September 21, 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. SPECIAL INSTALLATION INSTRUCTIONS FOR DNS AND LANGUAGE SUPPORT 6. KNOWN ISSUES ================================================================================ 1. IMPORTANT NOTE ON INSTALLING OR UPGRADING FROM PRIOR VERSIONS 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). ================================================================================ 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 DEBIAN users need the following packages instead of the above ones (installation via aptitude install): - libpng3 - libpng3-dev - libgd - libgd-dev - zlib1g - zlib1g-dev ================================================================================ 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-RB03-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-RB03-patch.tar.gz): tar -xvzf webalizer-2.01-10-src.tgz tar -xvzf webalizer-2.01-10-RB03-patch.tar.gz d. Change to the directory of Webalizer: cd webalizer-2.01-10/ e. Apply the Webalizer patch (webalizer-2.01-10-RB03-patch): patch -Np1 -i ../webalizer-2.01-10-RB03-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-RB03-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-RB03-src.tar.gz): tar -xvzf webalizer-2.01-10-RB03-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. SPECIAL INSTALLATION INSTRUCTIONS FOR DNS AND LANGUAGE SUPPORT If you'd like to - change the language and/or - enable DNS for the Webalizer, you additionally need the following packages on your system: - db - db-devel AND / OR - db40 - db40-devel DEBIAN users need the following packages instead of the above ones (installation via aptitude install): - libdb4.2 - libdb4.2-dev Furthermore you have to configure Webalizer like this (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. ================================================================================ 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-r11.ebuild digest and compile it with: USE="trace404" 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 by executing the configure command and each line additionally shows 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). ================================================================================