If you have not used access logs before, you might need to enable them. From the web interface, look for "Web error logs" under the Preferences / Server Settings section. You can also enable access logs from the shell interface using:

  # Enable HTTP log file
  csoftadm> conf set logs yes
  
  # Enable HTTPS log file
  csoftadm> conf set ssl-acclog yes

We'll chose ~/www/logs/ as the target directory where the Webalizer output will be generated. Create the directory as needed, and make it accessible from the web by setting up a symbolic link from one of your domains. To make the Webalizer content accessible from, say, http://mydomain.ext/logs, you would do:

  $ mkdir ~/www/logs
  $ cd ~/www/mydomain.ext
  $ ln -s ~/www/logs

Note: You may wish to protect this area using passwords or some other authentication method. See the htaccess guide for details on how this is done.

Copy the sample Webalizer configuration file to the target directory:

  $ cd ~/www/logs
  $ cp /etc/webalizer.conf .

Open up webalizer.conf in your favorite text editor, and edit at least the following entries:

  # The path to your access log file (for shared web server users)
  LogFile /logs/myself/http
  
  # The path to your access log file (for Advanced/Corporate users)
  #LogFile /logs/myself/httpd
  
  # Where to place the generated documents.
  OutputDir /home/myself/www/logs
  
  # Name to use in the title
  HostName www.mydomain.ext
  # Use GeoIP for geolocation
  GeoIP yes

Now add an entry to your crontab to periodically update the statistics:

  $ crontab -e

If you are not familiar with the crontab utility, the previous command will start up your favorite text editor (which you can define by setting the $EDITOR environment variable). To create an entry, insert the line:

  @weekly (cd $HOME/www/logs && webalizer -Q)

To update the statistics right away, you can also run the command from your shell:

  $ (cd /logs/myself webalizer -q)

Logfile rotation may be enabled from csoftadm. The logs_rotate option accepts a comma-separated list of logfiles which should be rotated ("logs", "ssl-acclog", "errlog" or "ssl-errlog"). The logs_size setting specifies to rotate by size (specified in KB). Alternatively, the logs_when setting can be used to rotate by time interval. The maximum number of archived logs is specified by logs_count.

  # Rotate HTTP log file only
  csoftadm> conf set logs_rotate logs
  
  # Set limit to 100,000 KB
  csoftadm> conf set logs_size 100000
  
  # Set archived log file count
  csoftadm> conf set logs_count 4

• Home of webalizer