Configuration

SETUP SYSTEMS VARIABLES

• $pathserver is the absolute path where your server's documents are stored
  (Eg : $pathserver = "/export/home/www/htdocs/")

• $linkpathserver is the relative path where your server's documents are stored
  Usually $linkpathserver is / except for personal pages
  (Eg : $linkpathserver = "/")

• $path is the full path where you have installed w3perl ('pwd' command)
  (Eg : $path = "/export/home/www/htdocs/w3perl/")

• $linkpath : the relative URL from root server where w3perl has been installed.
  (Eg : '/w3perl/' if w3perl is in the root server directory
  '/~domisse/w3perl/' if w3perl is in ~domisse/public_html/w3perl/)

• $fileroot is the full path to the httpd log files
  (Eg : $fileroot = "/export/home/www/apache/logs/";

• $prefixlog is the name of your log file (found in $fileroot)
  usually 'access_log' for NCSA server and 'httpd-log' for CERN server
  (Eg : $prefixlog = "access_log")

• $referlog is the name of your referer log (found in $fileroot)
  if you don't have such file on your server, don't modify it.
  (Eg : $referlog = "referer_log")

• $agentlog is the name of your agent log (found in $fileroot)
  if you don't have such file on your server, don't modify it.
  (Eg : $agentlog = "agent_log")

• $errorlog is the name of your error log (found in $fileroot)
  if you don't have such file on your server, don't modify it.
  (Eg : $errorlog = "error_log")

• Full path to your ppmtogif, giftrans, gzip and gnuplot utils
  Execute 'whereis <command>' or 'which <command>' to find the path.
  Don't delete the '-dc' option for gzip !
  (Eg : $GZCAT = "/opt/bin/gzip -dc")

CONFIGURE RESULTS FILES

• $localserver is the name of your WWW server
  (Eg : $localserver = "www.orstom.fr")

• $tri is used if you want to log only a subdirectory on your server
  (Eg : $tri = "/subdirectory/")

• $francename and $englishname are the french and english homepage for w3perl
  (Eg : $englishname = "index.html" to have by default the english homepage)

• Compute log only with these extension files
  (Eg : @extension = ('html','.htm'))
  (Eg : @ExtensionImage = ('.gif','.jpg','jpeg'))
  

• $nolog if you want to cancel log from your some servers
  (Eg : @nolog = ('194.51.174','.grolier.') exclude 194.51.174.* and all grolier web)

• @selection of HTML pages with full info...don't specify too much !
  (Eg : @selection = ('/raydream/index.html'))

• @selecrepert : output graphical stat for these subdirectories
  (Eg : @selecrepert = ('/raydream/','/astro/stars/')

• @excluderepert : no report for these subdirectories
  (Eg : @excluderepert = ('/private/')

• $precision configure the resulting HTML pages
  (Eg : $precision = 1 will show only main stats results
  $precision = 4 will compute large results stats but will take a
  long time for huge log file.)

• $locallog if you need to log your domain server
  (Eg : $locallog = 1 will also compute log for your server $localserver)

• $zip one log file or splitted gziped log files (see newhttpdlog)
  (Eg : $zip = 0 for one file or $zip = 1 for monthly gziped log files)

• $topten only list the $topten most successful files
  (Eg : $topten = 10)

• $seuilpage : list only files with more than $seuilpage requests.
  It avoid to have too large files results. (Eg : $seuilpage = 100)

• $seuilsite : list only sites with more than $seuilsite requests
  (Eg : $seuilsite = 9 to show sites with 10 accesses and more)

• $seuilrepert : list only directory with more than $seuilrepert accesses
  (Eg : $seuilrepert = 0 to show all directories requests)

• $optdirsize : for directories traffic graphs
  1-2-3 html (total, external, domain)
  4-5-6 all (total, external, domain)
  (Eg : $optdirsize = 4 external and internal traffic for HTML, GIF...)

• $mailadr : your email if users want to alter the config file.
  If people want precise infos on their pages, you should add their URL in @selection in config.pl file
  (Eg : $mailadr = "webmaster\@grolier.fr")

• $nbdays : number of days for the daily graphs (0 for the year)
  (Eg : $nbdays = 50)

• $defaulthomepage : default HTML page returned when your httpd server produced "/"
  (Eg : $defaulthomepage = "index.html" (usual one))

• $titlename : convert URL to the string included in your title's document
  (Eg : $titlename = 1 if yes)

• $localdomaine : add here your IP adresses you want to cancel
  (Eg : $localdomaine = "$localdomainename|^145\.238\.44\.[4567]" cancel accesses from 145.238.44.4 to 7)

• $custom_text : use your own color for text
  (Eg : $custom_text = "#000000" for black)

• $custom_link : use your own color for link
  (Eg : $custom_link = "#000080")

• $custom_vlink : use your own color for vlink
  (Eg : $custom_vlink = "#800000")

• $background : use your own background file
  Need to be put in /w3perl/Ressources/ or make a symbolic link
  (Eg : $background = "background.gif")

• $backgrd : use a background file or a color code
  Uncomment $background if you choose a file
  (Eg : $backgrd = "BACKGROUND=\"$background\"")