Stone Steps Inc.

Article ID: Q20050324-01

Q: How can I install Stone Steps Webalizer?

A:While we do not provide an installer, it is easy to install and configure Stone Steps Webalizer following the instructions below.

Windows

Create a directory where you intend to keep Stone Steps Webalizer files (e.g. c:\tools\webalizer) and extract the content of the webalizer_win.zip file into this directory.

Create a text file in the installation directory and paste the content of the sample configuration file shown in the article Q20041001-01 into this file. Replace all references to TrueType fonts in the configuration file (i.e. all paths that end in .ttf) to point to valid font files or remove these lines altogether if you would like to use the default raster fonts (note that in this case you will be able to generate reports using Latin characters only). Save the file as webalizer.conf.

In order to run Stone Steps Webalizer you need to know three directories - a) the installation directory (e.g. c:\tools\webalizer); b) the directory where web server log files are located (e.g. c:\winnt\system32\logfiles\w3svc1); c) the directory where you would like to keep generated report files (e.g. c:\inetpub\reports\). The sample command below shows how to process a single IIS log file (line breaks at <cont'd> are shown for display purposes only):

> c:\tools\webalizer\webalizer -F iis -n localhost         <cont'd>
        -o c:\inetpub\reports                              <cont'd>
           c:\winnt\system32\logfiles\w3svc\ex050301.log

The -F option specifies the log file type. The -n option specifies the domain name of your website. The -o option specifies the directory where Stone Steps Webalizer will generate reports.

Linux

Create a directory where you intend to keep Stone Steps Webalizer files (e.g. /usr/local/webalizer) and run the commands shown below to extract the files.

$ sudo cd /usr/local/webalizer
$ sudo gunzip webalizer_linux.gz
$ sudo tar -xvf webalizer_linux.tar

Create a text file in the installation directory and paste the content of the sample configuration file shown in the article Q20041001-01 into this file. Replace all occurrences of c:/tools/webalizer with /usr/local/webalizer. Replace all references to TrueType fonts in the configuration file (i.e. all paths that end in .ttf) to point to valid font files. If you don't have TrueType fonts installed on your machine, remove these lines altogether (note that in this case you will be able to generate reports using Latin characters only). Save the file as webalizer.conf.

Run the following command in order to verify if all library references in the Stone Steps Webalizer executable file are resolved properly on your machine:

$ sudo ldd /usr/local/webalizer/webalizer

If you see not found in the output, then you cannot run Stone Steps Webalizer until you resolve these references. In this case, add the installation path into the library search path:

$ LD_LIBRARY_PATH=/usr/local/webalizer/:$LD_LIBRARY_PATH
$ export LD_LIBRARY_PATH

Run ldd again to verify that all references have been successfully resolved.

If you configured Apache to output custom log files, see the article Q20041208-01 for more information on how to set up Stone Steps Webalizer to process custom logs.

In order to run Stone Steps Webalizer you need to know three directories - a) the installation directory (e.g. /usr/local/webalizer); b) the directory where web server log files are located (e.g. /usr/local/apache2/logs); c) the directory where you would like to keep generated report files (e.g. /usr/local/apache2/reports). The sample command below shows how to process a single Apache log file (line breaks at <cont'd> are shown for display purposes only):

$ /usr/local/webalizer/webalizer -F apache -n localhost    <cont'd>
        -o /usr/local/apache2/reports                      <cont'd>
           /usr/local/apache2/logs/access_log

The -F option specifies the log file type. The -n option specifies the domain name of your website. The -o option specifies the directory where Stone Steps Webalizer will generate reports.

Source

See the article Q20040929-02 for more information on how to build Stone Steps Webalizer from the source.