Configuration



  If you have a cgi-bin access, please use the form available in /w3perl/admin/ to build the configuration file.
Note that if you are using the administration interface, you don't need to fill all the fields if you just want to alter a previous config file. Just select 'modify'.

People without cgi-bin access need to edit the config.pl file.
Never put a rem in front of these variable. If you don't know what to give, don't change anything. The scripts need to initialize these variables to run.

Various configuration file are provided in the /docs/conf/ directory, both for NT, Archimedes and Mac (last ones are a little bit old). if you've got into any trouble, just send me your config file and I will be able to check it.


 
Platform specific

 
 

  • $type_serveur : server used
    (Eg : $type_serveur = 0 on Unix)

  • $dirsep : path separator
    (Eg : $dirsep = "/" on Unix)

  • $htmlext : HTML extension
    (Eg : $htmlext = ".html" on Unix)

  • $gifext : GIF extension
    (Eg : $gifext = ".gif" on Unix)

  • $plext : Perl extension
    (Eg : $plext = ".pl" on Unix)

  • $zipext : compression extension
    (Eg : $zipext = ".gz" on Unix)

  • $struct_logfile : logfile format
    Uncomment the one you want to use.
    (Eg : $struct_logfile = "%host %null %login %date %hourshift %method %page %protocol %status %requetesize" for a CLF logfile)

  • $struct_compressed_logfile : logfile string format
    (Eg : $struct_compressed_logfile = "%year.%month.%day.%prefixlog" for a logfile like 1998.03.20.access_log)
  •  
    Setup

     
      You should setup these variables in order to run W3Perl

  • $path is the full path where the output files will be stored
    (Eg : $path = "/export/home/www/htdocs/w3perl/")

  • $pathinit is the full path to the w3perl directory (where the package have been installed)
    (Eg : $pathinit = "/export/home/www/htdocs/w3perl/")

  • $linkpathinit is the absolute URL to w3perl directory from your server
    (Eg : $linkpathinit = "/w3perl/")

  • $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 = "/")

  • $cgipath is the location of your cgi-bin directory
    If you don't know the value, don't modify it.
    (Eg : $cgipath = "/export/home/www/cgi-bin/")

  • $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 gzip and fly utils
    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 NT)
  •  
    Output

     
      You need to setup these variables in order to configure W3Perl

  • $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/")

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

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

  • @selecrepert : graphical output for these subdirectories, should be in the same depth level
    (Eg : @selecrepert = ('/raydream/','/astro/'))

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

  • $precision configure the level of accuracy
    (Eg : $precision = 1 to 4)

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

  • $localonly if you want to log ONLY your domain server
    (Eg : $locallog = 1 will compute log ONLY for your domain)

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

  • $zipcut use monthly (1) or daily (2) compressed logfiles
    (Eg : $zipcut = 0)

  • $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)

  • $seuilscript : list only scripts with more than $seuilscript requests
    (Eg : $seuilscript = 5 to show scripts used more than 5 accesses)

  • $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...)

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

  • $virtualserver : select one web server to filter your NECLF (only applicable with NECLF logfile)
    (Eg : $virtualserver = "www.detector.com")

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

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

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

  • $localdomaine : add here IP hosts in your $localdomainename (if these hosts don't have DNS)
    (Eg : $localdomaine = "$localdomainename|^145\.238\.44\.[4567]" cancel accesses from 145.238.44.4 to 7)

  • $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\@hplyot.obspm.fr")

  • $tildealias : your alias for users HTML directory
    (Eg : $tildealias = "public_html" or "www")

  • $yellowfile : need if you use yellow page NIS for your intranet DNS
    (Eg : $yellowfile = "" don't use yellow page)

  • $reverse_dns : will convert IP address to name server (WARNING : very slow !!!)
    (Eg : $reverse_dns = 1 will activate)

  • @lang : choose your languages output
    (Eg : @lang = ('uk') if you need only english ouput)

  • @homepages : filename for your different language
    You should have the same number of elements than @lang
    (Eg : @lang = ('index') if you select only english ouput)

  • $frame_updown : choose top-bottom or right-left frames
    (Eg : $frame_updown = 1 top-bottom frames)

  • $topframelinks : configure your own link in the top frame
    (Eg : $topframelinks = "My_server")

  • $bargraph $tridim $linegraph $fillgraph : give value 1 for your choice
    (Eg : $tridim = 1)

  • $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/resources/ 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\"")

  •   back