![]() |
Configuration |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
This page is here to help you building manually your configuration file. If you have a web server running, use the administration interface as it's really easier to do that way. First locate the config.pl file. Windows users should find it in C:\Program Files\W3Perl\config.pl Never comment any variable. If you don't know which values to put, don't change anything. The scripts need to initialize these variables to run.
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
![]() |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
In the first section, you just have to change - $type_serveuraccording to your OS. Others don't need to be changed.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
![]() |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
![]()
- $logfile_formatFirst define your logfile format. If you don't know anything about logfile format, just extract few lines from your logfile and compare them with those lines. Windows users running an IIS server can choose between :
- $struct_logfileIf you have changed the default value from your server configuration file, put here your modification in the logfile format you are using.
- $struct_compressed_logfileThen you'll need to inform the script about your log filename. The list of keywords is available here.
- $date_formatIIS users have to specify the date format used as it had change over IIS version. If you choose the IIS format, use %day%month%year If you choose the default W3C format, leave blank as there is no date entries in the log, but if you add the 'date' field use %year%month%day If you are using an older IIS version than 5.1, launch the IIS administration interface and watch by yourself the date format used.
- $virtualfilter and $virtualCLFIf you are using only one logfile for several websites, virtual host is included in the logfile so you can retrieve accesses for each websites.
Virtual hosts are stored as a separate field
A typical logfile entries look like :
Select $virtualfilter = "www.obspm.fr" to parse only this virtual host and bypass other virtual host.
- CLF (Common Log File)
- $retrieve_external_logIf set to 1, the logfiles will be downloaded from a remote server.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
![]() |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
- $pathThe output path where files will be created. Can be anywhere. Just make sure W3Perl is able to write in the specified directory (Eg : $path = "/export/home/www/htdocs/w3perl/")
- $pathinitThe W3Perl directory path (where the package have been installed) (Eg : $pathinit = "/export/home/www/htdocs/w3perl/")
- $pathserverThe web server path where html can be found (Eg : $pathserver = "/export/home/www/htdocs/")
- $linkpathserverThe relative path where your server's documents are stored Usually $linkpathserver is / except for personal pages (Eg : $linkpathserver = "/")
- $cgipathThe cgi-bin directory path If you don't know the value, don't change anything. (Eg : $cgipath = "/export/home/www/cgi-bin/")
- $filerootThe path where logfiles are stored (Eg : $fileroot = "/export/home/www/apache/logs/";
- $prefixlogThe name of your logfiles (found in $fileroot). If you are using split logfiles, give the constant string ('access' for 'access.200610.gz') usually 'access_log' for NCSA server, 'httpd-log' for CERN server, Windows users can have 'ex' for W3C format (IIS), 'in' for IIS format (IIS) or 'nc' for CLF format (Eg : $prefixlog = "access_log")
- $referlogThe name of your referer log (found in $fileroot) if you don't have such file on your server, leave blank. (Eg : $referlog = "referer_log")
- $agentlogThe name of your agent log (found in $fileroot) if you don't have such file on your server, leave blank. (Eg : $agentlog = "agent_log")
- $errorlogThe name of your error log (found in $fileroot) if you don't have such file on your server, leave blank. (Eg : $errorlog = "error_log")
- $FLYPath to the fly tool Execute 'whereis <command>' or 'which <command>' to find the path. (Eg : $FLY = "/usr/local/bin/fly" on Unix or $FLY = "C:/Program Files/W3Perl/fly.exe" on NT)
- $GZIPPath to the gzip tool Execute 'whereis <command>' or 'which <command>' to find the path. Don't delete the '-dc' option for gzip ! (Eg : $GZIP = "/opt/bin/gzip -dc" on Unix or $GZIP = "D:/bin/unzip" on Windows) |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
![]() |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
![]()
- $localserverName of your WWW server (Eg : $localserver = "www.orstom.fr")
- $triUse '/' to scan everything from your root server. Otherwise, set a directory and only URL starting with your value will be scanned. Useful if you want to scan only part of your server. (Eg : $tri = "/subdirectory/")
- $country_filteringTo skip log entries from a country. Use country extension (Eg : $contry_filtering = ".com" to exclude all hosts from .com)
- $nologTo skip log entries from some servers or domains (Eg : @nolog = ('194.51.174','.grolier.') exclude 194.51.174.* and all grolier hosts)
- @selectionIf you need very detailed stats about some HTML pages ... don't specify too much ! (Eg : @selection = ('/raydream/index.html'))
- @selecrepertGraphic stats for some subdirectories, should be in the same depth level. Usually give main subdirectories. (Eg : @selecrepert = ('/raydream/','/astro/'))
- @excluderepertTo exclude report for these subdirectories (Eg : @excluderepert = ('/private/'))
- $precisionSet the level of report. Default is 3 (Eg : $precision = 1 to 4)
- $locallogIf you want to log your domain server also. (Eg : $locallog = 1 will also compute log for your domain)
- $localonlyIf you want to log ONLY your domain server (Eg : $locallog = 1 will compute log ONLY for your domain)
- $zipSet to 1 if you have compressed logfiles. (Eg : $zip = 0 for uncompressed log files or $zip = 1 for compressed log files)
- $zipcutIf your logfile are split. Set to '1' for monthly, '2' for daily logfiles, or '3' for apache rotation logfiles (Eg : $zipcut = 0 mean only one log file)
- Threshold - $toptenList only the $topten most successful files (Eg : $topten = 10)
- $seuilpageShow only files with more than $seuilpage requests. It avoid to have too large files results. (Eg : $seuilpage = 100)
- $seuilsiteList only sites with more than $seuilsite requests (Eg : $seuilsite = 9 to show sites with 10 accesses and more)
- $seuilscriptList only scripts with more than $seuilscript requests (Eg : $seuilscript = 5 to show scripts used more than 5 accesses)
- $seuilrepertList only directory with more than $seuilrepert accesses (Eg : $seuilrepert = 0 to show all directories requests)
- $optdirsizeType of graphs for directories traffic 1-2-3 html (total, external, domain) 4-5-6 all (total, external, domain) (Eg : $optdirsize = 4 external and internal traffic for HTML, GIF...)
- $nbdaysNumber of days for the daily graphs (0 for the year) (Eg : $nbdays = 50)
- $virtualserverSelect one web server to filter your NECLF (only applicable with NECLF logfile) (Eg : $virtualserver = "www.detector.com")
- $defaulthomepageDefault HTML page returned when your httpd server produced "/" (Eg : $defaulthomepage = "index" (usual one))
- $titlenameConvert URL to the string included in your title's document (Eg : $titlename = 1 if yes)
- $localdomaineAdd here IP hosts in your $localdomainename (if these hosts don't have DNS) (Eg : $localdomaine = "$localdomainename|^145\.238\.44\.[4567]" will add hosts 145.238.44.4 to 7 with your domain hosts)
- $mailadrYour email if some users want to modify your configuration file. If people want precise infos on their pages, you should add their URL in @selection in config.pl file (Eg : $mailadr = "webmaster\@hplyot.obspm.fr")
- $tildealiasYour alias for users HTML directory (Eg : $tildealias = "public_html" or "www")
- $yellowfileNeed if you use yellow page NIS for your intranet DNS (Eg : $yellowfile = "" don't use yellow page)
- $reverse_dnsWill convert IP address to name server (WARNING : very slow !!!) (Eg : $reverse_dns = 1 will activate)
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
![]() |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
![]()
- @homepagesFilename for your different language You should have the same number of elements than @lang. Default language homepage should be 'index' (Eg : @lang = ('index','index-fr') if you select english and french ouput and english is default)
- @langChoose your languages output. Use country extension. List of language available is in resources/lang/ (Eg : @lang = ('uk','fr') if you need english and french ouput)
- $frame_updownChoose top-bottom or right-left frames (Eg : $frame_updown = 1 means top-bottom frames)
- $topframelinks: configure your own link in the top frame (Eg : $topframelinks = "My_server")
- $bargraph (bar chart) , $tridim (3D bar chart) , $linegraph (line) , $fillgraph (filled lines)Set to 1 which output you want (Eg : $tridim = 1 for 3D bar chart)
- People without CSS - $custom_textUse your own color for text (Eg : $custom_text = "#000000" for black)
- $custom_linkUse your own color for link (Eg : $custom_link = "#000080")
- $custom_vlinkUse your own color for vlink (Eg : $custom_vlink = "#800000")
- $bgcolorUse your own color for background (Eg : $bgcolor = "#FFFFFF")
- $background and $backgrdIf you want to use a background for fun Put your image in /w3perl/resources/ or make a symbolic link from this directory (Eg : $background = "background.gif" and set $backgrd = "BACKGROUND=\"$background\"") |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
![]() |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
![]() - Scripts runningSet to '1' which scripts you want to run. $actif_inc is for incremental stats. $actif_real is for real time stats. $actif_hour is for hourly stats. $actif_day is for daily stats. $actif_week is for weekly stats. $actif_month is for monthly stats. $actif_agent is for agent stats. $actif_refer is for referer stats. $actif_session is for session stats. $actif_error is for error stats. $actif_history is for CPU stats. $actif_url is for document stats. Scripts you may want to disable is url, session, history, error, real. Leave others actif.
- When to updateSet the number of day between two run for each script. '1' mean a daily run. $url_launch, $week_launch may be set to one week '7'. $month_launch may be set to a month '30'.
- When to run
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
![]() |