From: eldy <> Date: Sat, 8 Nov 2003 21:52:24 +0000 (+0000) Subject: Better setup error messages to help newbies. X-Git-Tag: AWSTATS_6_0_BETA~149 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=d608439ec2c24cbf20ae199d5c5ac13f5c446f24;p=thirdparty%2FAWStats.git Better setup error messages to help newbies. --- diff --git a/wwwroot/cgi-bin/awstats.model.conf b/wwwroot/cgi-bin/awstats.model.conf index d9f9053b..5e8a2142 100644 --- a/wwwroot/cgi-bin/awstats.model.conf +++ b/wwwroot/cgi-bin/awstats.model.conf @@ -1,702 +1,702 @@ -# AWSTATS CONFIGURE FILE 6.0 -#----------------------------------------------------------------------------- -# Copy this file into awstats.www.mydomain.conf and edit this new config file -# to setup AWStats (See documentation in docs/ directory). -# The config file must be in /etc/awstats, /etc/opt/awstats or /etc (for -# Unix/Linux) or same directory than awstats.pl (Windows, Mac, Unix/Linux...) -# To include an environment variable in any parameter (AWStats will replace -# it with its value when reading it), follow the example: -# Parameter="__ENVNAME__" -# Note that environment variable AWSTATS_CURRENT_CONFIG is always defined with -# the config value in an AWStats running session and can be used like others. -#----------------------------------------------------------------------------- -# $Revision$ - $Author$ - $Date$ - - - -#----------------------------------------------------------------------------- -# MAIN SETUP SECTION (Required to make AWStats work) -#----------------------------------------------------------------------------- - -# "LogFile" contains the web server log file to analyze. -# Possible values: A full path, or a relative path from awstats.pl directory. -# Example: "/var/log/apache/access.log" -# Example: "../logs/mycombinedlog.log" -# You can also use tags in this filename if you need a dynamic file name -# depending on date or time (Replacement is made by AWStats at the beginning -# of its execution). This is available tags : -# %YYYY-n is replaced with 4 digits year we were n hours ago -# %YY-n is replaced with 2 digits year we were n hours ago -# %MM-n is replaced with 2 digits month we were n hours ago -# %MO-n is replaced with 3 letters month we were n hours ago -# %DD-n is replaced with day we were n hours ago -# %HH-n is replaced with hour we were n hours ago -# %NS-n is replaced with number of seconds at 00:00 since 1970 -# %WM-n is replaced with the week number in month (1-5) -# %Wm-n is replaced with the week number in month (0-4) -# %WY-n is replaced with the week number in year (01-52) -# %Wy-n is replaced with the week number in year (00-51) -# %DW-n is replaced with the day number in week (1-7, 1=sunday) -# use n=24 if you need (1-7, 1=monday) -# %Dw-n is replaced with the day number in week (0-6, 0=sunday) -# use n=24 if you need (0-6, 0=monday) -# Use 0 for n if you need current year, month, day, hour... -# Example: "/var/log/access_log.%YYYY-0%MM-0%DD-0.log" -# Example: "C:/WINNT/system32/LogFiles/W3SVC1/ex%YY-24%MM-24%DD-24.log" -# You can also use a pipe if log file come from a pipe : -# Example: "gzip -d outputpath/output.html"), enter -# path of icon directory relative to the directory outputpath. -# Example: "/icon" -# Example: "../icon" -# Default: "/icon" (means you must copy icon directories in "/mywwwroot/icon") -# -DirIcons="/icon" - - -# When this parameter is set to 1, AWStats add a button on report page to -# allow to "update" statistics from a web browser. Warning, when "update" is -# made from a browser, AWStats is ran as a CGI by the web server user defined -# in your web server (user "nobody" by default with Apache, "IUSR_XXX" with -# IIS), so the "DirData" directory and all already existing history files -# awstatsMMYYYY[.xxx].txt must be writable by this user. Change permissions if -# necessary to "Read/Write" (and "Modify" for Windows NTFS file systems). -# Warning: Update process can be long so you might experience "time out" -# browser errors if you don't launch AWStats enough frequently. -# When set to 0, update is only made when AWStats is ran from the command -# line interface (or a task scheduler). -# Possible values: 0 or 1 -# Default: 0 -# -AllowToUpdateStatsFromBrowser=0 - - -# AWStats save and sort its database on a month basis, this allows to build -# build a report quickly. However, if you choose the -month=all from command -# line or value '-Year-' from CGI combo form to have a report for all year, -# AWStats needs to reload all data for full year, and resort them completely, -# requiring a large amount of time, memory and CPU. This might be a problem -# for web hosting providers that offer AWStats for large sites, on shared -# servers, to non CPU cautious customers. -# For this reason, the 'full year' is only enabled on Command Line by default. -# You can change this by setting this parameter to 0, 1 (recommanded), 2 or 3. -# Possible values: -# 0 - Never allowed -# 1 - Allowed on CLI only, -Year- value in combo is not visible -# 2 - Allowed on CLI only, -Year- value in combo is visible but not allowed -# 3 - Possible on CLI and CGI -# Default: 2 -# -AllowFullYearView=2 - - - -#----------------------------------------------------------------------------- -# OPTIONAL SETUP SECTION (Not required but increase AWStats features) -#----------------------------------------------------------------------------- - -# When the update process run, AWStats can set a lock file in TEMP or TMP -# directory. This lock is to avoid to have 2 update processes running at the -# same time to prevent unknown conflicts problems and avoid DoS attacks when -# AllowToUpdateStatsFromBrowser is set to 1. -# Because, when you use lock file, you can experience sometimes problems in -# lock file not correctly removed (when process is killed for example, this -# requires that you remove the file manualy), this option is not enabled by -# default (Do not enable this option with no consol server access). -# Change : Effective immediatly -# Possible values: 0 or 1 -# Default: 0 -# -EnableLockForUpdate=0 - - -# AWStats can do reverse DNS lookups through a static DNS cache file that was -# previously created manually. If no path is given in static DNS cache file -# name, AWStats will search DirData directory. This file is never changed. -# This option is not used if DNSLookup=0. -# Note: DNS cache file format is 'minsince1970 ipaddress resolved_hostname' -# or just 'ipaddress resolved_hostname' -# Change : Effective for new updates only -# Example: "/mydnscachedir/dnscache" -# Default: "dnscache.txt" -# -DNSStaticCacheFile="dnscache.txt" - - -# AWStats can do reverse DNS lookups through a DNS cache file that was created -# by a previous run of AWStats. This file is erased and recreated after each -# statistics update process. You don't need to create and/or edit it. -# AWStats will read and save this file in DirData directory. -# This option is used only if DNSLookup=1. -# Note: If a DNSStaticCacheFile is available, AWStats will check for DNS -# lookup in DNSLastUpdateCacheFile after checking into DNSStaticCacheFile. -# Change : Effective for new updates only -# Example: "/mydnscachedir/dnscachelastupdate" -# Default: "dnscachelastupdate.txt" -# -DNSLastUpdateCacheFile="dnscachelastupdate.txt" - - -# You can specify specific IP addresses that should NOT be looked up in DNS. -# This option is used only if DNSLookup=1. -# Note: Use space between each value. -# Note: You can use regular expression values writing value with REGEX[value]. -# Change : Effective for new updates only -# Example: "123.123.123.123 REGEX[^192\.168\.]" -# Default: "" -# -SkipDNSLookupFor="" - - -# The following two parameters allow you to protect a config file from being -# read by AWStats when called from a browser if web user has not been -# authenticated. Your AWStats program must be in a web protected "realm" (With -# Apache, you can use .htaccess files to do so. With other web servers, see -# your server setup manual). -# Change : Effective immediatly -# Possible values: 0 or 1 -# Default: 0 -# -AllowAccessFromWebToAuthenticatedUsersOnly=0 - - -# This parameter give the list of all authorized authenticated users to view -# statistics for this domain/config file. This parameter is used only if -# AllowAccessFromWebToAuthenticatedUsersOnly is set to 1. -# Change : Effective immediatly -# Example: "user1 user2" -# Example: "__REMOTE_USER__" -# Default: "" -# -AllowAccessFromWebToFollowingAuthenticatedUsers="" - - -# When this parameter is define to something, the IP address of the user that -# read its statistics from a browser (when AWStats is used as a CGI) is -# checked and must match the IP address range defined by this parameter. -# Change : Effective immediatly -# Example: "123.123.123.10-123.123.123.255" -# Default: "" -# -AllowAccessFromWebToFollowingIPAddresses="" - - -# If the "DirData" directory (see above) does not exists, AWStats return an -# error. However, you can ask AWStats to create it. -# This option can be used by some Web Hosting Providers that has defined a -# dynamic value for DirData (for example DirData="/home/__REMOTE_USER__") and -# don't want to have to create a new directory each time they add a new user. -# Change : Effective immediatly -# Possible values: 0 or 1 -# Default: 0 -# -CreateDirDataIfNotExists=0 - - -# In most case, AWStats is used as a cgi program. So AWStats process is ran -# by default web server user (nobody for Unix, IUSR_xxx for IIS/Windows,...). -# To make use easier and avoid permission's problems between update process -# (run by an admin user) and CGI process (ran by a low level user), AWStats -# save its database files with read and write for everyone. -# If you have experience on managing security policies (Web Hosting Provider), -# you should set this parameter to 0. AWStats will keep default process user -# permissions on its files. -# Change : Effective for new updates only -# Possible values: 0 or 1 -# Default: 1 -# -SaveDatabaseFilesWithPermissionsForEveryone=1 - - -# AWStats can purge log after processing it. By this way, the next time you -# launch AWStats, log file will be smaller and processing time will be better. -# IMPORTANT !!! -# AWStats is able to detect new lines in log file, to process only them, so -# you can launch AWStats as soon as you want, even with this parameter to 0. -# With 0, no purge is made, so you must use a scheduled task or a web server -# that make this purge frequently. -# With 1, the purge of the log file is made each time AWStats update is ran. -# This parameter doesn't work with IIS (This web server doesn't let its log -# file to be purged). -# Change : Effective for new updates only -# Possible values: 0 or 1 -# Default: 0 -# -PurgeLogFile=0 - - -# When PurgeLogFile is setup to 1, AWStats will clean your log file after -# processing it. You can however keep an archive file (saved in "DirData") of -# all processed log records by setting this to 1 (For example if you want to -# use another log analyzer). -# This parameter is not used if PurgeLogFile=0 -# Change : Effective for new updates only -# Possible values: 0 or 1 -# Default: 0 -# -ArchiveLogRecords=0 - - -# Each time you run the update process, AWStats overwrite the 'historic file' -# for the month (awstatsMMYYYY[.*].txt) with the updated one. -# When write errors occurs (IO, disk full,...), this historic file can be -# corrupted and must be deleted. Because this file contains information of all -# past processed log files, you will loose old stats if removed. So you can -# ask AWStats to save last non corrupted file in a .bak file. This file is -# stored in "DirData" directory with other 'historic files'. -# Change : Effective for new updates only -# Possible values: 0 or 1 -# Default: 0 -# -KeepBackupOfHistoricFiles=0 - - -# Default index page name for your web server. -# Change : Effective for new updates only -# Example: "index.php index.html default.html" -# Default: "index.html" -# -DefaultFile="index.html" - - -# Do not include access from clients that match following criteria. -# If your log file contains IP adresses in host field, you must enter here -# matching IP adresses criteria. -# If DNS lookup is already done in your log file, you must enter here hostname -# criteria, else enter ip address criteria. -# The opposite parameter of "SkipHosts" is "OnlyHosts". -# Note: Use space between each value. This parameter is not case sensitive. -# Note: You can use regular expression values writing value with REGEX[value]. -# Change : Effective for new updates only -# Example: "127.0.0.1 REGEX[^192\.168\.] REGEX[^10\.]" -# Example: "localhost REGEX[^.*\.localdomain$]" -# Default: "" -# -SkipHosts="" - - -# Do not include access from clients with a user agent that match following -# criteria. If you want to exclude a robot, you should update the robots.pm -# file instead of this parameter. -# The opposite parameter of "SkipUserAgents" is "OnlyUserAgents". -# Note: Use space between each value. This parameter is not case sensitive. -# Note: You can use regular expression values writing value with REGEX[value]. -# Change : Effective for new updates only -# Example: "konqueror REGEX[ua_test_v\d\.\d]" -# Default: "" -# -SkipUserAgents="" - - -# Use SkipFiles to ignore access to URLs that match one of following entries. -# You can enter a list of not important URLs (like framed menus, hidden pages, -# etc...) to exclude them from statistics. You must enter here exact relative -# URL as found in log file, or a matching REGEX value. -# For example, to ignore /badpage.html, just add "/badpage.html". To ignore -# all pages in a particular directory, add "REGEX[^\/directorytoexclude]". -# The opposite parameter of "SkipFiles" is "OnlyFiles". -# Note: Use space between each value. This parameter is not case sensitive. -# Note: You can use regular expression values writing value with REGEX[value]. -# Change : Effective for new updates only -# Example: "/badpage.html REGEX[^\/excludedirectory]" -# Default: "" -# -SkipFiles="" - - -# Include in stats, only accesses from hosts that match one of following -# entries. For example, if you want AWStats to filter access to keep only -# stats for visits from particular hosts, you can add those hosts names in -# this parameter. -# If DNS lookup is already done in your log file, you must enter here hostname -# criteria, else enter ip address criteria. -# The opposite parameter of "OnlyHosts" is "SkipHosts". -# Note: Use space between each value. This parameter is not case sensitive. -# Note: You can use regular expression values writing value with REGEX[value]. -# Change : Effective for new updates only -# Example: "127.0.0.1 REGEX[^192\.168\.] REGEX[^10\.]" -# Default: "" -# -OnlyHosts="" - - -# Include in stats, only accesses from user agent that match one of following -# entries. For example, if you want AWStats to filter access to keep only -# stats for visits from particular browsers, you can add their user agents -# string in this parameter. -# The opposite parameter of "OnlyUserAgents" is "SkipUserAgents". -# Note: Use space between each value. This parameter is not case sensitive. -# Note: You can use regular expression values writing value with REGEX[value]. -# Change : Effective for new updates only -# Example: "msie" -# Default: "" -# -OnlyUserAgents="" - - -# Include in stats, only accesses to URLs that match one of following entries. -# For example, if you want AWStats to filter access to keep only stats that -# match a particular string, like a particular directory, you can add this -# directory name in this parameter. -# The opposite parameter of "OnlyFiles" is "SkipFiles". -# Note: Use space between each value. This parameter is not case sensitive. -# Note: You can use regular expression values writing value with REGEX[value]. -# Change : Effective for new updates only -# Example: "REGEX[marketing_directory] REGEX[office\/.*\.(csv|sxw)$]" -# Default: "" -# -OnlyFiles="" - - -# Add here a list of kind of url (file extension) that must be counted as -# "Hit only" and not as a "Hit" and "Page/Download". You can set here all -# images extensions as they are hit downloaded that must be counted but they -# are not viewed pages. URLs with such extensions are not included in the TOP -# Pages/URL report. -# Note: If you want to exclude particular URLs from stats (No Pages and no -# Hits reported), you must use SkipFiles parameter. -# Change : Effective for new updates only -# Example: "css js class gif jpg jpeg png bmp ico zip arj gz z wav mp3 wma mpg" -# Example: "" -# Default: "css js class gif jpg jpeg png bmp ico" -# -NotPageList="css js class gif jpg jpeg png bmp ico" - - -# By default, AWStats considers that records found in web log file are -# successful hits if HTTP code returned by server is a valid HTTP code (200 -# and 304). Any other code are reported in HTTP status chart. -# Note that HTTP 'control codes', like redirection (302, 305) are not added by -# default in this list as they are not pages seen by a visitor but are -# protocol exchange codes to tell the browser to ask another page. Because -# this other page will be counted and seen with a 200 or 304 code, if you -# add such codes, you will have 2 pages viewed reported for only one in facts. -# Change : Effective for new updates only -# Example: "200 304 302 305" -# Default: "200 304" -# -ValidHTTPCodes="200 304" - - -# By default, AWStats considers that records found in mail log file are -# successful mail transfers if field that represent return code in analyzed -# log file match values defined by this parameter. -# Change : Effective for new updates only -# Example: "1 250 200" -# Default: "1 250" -# -ValidSMTPCodes="1 250" - - -# Some web servers on some Operating systems (IIS-Windows) considers that a -# login with same value but different case are the same login. To tell AWStats -# to also considers them as one, set this parameter to 1. -# Change : Effective for new updates only -# Possible values: 0 or 1 -# Default: 0 -# -AuthenticatedUsersNotCaseSensitive=0 - - -# Some web servers on some Operating systems (IIS-Windows) considers that two -# URLs with same value but different case are the same URL. To tell AWStats to -# also considers them as one, set this parameter to 1. -# Change : Effective for new updates only -# Possible values: 0 or 1 -# Default: 0 -# -URLNotCaseSensitive=0 - - -# Keep or remove the anchor string you can find in some URLs. -# Change : Effective for new updates only -# Possible values: 0 or 1 -# Default: 0 -# -URLWithAnchor=0 - - -# In URL links, "?" char is used to add parameter's list in URLs. Syntax is: -# /mypage.html?param1=value1 -# However, some servers/sites have also others chars to isolate dynamic part of -# their URLs. You can complete this list with all such characters. -# Change : Effective for new updates only -# Example: "?;," -# Default: "?;" -# -URLQuerySeparators="?;" - - -# Keep or remove the query string to the URL in the statistics for individual -# pages. This is primarily used to differentiate between the URLs of dynamic -# pages. If set to 1, mypage.html?id=x and mypage.html?id=y are counted as two -# different pages. -# Warning, when set to 1, memory required to run AWStats is dramatically -# increased if you have a lot of changing URLs (for example URLs with a random -# id inside). Such web sites should not set this option to 1 or use seriously -# the next parameter URLWithQueryWithoutFollowingParameters. -# Change : Effective for new updates only -# Possible values: -# 0 - URLs are cleaned from the query string (ie: "/mypage.html") -# 1 - Full URL with query string is used (ie: "/mypage.html?p=x&q=y") -# Default: 0 -# -URLWithQuery=0 - - -# When URLWithQuery is on, you will get the full URL with all parameters in -# URL reports. But among thoose parameters, sometimes you don't need a -# particular parameter because it does not identify the page or because it's -# a random ID changing for each access even if URL points to same page. In -# such cases, it is higly recommanded to ask AWStats to remove such parameters -# from the URL before counting, manipulating and storing it. Enter here list -# of all non wanted parameters. For example if you enter "id", one hit on -# /mypage.cgi?p=abc&id=Yo4UomP9d and /mypage.cgi?p=abc&id=Mu8fdxl3r -# will be reported as 2 hits on /mypage.cgi?p=abc -# This parameter is not used when URLWithQuery is 0. -# Change : Effective for new updates only -# Example: "PHPSESSID jsessionid" -# Default: "" -# -URLWithQueryWithoutFollowingParameters="" - - -# Keep or remove the query string to the referrer URL in the statistics for -# external referrer pages. This is used to differentiate between the URLs of -# dynamic referrer pages. If set to 1, mypage.html?id=x and mypage.html?id=y -# are counted as two different referrer pages. -# Change : Effective for new updates only -# Possible values: -# 0 - Referrer URLs are cleaned from the query string (ie: "/mypage.html") -# 1 - Full URL with query string is used (ie: "/mypage.html?p=x&q=y") -# Default: 0 -# -URLReferrerWithQuery=0 - - -# AWStats can detect setup problems or show you important informations to have -# a better use. Keep this to 1, except if AWStats says you can change it. -# Change : Effective immediatly -# Possible values: 0 or 1 -# Default: 1 -# -WarningMessages=1 - - -# When an error occurs, AWStats output a message related to errors. If you -# want (in most cases for security reasons) to have no error messages, you -# can set this parameter to your personalized generic message. -# Change : Effective immediatly -# Example: "An error occured. Contact your Administrator" -# Default: "" -# -ErrorMessages="" - - -# AWStat can be run with debug=x parameter to ouput various informations -# to help in debugging or solving troubles. If you want (in most cases for -# security reasons) to disable debugging, set this parameter to 0. -# Change : Effective immediatly -# Possible values: 0 or 1 -# Default: 1 -# -DebugMessages=1 - - -# To help you to detect if your log format is good, AWStats report an error -# if all the first NbOfLinesForCorruptedLog lines have a format that does not -# match the LogFormat parameter. -# However, some worm virus attack on your web server can result in a very high -# number of corrupted lines in your log. So if you experience awstats stop -# because of bad virus records at the beginning of your log file, you can -# increase this parameter (very rare). -# Change : Effective for new updates only -# Default: 50 -# -NbOfLinesForCorruptedLog=50 - - -# For some particular integration needs, you may want to have CGI links to -# point to another script than awstats.pl. -# Use the name of this script in WrapperScript parameter. -# Change : Effective immediatly -# Example: "awstatslauncher.pl" -# Default: "" -# -WrapperScript="" - - -# DecodeUA must be set to 1 if you use Roxen web server. This server converts -# all spaces in user agent field into %20. This make the AWStats robots, os -# and browsers detection fail in some cases. Just change it to 1 if and only -# if your web server is Roxen. -# Change : Effective for new updates only -# Possible values: 0 or 1 -# Default: 0 -# -DecodeUA=0 - - -# MiscTrackerUrl can be used to make AWStats able to detect some miscellanous -# things, that can not be tracked on other way like: +# AWSTATS CONFIGURE FILE 6.0 +#----------------------------------------------------------------------------- +# Copy this file into awstats.www.mydomain.conf and edit this new config file +# to setup AWStats (See documentation in docs/ directory). +# The config file must be in /etc/awstats, /usr/local/etc/awstats or /etc (for +# Unix/Linux) or same directory than awstats.pl (Windows, Mac, Unix/Linux...) +# To include an environment variable in any parameter (AWStats will replace +# it with its value when reading it), follow the example: +# Parameter="__ENVNAME__" +# Note that environment variable AWSTATS_CURRENT_CONFIG is always defined with +# the config value in an AWStats running session and can be used like others. +#----------------------------------------------------------------------------- +# $Revision$ - $Author$ - $Date$ + + + +#----------------------------------------------------------------------------- +# MAIN SETUP SECTION (Required to make AWStats work) +#----------------------------------------------------------------------------- + +# "LogFile" contains the web server log file to analyze. +# Possible values: A full path, or a relative path from awstats.pl directory. +# Example: "/var/log/apache/access.log" +# Example: "../logs/mycombinedlog.log" +# You can also use tags in this filename if you need a dynamic file name +# depending on date or time (Replacement is made by AWStats at the beginning +# of its execution). This is available tags : +# %YYYY-n is replaced with 4 digits year we were n hours ago +# %YY-n is replaced with 2 digits year we were n hours ago +# %MM-n is replaced with 2 digits month we were n hours ago +# %MO-n is replaced with 3 letters month we were n hours ago +# %DD-n is replaced with day we were n hours ago +# %HH-n is replaced with hour we were n hours ago +# %NS-n is replaced with number of seconds at 00:00 since 1970 +# %WM-n is replaced with the week number in month (1-5) +# %Wm-n is replaced with the week number in month (0-4) +# %WY-n is replaced with the week number in year (01-52) +# %Wy-n is replaced with the week number in year (00-51) +# %DW-n is replaced with the day number in week (1-7, 1=sunday) +# use n=24 if you need (1-7, 1=monday) +# %Dw-n is replaced with the day number in week (0-6, 0=sunday) +# use n=24 if you need (0-6, 0=monday) +# Use 0 for n if you need current year, month, day, hour... +# Example: "/var/log/access_log.%YYYY-0%MM-0%DD-0.log" +# Example: "C:/WINNT/system32/LogFiles/W3SVC1/ex%YY-24%MM-24%DD-24.log" +# You can also use a pipe if log file come from a pipe : +# Example: "gzip -d outputpath/output.html"), enter +# path of icon directory relative to the output directory 'outputpath'. +# Example: "/awstatsicon" +# Example: "../icon" +# Default: "/icon" (means you must copy icon directories in "/mywwwroot/icon") +# +DirIcons="/icon" + + +# When this parameter is set to 1, AWStats add a button on report page to +# allow to "update" statistics from a web browser. Warning, when "update" is +# made from a browser, AWStats is ran as a CGI by the web server user defined +# in your web server (user "nobody" by default with Apache, "IUSR_XXX" with +# IIS), so the "DirData" directory and all already existing history files +# awstatsMMYYYY[.xxx].txt must be writable by this user. Change permissions if +# necessary to "Read/Write" (and "Modify" for Windows NTFS file systems). +# Warning: Update process can be long so you might experience "time out" +# browser errors if you don't launch AWStats enough frequently. +# When set to 0, update is only made when AWStats is ran from the command +# line interface (or a task scheduler). +# Possible values: 0 or 1 +# Default: 0 +# +AllowToUpdateStatsFromBrowser=0 + + +# AWStats save and sort its database on a month basis, this allows to build +# build a report quickly. However, if you choose the -month=all from command +# line or value '-Year-' from CGI combo form to have a report for all year, +# AWStats needs to reload all data for full year, and resort them completely, +# requiring a large amount of time, memory and CPU. This might be a problem +# for web hosting providers that offer AWStats for large sites, on shared +# servers, to non CPU cautious customers. +# For this reason, the 'full year' is only enabled on Command Line by default. +# You can change this by setting this parameter to 0, 1 (recommanded), 2 or 3. +# Possible values: +# 0 - Never allowed +# 1 - Allowed on CLI only, -Year- value in combo is not visible +# 2 - Allowed on CLI only, -Year- value in combo is visible but not allowed +# 3 - Possible on CLI and CGI +# Default: 2 +# +AllowFullYearView=2 + + + +#----------------------------------------------------------------------------- +# OPTIONAL SETUP SECTION (Not required but increase AWStats features) +#----------------------------------------------------------------------------- + +# When the update process run, AWStats can set a lock file in TEMP or TMP +# directory. This lock is to avoid to have 2 update processes running at the +# same time to prevent unknown conflicts problems and avoid DoS attacks when +# AllowToUpdateStatsFromBrowser is set to 1. +# Because, when you use lock file, you can experience sometimes problems in +# lock file not correctly removed (killed process for example requires that +# you remove the file manualy), this option is not enabled by default (Do +# not enable this option with no console server access). +# Change : Effective immediatly +# Possible values: 0 or 1 +# Default: 0 +# +EnableLockForUpdate=0 + + +# AWStats can do reverse DNS lookups through a static DNS cache file that was +# previously created manually. If no path is given in static DNS cache file +# name, AWStats will search DirData directory. This file is never changed. +# This option is not used if DNSLookup=0. +# Note: DNS cache file format is 'minsince1970 ipaddress resolved_hostname' +# or just 'ipaddress resolved_hostname' +# Change : Effective for new updates only +# Example: "/mydnscachedir/dnscache" +# Default: "dnscache.txt" +# +DNSStaticCacheFile="dnscache.txt" + + +# AWStats can do reverse DNS lookups through a DNS cache file that was created +# by a previous run of AWStats. This file is erased and recreated after each +# statistics update process. You don't need to create and/or edit it. +# AWStats will read and save this file in DirData directory. +# This option is used only if DNSLookup=1. +# Note: If a DNSStaticCacheFile is available, AWStats will check for DNS +# lookup in DNSLastUpdateCacheFile after checking into DNSStaticCacheFile. +# Change : Effective for new updates only +# Example: "/mydnscachedir/dnscachelastupdate" +# Default: "dnscachelastupdate.txt" +# +DNSLastUpdateCacheFile="dnscachelastupdate.txt" + + +# You can specify specific IP addresses that should NOT be looked up in DNS. +# This option is used only if DNSLookup=1. +# Note: Use space between each value. +# Note: You can use regular expression values writing value with REGEX[value]. +# Change : Effective for new updates only +# Example: "123.123.123.123 REGEX[^192\.168\.]" +# Default: "" +# +SkipDNSLookupFor="" + + +# The following two parameters allow you to protect a config file from being +# read by AWStats when called from a browser if web user has not been +# authenticated. Your AWStats program must be in a web protected "realm" (With +# Apache, you can use .htaccess files to do so. With other web servers, see +# your server setup manual). +# Change : Effective immediatly +# Possible values: 0 or 1 +# Default: 0 +# +AllowAccessFromWebToAuthenticatedUsersOnly=0 + + +# This parameter give the list of all authorized authenticated users to view +# statistics for this domain/config file. This parameter is used only if +# AllowAccessFromWebToAuthenticatedUsersOnly is set to 1. +# Change : Effective immediatly +# Example: "user1 user2" +# Example: "__REMOTE_USER__" +# Default: "" +# +AllowAccessFromWebToFollowingAuthenticatedUsers="" + + +# When this parameter is define to something, the IP address of the user that +# read its statistics from a browser (when AWStats is used as a CGI) is +# checked and must match the IP address range defined by this parameter. +# Change : Effective immediatly +# Example: "123.123.123.10-123.123.123.255" +# Default: "" +# +AllowAccessFromWebToFollowingIPAddresses="" + + +# If the "DirData" directory (see above) does not exists, AWStats return an +# error. However, you can ask AWStats to create it. +# This option can be used by some Web Hosting Providers that has defined a +# dynamic value for DirData (for example DirData="/home/__REMOTE_USER__") and +# don't want to have to create a new directory each time they add a new user. +# Change : Effective immediatly +# Possible values: 0 or 1 +# Default: 0 +# +CreateDirDataIfNotExists=0 + + +# In most case, AWStats is used as a cgi program. So AWStats process is ran +# by default web server user (nobody for Unix, IUSR_xxx for IIS/Windows,...). +# To make use easier and avoid permission's problems between update process +# (run by an admin user) and CGI process (ran by a low level user), AWStats +# save its database files with read and write for everyone. +# If you have experience on managing security policies (Web Hosting Provider), +# you should set this parameter to 0. AWStats will keep default process user +# permissions on its files. +# Change : Effective for new updates only +# Possible values: 0 or 1 +# Default: 1 +# +SaveDatabaseFilesWithPermissionsForEveryone=1 + + +# AWStats can purge log after processing it. By this way, the next time you +# launch AWStats, log file will be smaller and processing time will be better. +# IMPORTANT !!! +# AWStats is able to detect new lines in log file, to process only them, so +# you can launch AWStats as soon as you want, even with this parameter to 0. +# With 0, no purge is made, so you must use a scheduled task or a web server +# that make this purge frequently. +# With 1, the purge of the log file is made each time AWStats update is ran. +# This parameter doesn't work with IIS (This web server doesn't let its log +# file to be purged). +# Change : Effective for new updates only +# Possible values: 0 or 1 +# Default: 0 +# +PurgeLogFile=0 + + +# When PurgeLogFile is setup to 1, AWStats will clean your log file after +# processing it. You can however keep an archive file (saved in "DirData") of +# all processed log records by setting this to 1 (For example if you want to +# use another log analyzer). +# This parameter is not used if PurgeLogFile=0 +# Change : Effective for new updates only +# Possible values: 0 or 1 +# Default: 0 +# +ArchiveLogRecords=0 + + +# Each time you run the update process, AWStats overwrite the 'historic file' +# for the month (awstatsMMYYYY[.*].txt) with the updated one. +# When write errors occurs (IO, disk full,...), this historic file can be +# corrupted and must be deleted. Because this file contains information of all +# past processed log files, you will loose old stats if removed. So you can +# ask AWStats to save last non corrupted file in a .bak file. This file is +# stored in "DirData" directory with other 'historic files'. +# Change : Effective for new updates only +# Possible values: 0 or 1 +# Default: 0 +# +KeepBackupOfHistoricFiles=0 + + +# Default index page name for your web server. +# Change : Effective for new updates only +# Example: "index.php index.html default.html" +# Default: "index.html" +# +DefaultFile="index.html" + + +# Do not include access from clients that match following criteria. +# If your log file contains IP adresses in host field, you must enter here +# matching IP adresses criteria. +# If DNS lookup is already done in your log file, you must enter here hostname +# criteria, else enter ip address criteria. +# The opposite parameter of "SkipHosts" is "OnlyHosts". +# Note: Use space between each value. This parameter is not case sensitive. +# Note: You can use regular expression values writing value with REGEX[value]. +# Change : Effective for new updates only +# Example: "127.0.0.1 REGEX[^192\.168\.] REGEX[^10\.]" +# Example: "localhost REGEX[^.*\.localdomain$]" +# Default: "" +# +SkipHosts="" + + +# Do not include access from clients with a user agent that match following +# criteria. If you want to exclude a robot, you should update the robots.pm +# file instead of this parameter. +# The opposite parameter of "SkipUserAgents" is "OnlyUserAgents". +# Note: Use space between each value. This parameter is not case sensitive. +# Note: You can use regular expression values writing value with REGEX[value]. +# Change : Effective for new updates only +# Example: "konqueror REGEX[ua_test_v\d\.\d]" +# Default: "" +# +SkipUserAgents="" + + +# Use SkipFiles to ignore access to URLs that match one of following entries. +# You can enter a list of not important URLs (like framed menus, hidden pages, +# etc...) to exclude them from statistics. You must enter here exact relative +# URL as found in log file, or a matching REGEX value. +# For example, to ignore /badpage.html, just add "/badpage.html". To ignore +# all pages in a particular directory, add "REGEX[^\/directorytoexclude]". +# The opposite parameter of "SkipFiles" is "OnlyFiles". +# Note: Use space between each value. This parameter is not case sensitive. +# Note: You can use regular expression values writing value with REGEX[value]. +# Change : Effective for new updates only +# Example: "/badpage.html REGEX[^\/excludedirectory]" +# Default: "" +# +SkipFiles="" + + +# Include in stats, only accesses from hosts that match one of following +# entries. For example, if you want AWStats to filter access to keep only +# stats for visits from particular hosts, you can add those hosts names in +# this parameter. +# If DNS lookup is already done in your log file, you must enter here hostname +# criteria, else enter ip address criteria. +# The opposite parameter of "OnlyHosts" is "SkipHosts". +# Note: Use space between each value. This parameter is not case sensitive. +# Note: You can use regular expression values writing value with REGEX[value]. +# Change : Effective for new updates only +# Example: "127.0.0.1 REGEX[^192\.168\.] REGEX[^10\.]" +# Default: "" +# +OnlyHosts="" + + +# Include in stats, only accesses from user agent that match one of following +# entries. For example, if you want AWStats to filter access to keep only +# stats for visits from particular browsers, you can add their user agents +# string in this parameter. +# The opposite parameter of "OnlyUserAgents" is "SkipUserAgents". +# Note: Use space between each value. This parameter is not case sensitive. +# Note: You can use regular expression values writing value with REGEX[value]. +# Change : Effective for new updates only +# Example: "msie" +# Default: "" +# +OnlyUserAgents="" + + +# Include in stats, only accesses to URLs that match one of following entries. +# For example, if you want AWStats to filter access to keep only stats that +# match a particular string, like a particular directory, you can add this +# directory name in this parameter. +# The opposite parameter of "OnlyFiles" is "SkipFiles". +# Note: Use space between each value. This parameter is not case sensitive. +# Note: You can use regular expression values writing value with REGEX[value]. +# Change : Effective for new updates only +# Example: "REGEX[marketing_directory] REGEX[office\/.*\.(csv|sxw)$]" +# Default: "" +# +OnlyFiles="" + + +# Add here a list of kind of url (file extension) that must be counted as +# "Hit only" and not as a "Hit" and "Page/Download". You can set here all +# images extensions as they are hit downloaded that must be counted but they +# are not viewed pages. URLs with such extensions are not included in the TOP +# Pages/URL report. +# Note: If you want to exclude particular URLs from stats (No Pages and no +# Hits reported), you must use SkipFiles parameter. +# Change : Effective for new updates only +# Example: "css js class gif jpg jpeg png bmp ico zip arj gz z wav mp3 wma mpg" +# Example: "" +# Default: "css js class gif jpg jpeg png bmp ico" +# +NotPageList="css js class gif jpg jpeg png bmp ico" + + +# By default, AWStats considers that records found in web log file are +# successful hits if HTTP code returned by server is a valid HTTP code (200 +# and 304). Any other code are reported in HTTP status chart. +# Note that HTTP 'control codes', like redirection (302, 305) are not added by +# default in this list as they are not pages seen by a visitor but are +# protocol exchange codes to tell the browser to ask another page. Because +# this other page will be counted and seen with a 200 or 304 code, if you +# add such codes, you will have 2 pages viewed reported for only one in facts. +# Change : Effective for new updates only +# Example: "200 304 302 305" +# Default: "200 304" +# +ValidHTTPCodes="200 304" + + +# By default, AWStats considers that records found in mail log file are +# successful mail transfers if field that represent return code in analyzed +# log file match values defined by this parameter. +# Change : Effective for new updates only +# Example: "1 250 200" +# Default: "1 250" +# +ValidSMTPCodes="1 250" + + +# Some web servers on some Operating systems (IIS-Windows) considers that a +# login with same value but different case are the same login. To tell AWStats +# to also considers them as one, set this parameter to 1. +# Change : Effective for new updates only +# Possible values: 0 or 1 +# Default: 0 +# +AuthenticatedUsersNotCaseSensitive=0 + + +# Some web servers on some Operating systems (IIS-Windows) considers that two +# URLs with same value but different case are the same URL. To tell AWStats to +# also considers them as one, set this parameter to 1. +# Change : Effective for new updates only +# Possible values: 0 or 1 +# Default: 0 +# +URLNotCaseSensitive=0 + + +# Keep or remove the anchor string you can find in some URLs. +# Change : Effective for new updates only +# Possible values: 0 or 1 +# Default: 0 +# +URLWithAnchor=0 + + +# In URL links, "?" char is used to add parameter's list in URLs. Syntax is: +# /mypage.html?param1=value1 +# However, some servers/sites have also others chars to isolate dynamic part of +# their URLs. You can complete this list with all such characters. +# Change : Effective for new updates only +# Example: "?;," +# Default: "?;" +# +URLQuerySeparators="?;" + + +# Keep or remove the query string to the URL in the statistics for individual +# pages. This is primarily used to differentiate between the URLs of dynamic +# pages. If set to 1, mypage.html?id=x and mypage.html?id=y are counted as two +# different pages. +# Warning, when set to 1, memory required to run AWStats is dramatically +# increased if you have a lot of changing URLs (for example URLs with a random +# id inside). Such web sites should not set this option to 1 or use seriously +# the next parameter URLWithQueryWithoutFollowingParameters. +# Change : Effective for new updates only +# Possible values: +# 0 - URLs are cleaned from the query string (ie: "/mypage.html") +# 1 - Full URL with query string is used (ie: "/mypage.html?p=x&q=y") +# Default: 0 +# +URLWithQuery=0 + + +# When URLWithQuery is on, you will get the full URL with all parameters in +# URL reports. But among thoose parameters, sometimes you don't need a +# particular parameter because it does not identify the page or because it's +# a random ID changing for each access even if URL points to same page. In +# such cases, it is higly recommanded to ask AWStats to remove such parameters +# from the URL before counting, manipulating and storing it. Enter here list +# of all non wanted parameters. For example if you enter "id", one hit on +# /mypage.cgi?p=abc&id=Yo4UomP9d and /mypage.cgi?p=abc&id=Mu8fdxl3r +# will be reported as 2 hits on /mypage.cgi?p=abc +# This parameter is not used when URLWithQuery is 0. +# Change : Effective for new updates only +# Example: "PHPSESSID jsessionid" +# Default: "" +# +URLWithQueryWithoutFollowingParameters="" + + +# Keep or remove the query string to the referrer URL in the statistics for +# external referrer pages. This is used to differentiate between the URLs of +# dynamic referrer pages. If set to 1, mypage.html?id=x and mypage.html?id=y +# are counted as two different referrer pages. +# Change : Effective for new updates only +# Possible values: +# 0 - Referrer URLs are cleaned from the query string (ie: "/mypage.html") +# 1 - Full URL with query string is used (ie: "/mypage.html?p=x&q=y") +# Default: 0 +# +URLReferrerWithQuery=0 + + +# AWStats can detect setup problems or show you important informations to have +# a better use. Keep this to 1, except if AWStats says you can change it. +# Change : Effective immediatly +# Possible values: 0 or 1 +# Default: 1 +# +WarningMessages=1 + + +# When an error occurs, AWStats output a message related to errors. If you +# want (in most cases for security reasons) to have no error messages, you +# can set this parameter to your personalized generic message. +# Change : Effective immediatly +# Example: "An error occured. Contact your Administrator" +# Default: "" +# +ErrorMessages="" + + +# AWStat can be run with debug=x parameter to ouput various informations +# to help in debugging or solving troubles. If you want (in most cases for +# security reasons) to disable debugging, set this parameter to 0. +# Change : Effective immediatly +# Possible values: 0 or 1 +# Default: 1 +# +DebugMessages=1 + + +# To help you to detect if your log format is good, AWStats report an error +# if all the first NbOfLinesForCorruptedLog lines have a format that does not +# match the LogFormat parameter. +# However, some worm virus attack on your web server can result in a very high +# number of corrupted lines in your log. So if you experience awstats stop +# because of bad virus records at the beginning of your log file, you can +# increase this parameter (very rare). +# Change : Effective for new updates only +# Default: 50 +# +NbOfLinesForCorruptedLog=50 + + +# For some particular integration needs, you may want to have CGI links to +# point to another script than awstats.pl. +# Use the name of this script in WrapperScript parameter. +# Change : Effective immediatly +# Example: "awstatslauncher.pl" +# Default: "" +# +WrapperScript="" + + +# DecodeUA must be set to 1 if you use Roxen web server. This server converts +# all spaces in user agent field into %20. This make the AWStats robots, os +# and browsers detection fail in some cases. Just change it to 1 if and only +# if your web server is Roxen. +# Change : Effective for new updates only +# Possible values: 0 or 1 +# Default: 0 +# +DecodeUA=0 + + +# MiscTrackerUrl can be used to make AWStats able to detect some miscellanous +# things, that can not be tracked on other way like: # - Screen size # - Color depth # - Java enabled @@ -706,567 +706,569 @@ DecodeUA=0 # - QuickTime plugin # - Mediaplayer plugin # - Acrobat PDF plugin -# To enable all this features, you must add the following HTML code at the end -# of your index page (before ) : -# -# If code is not added in index page, all this detection capabilities will be -# disabled. You must also check that ShowScreenSizeStats and ShowMiscStats -# parameters are set to 1 to make results appear in report page. -# If you change this parameter, you must also change the -# awstatsmisctrackerurl variable into the awstats_misc_tracker.js file. -# Change : Effective for new updates only. -# Possible value: Name of javascript tracker file added in HTML code -# Default: "/js/awstats_misc_tracker.js" -# -MiscTrackerUrl="/js/awstats_misc_tracker.js" - - - -#----------------------------------------------------------------------------- -# OPTIONAL ACCURACY SETUP SECTION (Not required but increase AWStats features) -#----------------------------------------------------------------------------- - -# Following values allows you to define accuracy of AWStats entities (robots, -# browsers, os, referers, file types) detection. -# It is recommanded that very important web sites or ISP that provides AWStats -# to their customer set this parameter to 1 (or 0), instead of 2. -# Possible values: -# 0 = No detection, -# 1 = Medium/Standard detection -# 2 = Full detection -# Change : Effective for new updates only -# Default: 2 -# -LevelForRobotsDetection=2 # 0 disables Robots detection. -LevelForBrowsersDetection=2 # 0 disables Browsers detection. -LevelForOSDetection=2 # 0 disables OS detection. -LevelForRefererAnalyze=2 # 0 disables origin detection. -LevelForFileTypesDetection=2 # 0 disables file types detection. - - - -#----------------------------------------------------------------------------- -# OPTIONAL APPEARANCE SETUP SECTION (Not required but increase AWStats features) -#----------------------------------------------------------------------------- - -# When you use AWStats as a CGI, you can have the reports shown in HTML frames. -# Frames are only available for report viewed dynamically. When you build -# pages from command line, this option is not used and no frames are built. -# Possible values: 0 or 1 -# Default: 0 -# -UseFramesWhenCGI=1 - - -# If you prefer having the report output pages be built as XML compliant pages -# instead of simple HTML pages, you can set this to 1 (May not works properly -# with some browsers). -# Possible values: 0 or 1 -# Default: 0 -# -UseXMLForOutput=0 - - -# This parameter ask your browser to open detailed reports into a different -# window than the main page. -# Possible values: -# 0 - Open all in same browser window -# 1 - Open detailed reports in another window except if using frames -# 2 - Open always in a different window even if reports are framed -# Default: 1 -# -DetailedReportsOnNewWindows=1 - - -# You can add in the HTML report page a delay to force browsers to not use cache -# if page is loaded a second time after this delay (in seconds). -# This parameter is not used when report are built with -staticlinks option. -# Example: 3600 -# Default: 0 -# -Expires=0 - - -# To avoid too large web pages, you can ask AWStats to limit number of rows of -# all reported charts to this number when no other limit apply. -# Default: 1000 -# -MaxRowsInHTMLOutput=1000 - - -# Set your primary language. -# Possible value: -# Albanian=al, Bosnian=ba, Bulgarian=bg, -# Chinese (Taiwan)=tw, Chinese (Simpliefied)=cn, Czech=cz, -# Danish=dk, Dutch=nl, English=en, Estonian=et, Finnish=fi, French=fr, -# German=de, Greek=gr, Hebrew=he, Hungarian=hu, Icelandic=is, Indonesian=id, -# Italian=it, Japanese=jp, Korean=kr, Latvian=lv, Norwegian (Nynorsk)=nn, -# Norwegian (Bokmal)=nb, Polish=pl, Portuguese=pt, Portuguese (Brazilian)=br, -# Romanian=ro, Russian=ru, Serbian=sr, Slovak=sk, Spanish=es, -# Spanish (Catalan)=es_cat, Swedish=se, Turkish=tr, Ukrainian=ua, Welsh=wlk. -# First available language accepted by browser=auto -# Default: "auto" -# -Lang="auto" - - -# Set the location of language files. -# Example: "/usr/share/awstats/lang" -# Default: "./lang" (means lang directory is in same location than awstats.pl) -# -DirLang="./lang" - - -# You choose here which reports you want to see in the main page and what you -# want to see in those reports. -# Possible values: -# 0 - Topic is not shown at all -# 1 - Report is shown with default informations -# XYZ - Report is shown with only informations defined by code X,Y,Z... -# X,Y,Z... are code letters among the following: -# U = Unique visitors -# V = Visits -# P = Number of pages -# H = Number of hits (or mails) -# B = Bandwith (or total mail size for mail logs) -# L = Last access date -# E = Entry pages -# X = Exit pages -# C = Web compression (mod_gzip,mod_deflate) -# M = Average mail size (mail logs) -# -# Show menu header with report links -# Default: 1, Possible codes: None -ShowMenu=1 -# Show monthly chart -# Default: UVPHB, Possible codes: UVPHB -ShowMonthStats=UVPHB -# Show days of month chart -# Default: VPHB, Possible codes: VPHB -ShowDaysOfMonthStats=VPHB -# Show days of week chart -# Default: PHB, Possible codes: PHB -ShowDaysOfWeekStats=PHB -# Show hourly chart -# Default: PHB, Possible codes: PHB -ShowHoursStats=PHB -# Show domains/country chart -# Default: PHB, Possible codes: PHB -ShowDomainsStats=PHB -# Show hosts chart -# Default: PHBL, Possible codes: PHBL -ShowHostsStats=PHBL -# Show authenticated users chart -# Default: 0, Possible codes: PHBL -ShowAuthenticatedUsers=0 -# Show robots chart -# Default: HBL, Possible codes: HBL -ShowRobotsStats=HBL -# Show email senders chart (For use when analyzing mail log files) -# Default: 0, Possible codes: HBML -ShowEMailSenders=0 -# Show email receivers chart (For use when analyzing mail log files) -# Default: 0, Possible codes: HBML -ShowEMailReceivers=0 -# Show session chart -# Default: 1, Possible codes: None -ShowSessionsStats=1 -# Show pages-url chart. -# Default: PBEX, Possible codes: PBEX -ShowPagesStats=PBEX -# Show file types chart. -# Default: HB, Possible codes: HBC -ShowFileTypesStats=HB -# Show file size chart (Not yet available) -# Default: 1, Possible codes: None -ShowFileSizesStats=0 -# Show operating systems chart -# Default: 1, Possible codes: None -ShowOSStats=1 -# Show browsers chart -# Default: 1, Possible codes: None -ShowBrowsersStats=1 -# Show screen size chart -# Default: 0 (See also MiscTrackerUrl if set to 1), Possible codes: None -ShowScreenSizeStats=0 -# Show origin chart -# Default: PH, Possible codes: PH -ShowOriginStats=PH -# Show keyphrases chart -# Default: 1, Possible codes: None -ShowKeyphrasesStats=1 -# Show keywords chart -# Default: 1, Possible codes: None -ShowKeywordsStats=1 -# Show misc chart -# Default: a (See also MiscTrackerUrl parameter), Possible codes: ajdfrqwp -ShowMiscStats=a -# Show http errors chart -# Default: 1, Possible codes: None -ShowHTTPErrorsStats=1 -# Show smtp errors chart (For use when analyzing mail log files) -# Default: 0, Possible codes: None -ShowSMTPErrorsStats=0 -# Show the cluster report (Your LogFormat must contains the %cluster tag) -# Default: 0, Possible codes: PHB -ShowClusterStats=0 - - -# Some graphical reports are followed by the data array of values. -# If you don't want this array (to reduce report size for example), you can -# set thoose options to 0. -# Possible values: 0 or 1 -# Default: 1 -# -# Data array values for the ShowMonthStats report -AddDataArrayMonthStats=1 -# Data array values for the ShowDaysOfMonthStats report -AddDataArrayShowDaysOfMonthStats=1 -# Data array values for the ShowDaysOfWeekStats report -AddDataArrayShowDaysOfWeekStats=1 -# Data array values for the ShowHoursStats report -AddDataArrayShowHoursStats=1 - - -# Following parameter can be used to choose maximum number of lines shown for -# the particular following report. -# -# Stats by countries/domains -MaxNbOfDomain = 10 -MinHitDomain = 1 -# Stats by hosts -MaxNbOfHostsShown = 10 -MinHitHost = 1 -# Stats by authenticated users -MaxNbOfLoginShown = 10 -MinHitLogin = 1 -# Stats by robots -MaxNbOfRobotShown = 10 -MinHitRobot = 1 -# Stats by pages -MaxNbOfPageShown = 10 -MinHitFile = 1 -# Stats by OS -MaxNbOfOsShown = 10 -MinHitOs = 1 -# Stats by browsers -MaxNbOfBrowsersShown = 10 -MinHitBrowser = 1 -# Stats by screen size -MaxNbOfScreenSizesShown = 5 -MinHitScreenSize = 1 -# Stats by referers -MaxNbOfRefererShown = 10 -MinHitRefer = 1 -# Stats for keyphrases -MaxNbOfKeyphrasesShown = 10 -MinHitKeyphrase = 1 -# Stats for keywords -MaxNbOfKeywordsShown = 10 -MinHitKeyword = 1 -# Stats for sender or receiver emails -MaxNbOfEMailsShown = 20 -MinHitEMail = 1 - - -# Choose if you want the week report to start on sunday or monday -# Possible values: -# 0 - Week start on sunday -# 1 - Week start on monday -# Default: 1 -# -FirstDayOfWeek=1 - - -# List of visible flags that links to other language translations. -# See Lang parameter for list of allowed flag/language codes. -# If you don't want any flag link, set ShowFlagLinks to "". -# This parameter is used only if ShowHeader parameter is set to 1. -# Possible values: "" or "language_codes_separated_by_space" -# Example: "en es fr nl es" -# Default: "" -# -ShowFlagLinks="" - - -# Each URL, shown in stats report views, are links you can click. -# Possible values: 0 or 1 -# Default: 1 -# -ShowLinksOnUrl=1 - - -# When AWStats build HTML links in its report pages, it starts thoose link -# with "http://". However some links might be HTTPS links, so you can enter -# here the root of all your HTTPS links. If all your site is a SSL web site, -# just enter "/". -# This parameter is not used if ShowLinksOnUrl is 0. -# Example: "/shopping" -# Example: "/" -# Default: "" -# -UseHTTPSLinkForUrl="" - - -# Maximum length of URL shown on stats page (number of characters). This -# affects only URL visible text, link still work. -# Default: 70 -# -MaxLengthOfURL=70 - - -# Set here the link used to point to Internet WhoIs database for hostnames. -# This parameter is not used if plugin hostinfo is not enabled. -# Default: "http://www.whois.net/search.cgi2?str=" -# Example: "http://www.ripe.net/perl/whois?form_type=simple&searchtext=" -# Example: "http://ws.arin.net/cgi-bin/whois.pl?queryinput=" -# -LinksToWhoIs="http://www.whois.net/search.cgi2?str=" - - -# Set here the link used to point to Internet WhoIs database for ip addresses. -# This parameter is not used if plugin hostinfo is not enabled. -# Default: "http://ws.arin.net/cgi-bin/whois.pl?queryinput=" -# Example: "http://ws.arin.net/cgi-bin/whois.pl?queryinput=" -# -LinksToIPWhoIs="http://ws.arin.net/cgi-bin/whois.pl?queryinput=" - - -# You can enter HTML code that will be added at the top of AWStats reports. -# Default: "" -# -HTMLHeadSection="" - - -# You can enter HTML code that will be added at the end of AWStats reports. -# Great to add advert ban. -# Default: "" -# -HTMLEndSection="" - - -# You can set Logo and LogoLink to use your own logo. -# Logo must be the name of image file (must be in $DirIcons/other directory). -# LogoLink is the expected URL when clicking on Logo. -# Default: "awstats_logo6.png" -# -Logo="awstats_logo6.png" -LogoLink="http://awstats.sourceforge.net" - - -# Value of maximum bar width/height for horizontal/vertical HTML graphics bar. -# Default: 260/90 -# -BarWidth = 260 -BarHeight = 90 - - -# You can ask AWStats to use a particular CSS (Cascading Style Sheet) to -# change its look. To create a style sheet, you can use samples provided with -# AWStats in wwwroot/css directory. -# Example: "/css/awstats_bw.css" -# Default: "" -# -StyleSheet="" - - -# Those colors parameters can be used (if StyleSheet parameter is not used) -# to change AWStats look. -# Example: color_name="RRGGBB" # RRGGBB is Red Green Blue components in Hex -# -color_Background="FFFFFF" # Background color for main page (Default = "FFFFFF") -color_TableBGTitle="CCCCDD" # Background color for table title (Default = "CCCCDD") -color_TableTitle="000000" # Table title font color (Default = "000000") -color_TableBG="CCCCDD" # Background color for table (Default = "CCCCDD") -color_TableRowTitle="FFFFFF" # Table row title font color (Default = "FFFFFF") -color_TableBGRowTitle="ECECEC" # Background color for row title (Default = "ECECEC") -color_TableBorder="ECECEC" # Table border color (Default = "ECECEC") -color_text="000000" # Color of text (Default = "000000") -color_textpercent="606060" # Color of text for percent values (Default = "606060") -color_titletext="000000" # Color of text title within colored Title Rows (Default = "000000") -color_weekend="EAEAEA" # Color for week-end days (Default = "EAEAEA") -color_link="0011BB" # Color of HTML links (Default = "0011BB") -color_hover="605040" # Color of HTML on-mouseover links (Default = "605040") -color_u="FFB055" # Background color for number of unique visitors (Default = "FFB055") -color_v="F8E880" # Background color for number of visites (Default = "F8E880") -color_p="4477DD" # Background color for number of pages (Default = "4477DD") -color_h="66F0FF" # Background color for number of hits (Default = "66F0FF") -color_k="2EA495" # Background color for number of bytes (Default = "2EA495") -color_s="8888DD" # Background color for number of search (Default = "8888DD") -color_e="CEC2E8" # Background color for number of entry pages (Default = "CEC2E8") -color_x="C1B2E2" # Background color for number of exit pages (Default = "C1B2E2") - - - -#----------------------------------------------------------------------------- -# PLUGINS -#----------------------------------------------------------------------------- - -# Add here all plugins file you want to load. -# Plugin files must be .pm files stored in 'plugins' directory. -# Uncomment LoadPlugin lines to enable a plugin after checking that perl -# modules required by the plugin are installed. - -# Plugin: Tooltips -# Perl modules required: None -# Add some tooltips help on HTML report pages. -# Note that enabled this kind of help will increased HTML report pages size, -# so server load and bandwidth. -# -#LoadPlugin="tooltips" - -# Plugin: IPv6 -# Perl modules required: Net::IP and Net::DNS -# This plugin gives AWStats capability to make reverse DNS lookup on IPv6 -# addresses. -# Note: If you are interesting in having country report, you should use the -# geoipfree or geoip plugin instead of enabled reverse DNS lookup. -# -#LoadPlugin="ipv6" - -# Plugin: HashFiles -# Perl modules required: Storable -# AWStats DNS cache files are read/saved as native hash files. This increase -# DNS cache files loading speed, above all for very large web sites. -# -#LoadPlugin="hashfiles" - -# Plugin: GeoIPfree -# Perl modules required: Geo::IPfree version 0.2+ (from Graciliano M.P.) -# Country chart is built from an Internet IP-Country database. -# This plugin is useless for intranet only log files. -# Note: You must choose between using this plugin (need Perl Geo::IPfree module) -# or the GeoIP plugin (need Perl Geo::IP module from Maxmind). -# This plugin reduces AWStats speed of 10% ! -# -#LoadPlugin="geoipfree" - -# Plugin: GeoIP -# Perl modules required: Geo::IP or Geo::IP::PurePerl (from Maxmind) -# Country chart is built from an Internet IP-Country database. -# This plugin is useless for intranet only log files. -# Note: You must choose between using this plugin (need Perl Geo::IP module -# from Maxmind) or the GeoIPfree plugin (need Perl Geo::IPfree module). -# This plugin reduces AWStats speed of 10% ! -# -#LoadPlugin="geoip" - -# Plugin: UserInfo -# Perl modules required: None -# Add a text (Firtname, Lastname, Office Department, ...) in authenticated user -# reports for each login value. -# A text file called userinfo.myconfig.txt, with two fields (first is login, -# second is text to show) separated by a tab char. must be created in plugins -# directory. -# -#LoadPlugin="userinfo" - -# Plugin: HostInfo -# Perl modules required: None -# Add a column into host chart with a clicable link to a popup that show WhoIs -# info, on a popup window. -# -#LoadPlugin="hostinfo" - -# Plugin: UrlAliases -# Perl modules required: None -# Add a text (Page title, description...) in URL reports after URL value. -# A text file called urlalias.myconfig.txt, with two fields (first is URL, -# second is text to show) separated by a tab char. must be created in plugins -# directory. -# -#LoadPlugin="urlalias" - -# Plugin: TimeHiRes -# Perl modules required: Time::HiRes -# Time reported by -showsteps option is in millisecond. For debug purpose. -# -#LoadPlugin="timehires" - -# Plugin: TimeZone -# Perl modules required: Time::Local -# Allow AWStats to correct a bad timezone for user of some IIS that use -# GMT date in its log instead of local server time. -# This module is useless for Apache and most IIS version. -# This plugin reduces AWStats speed of 40% !!!!!!! -# -#LoadPlugin="timezone +2" - -# Plugin: Rawlog -# Perl modules required: None +# To enable all this features, you must add the following HTML code at the end +# of your index page (before ) : +# +# If code is not added in index page, all this detection capabilities will be +# disabled. You must also check that ShowScreenSizeStats and ShowMiscStats +# parameters are set to 1 to make results appear in report page. +# If you change this parameter, you must also change the +# awstatsmisctrackerurl variable into the awstats_misc_tracker.js file. +# Change : Effective for new updates only. +# Possible value: Name of javascript tracker file added in HTML code +# Example: "/awstatsjs/awstats_misc_tracker.js" +# Default: "/js/awstats_misc_tracker.js" +# +MiscTrackerUrl="/js/awstats_misc_tracker.js" + + + +#----------------------------------------------------------------------------- +# OPTIONAL ACCURACY SETUP SECTION (Not required but increase AWStats features) +#----------------------------------------------------------------------------- + +# Following values allows you to define accuracy of AWStats entities (robots, +# browsers, os, referers, file types) detection. +# It is recommanded that very important web sites or ISP that provides AWStats +# to their customer set this parameter to 1 (or 0), instead of 2. +# Possible values: +# 0 = No detection, +# 1 = Medium/Standard detection +# 2 = Full detection +# Change : Effective for new updates only +# Default: 2 +# +LevelForRobotsDetection=2 # 0 disables Robots detection. +LevelForBrowsersDetection=2 # 0 disables Browsers detection. +LevelForOSDetection=2 # 0 disables OS detection. +LevelForRefererAnalyze=2 # 0 disables origin detection. +LevelForFileTypesDetection=2 # 0 disables file types detection. + + + +#----------------------------------------------------------------------------- +# OPTIONAL APPEARANCE SETUP SECTION (Not required but increase AWStats features) +#----------------------------------------------------------------------------- + +# When you use AWStats as a CGI, you can have the reports shown in HTML frames. +# Frames are only available for report viewed dynamically. When you build +# pages from command line, this option is not used and no frames are built. +# Possible values: 0 or 1 +# Default: 0 +# +UseFramesWhenCGI=1 + + +# If you prefer having the report output pages be built as XML compliant pages +# instead of simple HTML pages, you can set this to 1 (May not works properly +# with some browsers). +# Possible values: 0 or 1 +# Default: 0 +# +UseXMLForOutput=0 + + +# This parameter ask your browser to open detailed reports into a different +# window than the main page. +# Possible values: +# 0 - Open all in same browser window +# 1 - Open detailed reports in another window except if using frames +# 2 - Open always in a different window even if reports are framed +# Default: 1 +# +DetailedReportsOnNewWindows=1 + + +# You can add in the HTML report page a delay to force browsers to not use cache +# if page is loaded a second time after this delay (in seconds). +# This parameter is not used when report are built with -staticlinks option. +# Example: 3600 +# Default: 0 +# +Expires=0 + + +# To avoid too large web pages, you can ask AWStats to limit number of rows of +# all reported charts to this number when no other limit apply. +# Default: 1000 +# +MaxRowsInHTMLOutput=1000 + + +# Set your primary language. +# Possible value: +# Albanian=al, Bosnian=ba, Bulgarian=bg, +# Chinese (Taiwan)=tw, Chinese (Simpliefied)=cn, Czech=cz, +# Danish=dk, Dutch=nl, English=en, Estonian=et, Finnish=fi, French=fr, +# German=de, Greek=gr, Hebrew=he, Hungarian=hu, Icelandic=is, Indonesian=id, +# Italian=it, Japanese=jp, Korean=kr, Latvian=lv, Norwegian (Nynorsk)=nn, +# Norwegian (Bokmal)=nb, Polish=pl, Portuguese=pt, Portuguese (Brazilian)=br, +# Romanian=ro, Russian=ru, Serbian=sr, Slovak=sk, Spanish=es, +# Spanish (Catalan)=es_cat, Swedish=se, Turkish=tr, Ukrainian=ua, Welsh=wlk. +# First available language accepted by browser=auto +# Default: "auto" +# +Lang="auto" + + +# Set the location of language files. +# Example: "/usr/share/awstats/lang" +# Default: "./lang" (means lang directory is in same location than awstats.pl) +# +DirLang="./lang" + + +# You choose here which reports you want to see in the main page and what you +# want to see in those reports. +# Possible values: +# 0 - Topic is not shown at all +# 1 - Report is shown with default informations +# XYZ - Report is shown with only informations defined by code X,Y,Z... +# X,Y,Z... are code letters among the following: +# U = Unique visitors +# V = Visits +# P = Number of pages +# H = Number of hits (or mails) +# B = Bandwith (or total mail size for mail logs) +# L = Last access date +# E = Entry pages +# X = Exit pages +# C = Web compression (mod_gzip,mod_deflate) +# M = Average mail size (mail logs) +# +# Show menu header with report links +# Default: 1, Possible codes: None +ShowMenu=1 +# Show monthly chart +# Default: UVPHB, Possible codes: UVPHB +ShowMonthStats=UVPHB +# Show days of month chart +# Default: VPHB, Possible codes: VPHB +ShowDaysOfMonthStats=VPHB +# Show days of week chart +# Default: PHB, Possible codes: PHB +ShowDaysOfWeekStats=PHB +# Show hourly chart +# Default: PHB, Possible codes: PHB +ShowHoursStats=PHB +# Show domains/country chart +# Default: PHB, Possible codes: PHB +ShowDomainsStats=PHB +# Show hosts chart +# Default: PHBL, Possible codes: PHBL +ShowHostsStats=PHBL +# Show authenticated users chart +# Default: 0, Possible codes: PHBL +ShowAuthenticatedUsers=0 +# Show robots chart +# Default: HBL, Possible codes: HBL +ShowRobotsStats=HBL +# Show email senders chart (For use when analyzing mail log files) +# Default: 0, Possible codes: HBML +ShowEMailSenders=0 +# Show email receivers chart (For use when analyzing mail log files) +# Default: 0, Possible codes: HBML +ShowEMailReceivers=0 +# Show session chart +# Default: 1, Possible codes: None +ShowSessionsStats=1 +# Show pages-url chart. +# Default: PBEX, Possible codes: PBEX +ShowPagesStats=PBEX +# Show file types chart. +# Default: HB, Possible codes: HBC +ShowFileTypesStats=HB +# Show file size chart (Not yet available) +# Default: 1, Possible codes: None +ShowFileSizesStats=0 +# Show operating systems chart +# Default: 1, Possible codes: None +ShowOSStats=1 +# Show browsers chart +# Default: 1, Possible codes: None +ShowBrowsersStats=1 +# Show screen size chart +# Default: 0 (See also MiscTrackerUrl if set to 1), Possible codes: None +ShowScreenSizeStats=0 +# Show origin chart +# Default: PH, Possible codes: PH +ShowOriginStats=PH +# Show keyphrases chart +# Default: 1, Possible codes: None +ShowKeyphrasesStats=1 +# Show keywords chart +# Default: 1, Possible codes: None +ShowKeywordsStats=1 +# Show misc chart +# Default: a (See also MiscTrackerUrl parameter), Possible codes: ajdfrqwp +ShowMiscStats=a +# Show http errors chart +# Default: 1, Possible codes: None +ShowHTTPErrorsStats=1 +# Show smtp errors chart (For use when analyzing mail log files) +# Default: 0, Possible codes: None +ShowSMTPErrorsStats=0 +# Show the cluster report (Your LogFormat must contains the %cluster tag) +# Default: 0, Possible codes: PHB +ShowClusterStats=0 + + +# Some graphical reports are followed by the data array of values. +# If you don't want this array (to reduce report size for example), you can +# set thoose options to 0. +# Possible values: 0 or 1 +# Default: 1 +# +# Data array values for the ShowMonthStats report +AddDataArrayMonthStats=1 +# Data array values for the ShowDaysOfMonthStats report +AddDataArrayShowDaysOfMonthStats=1 +# Data array values for the ShowDaysOfWeekStats report +AddDataArrayShowDaysOfWeekStats=1 +# Data array values for the ShowHoursStats report +AddDataArrayShowHoursStats=1 + + +# Following parameter can be used to choose maximum number of lines shown for +# the particular following report. +# +# Stats by countries/domains +MaxNbOfDomain = 10 +MinHitDomain = 1 +# Stats by hosts +MaxNbOfHostsShown = 10 +MinHitHost = 1 +# Stats by authenticated users +MaxNbOfLoginShown = 10 +MinHitLogin = 1 +# Stats by robots +MaxNbOfRobotShown = 10 +MinHitRobot = 1 +# Stats by pages +MaxNbOfPageShown = 10 +MinHitFile = 1 +# Stats by OS +MaxNbOfOsShown = 10 +MinHitOs = 1 +# Stats by browsers +MaxNbOfBrowsersShown = 10 +MinHitBrowser = 1 +# Stats by screen size +MaxNbOfScreenSizesShown = 5 +MinHitScreenSize = 1 +# Stats by referers +MaxNbOfRefererShown = 10 +MinHitRefer = 1 +# Stats for keyphrases +MaxNbOfKeyphrasesShown = 10 +MinHitKeyphrase = 1 +# Stats for keywords +MaxNbOfKeywordsShown = 10 +MinHitKeyword = 1 +# Stats for sender or receiver emails +MaxNbOfEMailsShown = 20 +MinHitEMail = 1 + + +# Choose if you want the week report to start on sunday or monday +# Possible values: +# 0 - Week start on sunday +# 1 - Week start on monday +# Default: 1 +# +FirstDayOfWeek=1 + + +# List of visible flags that links to other language translations. +# See Lang parameter for list of allowed flag/language codes. +# If you don't want any flag link, set ShowFlagLinks to "". +# This parameter is used only if ShowHeader parameter is set to 1. +# Possible values: "" or "language_codes_separated_by_space" +# Example: "en es fr nl es" +# Default: "" +# +ShowFlagLinks="" + + +# Each URL, shown in stats report views, are links you can click. +# Possible values: 0 or 1 +# Default: 1 +# +ShowLinksOnUrl=1 + + +# When AWStats build HTML links in its report pages, it starts thoose link +# with "http://". However some links might be HTTPS links, so you can enter +# here the root of all your HTTPS links. If all your site is a SSL web site, +# just enter "/". +# This parameter is not used if ShowLinksOnUrl is 0. +# Example: "/shopping" +# Example: "/" +# Default: "" +# +UseHTTPSLinkForUrl="" + + +# Maximum length of URL shown on stats page (number of characters). This +# affects only URL visible text, link still work. +# Default: 70 +# +MaxLengthOfURL=70 + + +# Set here the link used to point to Internet WhoIs database for hostnames. +# This parameter is not used if plugin hostinfo is not enabled. +# Default: "http://www.whois.net/search.cgi2?str=" +# Example: "http://www.ripe.net/perl/whois?form_type=simple&searchtext=" +# Example: "http://ws.arin.net/cgi-bin/whois.pl?queryinput=" +# +LinksToWhoIs="http://www.whois.net/search.cgi2?str=" + + +# Set here the link used to point to Internet WhoIs database for ip addresses. +# This parameter is not used if plugin hostinfo is not enabled. +# Default: "http://ws.arin.net/cgi-bin/whois.pl?queryinput=" +# Example: "http://ws.arin.net/cgi-bin/whois.pl?queryinput=" +# +LinksToIPWhoIs="http://ws.arin.net/cgi-bin/whois.pl?queryinput=" + + +# You can enter HTML code that will be added at the top of AWStats reports. +# Default: "" +# +HTMLHeadSection="" + + +# You can enter HTML code that will be added at the end of AWStats reports. +# Great to add advert ban. +# Default: "" +# +HTMLEndSection="" + + +# You can set Logo and LogoLink to use your own logo. +# Logo must be the name of image file (must be in $DirIcons/other directory). +# LogoLink is the expected URL when clicking on Logo. +# Default: "awstats_logo6.png" +# +Logo="awstats_logo6.png" +LogoLink="http://awstats.sourceforge.net" + + +# Value of maximum bar width/height for horizontal/vertical HTML graphics bar. +# Default: 260/90 +# +BarWidth = 260 +BarHeight = 90 + + +# You can ask AWStats to use a particular CSS (Cascading Style Sheet) to +# change its look. To create a style sheet, you can use samples provided with +# AWStats in wwwroot/css directory. +# Example: "/awstatscss/awstats_bw.css" +# Example: "/css/awstats_bw.css" +# Default: "" +# +StyleSheet="" + + +# Those colors parameters can be used (if StyleSheet parameter is not used) +# to change AWStats look. +# Example: color_name="RRGGBB" # RRGGBB is Red Green Blue components in Hex +# +color_Background="FFFFFF" # Background color for main page (Default = "FFFFFF") +color_TableBGTitle="CCCCDD" # Background color for table title (Default = "CCCCDD") +color_TableTitle="000000" # Table title font color (Default = "000000") +color_TableBG="CCCCDD" # Background color for table (Default = "CCCCDD") +color_TableRowTitle="FFFFFF" # Table row title font color (Default = "FFFFFF") +color_TableBGRowTitle="ECECEC" # Background color for row title (Default = "ECECEC") +color_TableBorder="ECECEC" # Table border color (Default = "ECECEC") +color_text="000000" # Color of text (Default = "000000") +color_textpercent="606060" # Color of text for percent values (Default = "606060") +color_titletext="000000" # Color of text title within colored Title Rows (Default = "000000") +color_weekend="EAEAEA" # Color for week-end days (Default = "EAEAEA") +color_link="0011BB" # Color of HTML links (Default = "0011BB") +color_hover="605040" # Color of HTML on-mouseover links (Default = "605040") +color_u="FFB055" # Background color for number of unique visitors (Default = "FFB055") +color_v="F8E880" # Background color for number of visites (Default = "F8E880") +color_p="4477DD" # Background color for number of pages (Default = "4477DD") +color_h="66F0FF" # Background color for number of hits (Default = "66F0FF") +color_k="2EA495" # Background color for number of bytes (Default = "2EA495") +color_s="8888DD" # Background color for number of search (Default = "8888DD") +color_e="CEC2E8" # Background color for number of entry pages (Default = "CEC2E8") +color_x="C1B2E2" # Background color for number of exit pages (Default = "C1B2E2") + + + +#----------------------------------------------------------------------------- +# PLUGINS +#----------------------------------------------------------------------------- + +# Add here all plugins file you want to load. +# Plugin files must be .pm files stored in 'plugins' directory. +# Uncomment LoadPlugin lines to enable a plugin after checking that perl +# modules required by the plugin are installed. + +# Plugin: Tooltips +# Perl modules required: None +# Add some tooltips help on HTML report pages. +# Note that enabled this kind of help will increased HTML report pages size, +# so server load and bandwidth. +# +#LoadPlugin="tooltips" + +# Plugin: IPv6 +# Perl modules required: Net::IP and Net::DNS +# This plugin gives AWStats capability to make reverse DNS lookup on IPv6 +# addresses. +# Note: If you are interesting in having country report, you should use the +# geoipfree or geoip plugin instead of enabled reverse DNS lookup. +# +#LoadPlugin="ipv6" + +# Plugin: HashFiles +# Perl modules required: Storable +# AWStats DNS cache files are read/saved as native hash files. This increase +# DNS cache files loading speed, above all for very large web sites. +# +#LoadPlugin="hashfiles" + +# Plugin: GeoIPfree +# Perl modules required: Geo::IPfree version 0.2+ (from Graciliano M.P.) +# Country chart is built from an Internet IP-Country database. +# This plugin is useless for intranet only log files. +# Note: You must choose between using this plugin (need Perl Geo::IPfree module) +# or the GeoIP plugin (need Perl Geo::IP module from Maxmind). +# This plugin reduces AWStats speed of 10% ! +# +#LoadPlugin="geoipfree" + +# Plugin: GeoIP +# Perl modules required: Geo::IP or Geo::IP::PurePerl (from Maxmind) +# Country chart is built from an Internet IP-Country database. +# This plugin is useless for intranet only log files. +# Note: You must choose between using this plugin (need Perl Geo::IP module +# from Maxmind) or the GeoIPfree plugin (need Perl Geo::IPfree module). +# This plugin reduces AWStats speed of 10% ! +# +#LoadPlugin="geoip" + +# Plugin: UserInfo +# Perl modules required: None +# Add a text (Firtname, Lastname, Office Department, ...) in authenticated user +# reports for each login value. +# A text file called userinfo.myconfig.txt, with two fields (first is login, +# second is text to show) separated by a tab char. must be created in plugins +# directory. +# +#LoadPlugin="userinfo" + +# Plugin: HostInfo +# Perl modules required: None +# Add a column into host chart with a clicable link to a popup that show WhoIs +# info, on a popup window. +# +#LoadPlugin="hostinfo" + +# Plugin: UrlAliases +# Perl modules required: None +# Add a text (Page title, description...) in URL reports after URL value. +# A text file called urlalias.myconfig.txt, with two fields (first is URL, +# second is text to show) separated by a tab char. must be created in plugins +# directory. +# +#LoadPlugin="urlalias" + +# Plugin: TimeHiRes +# Perl modules required: Time::HiRes +# Time reported by -showsteps option is in millisecond. For debug purpose. +# +#LoadPlugin="timehires" + +# Plugin: TimeZone +# Perl modules required: Time::Local +# Allow AWStats to correct a bad timezone for user of some IIS that use +# GMT date in its log instead of local server time. +# This module is useless for Apache and most IIS version. +# This plugin reduces AWStats speed of 40% !!!!!!! +# +#LoadPlugin="timezone +2" + +# Plugin: Rawlog +# Perl modules required: None # This plugin adds a form in AWStats main page to allow users to see raw -# content of current log files. A filter is also available. -# -#LoadPlugin="rawlog" - -# Plugin: GraphApplet -# Perl modules required: None -# Supported charts are built by a nice 3D graphic applet. -# -#LoadPlugin="graphapplet" # NOT YET AVAILABLE - - - -#----------------------------------------------------------------------------- -# EXTRA SECTION -#----------------------------------------------------------------------------- - -# You can define your own charts, you choose here what are rows and columns -# keys. This feature is particularly usefull for marketing purpose, tracking -# products orders for example. -# For this, edit all parameters of Extra section. Each set of parameter is a -# different chart. For several charts, duplicate section changing the number. -# Note: Each Extra section reduces AWStats speed by 8%. -# -# WARNING: A wrong setup of Extra section might result in too large arrays -# that will consume all your memory, making AWStats unusable after several -# updates, so be sure to setup it correctly. -# In most cases, you don't need this feature. -# -# ExtraSectionNameX is title of your personalized chart. -# ExtraSectionConditionalX are conditions you can use to count or not the hit, -# Use one of the field condition (URL, QUERY_STRING, REFERER, UA, HOST) -# and string to match after a coma. Use "|" for "OR". -# ExtraSectionFirstColumnTitleX is the first column title of the chart. -# ExtraSectionFirstColumnValuesX is a Regex string to tell AWStats in which -# field to extract value from (URL, QUERY_STRING, REFERER, UA, HOST) and how -# to extract the value. Each different value found will appear in first -# column of report on a different row. Be sure that list of different values -# is "limited" to avoid "not enough memory" problems ! -# ExtraSectionFirstColumnFormatX is the string used to write value. -# ExtraSectionStatTypesX are things you want to count. You can use standard -# code letters (P for pages,H for hits,B for bandwidth,L for last access). -# ExtraSectionAddAverageRowX add a row at bottom of chart with average values. -# ExtraSectionAddSumRowX add a row at bottom of chart with sum values. -# MaxNbOfExtraX is maximum number of rows shown in chart. -# MinHitExtraX is minimum number of hits required to be shown in chart. -# - -# Example to report the 20 products the most ordered by "order.cgi" script -#ExtraSectionName1="Product orders" -#ExtraSectionCondition1="URL,/cgi-bin/order.cgi" -#ExtraSectionFirstColumnTitle1="Product ID" -#ExtraSectionFirstColumnValues1="QUERY_STRING,productid=([^&]+)" -#ExtraSectionFirstColumnFormat1="%s" -#ExtraSectionStatTypes1=PL -#ExtraSectionAddAverageRow1=0 -#ExtraSectionAddSumRow1=1 -#MaxNbOfExtra1=20 -#MinHitExtra1=1 - - - -#----------------------------------------------------------------------------- -# INCLUDES -#----------------------------------------------------------------------------- - -# You can include other config files using the directive with the name of the -# config file. -# This is particularly usefull for users who have a lot of virtual servers, so -# a lot of config files and want to maintain common values in only one file. -# Note that when a variable is defined both in a config file and in an -# included file, AWStats will use the last value read. -# - -#Include "" - +# content of current log files. A filter is also available. +# +#LoadPlugin="rawlog" + +# Plugin: GraphApplet +# Perl modules required: None +# Supported charts are built by a nice 3D graphic applet. +# +#LoadPlugin="graphapplet" # NOT YET AVAILABLE + + + +#----------------------------------------------------------------------------- +# EXTRA SECTION +#----------------------------------------------------------------------------- + +# You can define your own charts, you choose here what are rows and columns +# keys. This feature is particularly usefull for marketing purpose, tracking +# products orders for example. +# For this, edit all parameters of Extra section. Each set of parameter is a +# different chart. For several charts, duplicate section changing the number. +# Note: Each Extra section reduces AWStats speed by 8%. +# +# WARNING: A wrong setup of Extra section might result in too large arrays +# that will consume all your memory, making AWStats unusable after several +# updates, so be sure to setup it correctly. +# In most cases, you don't need this feature. +# +# ExtraSectionNameX is title of your personalized chart. +# ExtraSectionConditionalX are conditions you can use to count or not the hit, +# Use one of the field condition (URL, QUERY_STRING, REFERER, UA, HOST) +# and string to match after a coma. Use "|" for "OR". +# ExtraSectionFirstColumnTitleX is the first column title of the chart. +# ExtraSectionFirstColumnValuesX is a Regex string to tell AWStats in which +# field to extract value from (URL, QUERY_STRING, REFERER, UA, HOST) and how +# to extract the value. Each different value found will appear in first +# column of report on a different row. Be sure that list of different values +# is "limited" to avoid "not enough memory" problems ! +# ExtraSectionFirstColumnFormatX is the string used to write value. +# ExtraSectionStatTypesX are things you want to count. You can use standard +# code letters (P for pages,H for hits,B for bandwidth,L for last access). +# ExtraSectionAddAverageRowX add a row at bottom of chart with average values. +# ExtraSectionAddSumRowX add a row at bottom of chart with sum values. +# MaxNbOfExtraX is maximum number of rows shown in chart. +# MinHitExtraX is minimum number of hits required to be shown in chart. +# + +# Example to report the 20 products the most ordered by "order.cgi" script +#ExtraSectionName1="Product orders" +#ExtraSectionCondition1="URL,/cgi-bin/order.cgi" +#ExtraSectionFirstColumnTitle1="Product ID" +#ExtraSectionFirstColumnValues1="QUERY_STRING,productid=([^&]+)" +#ExtraSectionFirstColumnFormat1="%s" +#ExtraSectionStatTypes1=PL +#ExtraSectionAddAverageRow1=0 +#ExtraSectionAddSumRow1=1 +#MaxNbOfExtra1=20 +#MinHitExtra1=1 + + + +#----------------------------------------------------------------------------- +# INCLUDES +#----------------------------------------------------------------------------- + +# You can include other config files using the directive with the name of the +# config file. +# This is particularly usefull for users who have a lot of virtual servers, so +# a lot of config files and want to maintain common values in only one file. +# Note that when a variable is defined both in a config file and in an +# included file, AWStats will use the last value read. +# + +#Include "" + diff --git a/wwwroot/cgi-bin/awstats.pl b/wwwroot/cgi-bin/awstats.pl index 68e11d7f..8000bf5d 100644 --- a/wwwroot/cgi-bin/awstats.pl +++ b/wwwroot/cgi-bin/awstats.pl @@ -113,7 +113,7 @@ $MaxLengthOfStoredUA $StaticExt='html'; $DNSStaticCacheFile='dnscache.txt'; $DNSLastUpdateCacheFile='dnscachelastupdate.txt'; -$MiscTrackerUrl=quotemeta('/js/awstats_misc_tracker.js'); +$MiscTrackerUrl=quotemeta('/awstatsjs/awstats_misc_tracker.js'); $Lang='auto'; $MaxRowsInHTMLOutput=1000; $MaxLengthOfURL=70; @@ -733,15 +733,19 @@ sub error { print "\n"; } if (! $ErrorMessages && ! $donotshowsetupinfo) { - if (scalar keys %HTMLOutput) { print "
\n"; } - print "Setup (".($FileConfig?"'".$FileConfig."'":"Config")." file, web server or permissions) may be wrong.\n"; - if (scalar keys %HTMLOutput) { print "
\n"; } + if ($message =~ /Couldn.t open config file/i) { + my $dir=$DIR; $dir =~ s/[\\\/]?wwwroot[\/\\]cgi-bin[\\\/]?//; + print "${tagbr}${tagbold}Did you use the correct URL ?${tagunbold}${tagbr}\n"; + print "Example: http://localhost/awstats/awstats.pl?config=mysite${tagbr}\n"; + print "Example: http://127.0.0.1/cgi-bin/awstats.pl?config=mysite${tagbr}\n"; + print "${tagbr}${tagbold}Did you create your config file ?${tagunbold}${tagbr}\n"; + print "Try to run $dir/tools/configure.pl${tagbr}${tagbr}\n"; + } + else { print "${tagbr}${tagbold}Setup (".($FileConfig?"'".$FileConfig."'":"Config")." file, web server or permissions) may be wrong.${tagunbold}${tagbr}\n"; } print "See AWStats documentation in 'docs' directory for informations on how to setup $PROG.\n"; } # Remove lock if not a lock message - if ($EnableLockForUpdate && $message !~ /lock file/) { - &Lock_Update(0); - } + if ($EnableLockForUpdate && $message !~ /lock file/) { &Lock_Update(0); } if (scalar keys %HTMLOutput) { print "\n\n"; } exit 1; } @@ -1452,7 +1456,7 @@ sub Check_Config { if ($NbOfLinesForCorruptedLog !~ /^\d+/ || $NbOfLinesForCorruptedLog<1) { $NbOfLinesForCorruptedLog=50; } if ($Expires !~ /^\d+/) { $Expires=0; } if ($DecodeUA !~ /[0-1]/) { $DecodeUA=0; } - $MiscTrackerUrl||=quotemeta('/js/awstats_misc_tracker.js'); + $MiscTrackerUrl||=quotemeta('/awstatsjs/awstats_misc_tracker.js'); # Optional accuracy setup section if ($LevelForRobotsDetection !~ /^\d+/) { $LevelForRobotsDetection=2; } if ($LevelForBrowsersDetection !~ /^\d+/) { $LevelForBrowsersDetection=2; }