1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
4
<meta name="description" content="AWStats Documentation - Other tools">
5
<meta name="keywords" content="awstats, awstat, tools, utilities, awstats_buildstaticpages, logresolvemerge, common2combined">
6
<meta name="robots" content="index,follow">
7
<meta name="title" content="AWStats Documentation - Other tools">
8
<title>AWStats Documentation - Other tools</title>
9
<link rel="stylesheet" href="styles.css" type="text/css">
10
<!-- $Revision: 1.30 $ - $Author: eldy $ - $Date: 2004/01/04 17:37:18 $ -->
13
<body topmargin=10 leftmargin=5>
16
<table style="font: 10pt arial,helvetica,verdana" cellpadding=0 cellspacing=0 border=0 bgcolor=#FFFFFF width=100%>
19
<tr style="font: 10pt arial,helvetica,verdana">
20
<td bgcolor=#9999cc align=center><a href="/"><img src="images/awstats_logo4.png" border=0></a></td>
21
<td bgcolor=#9999cc align=center>
23
<font style="font: 16pt arial,helvetica,sanserif" color=#EEEEFF><b>AWStats logfile analyzer 6.0 Documentation</b></font><br>
26
<td bgcolor=#9999cc align=center>
34
<br><br><H1 style="font: 26px arial,helvetica,sanserif">Other tools</H1>
37
This is a list of other tools provided with AWStats.<br>
38
All those tools are available in <b>tools</b> directory of AWStats distribution.<br>
43
<br><a name="configure"><H2 style="font: 22px arial,helvetica,sanserif color: #606060"><u>configure.pl</u></H2></a>
44
<br>This script creates one config file for each web servers provided by Apache.
45
<br>After running this tool, AWStats can immediatly be used.<br>
47
<br> This tool is not yet available...
54
<br><a name="awstats_updateall"><H2 style="font: 22px arial,helvetica,sanserif color: #606060"><u>awstats_updateall.pl</u></H2></a>
55
<br>awstats_updateall launches update process for all AWStats config files (except
56
<br>awstats.model.conf) found in a particular directory, so you can easily setup a
57
<br>cron/scheduler job. The scanned directory is by default /etc/awstats.
59
<br>Usage: awstats_updateall.pl now [options]
61
<br>Where options are:
62
<br> -awstatsprog=pathtoawstatspl
63
<br> -configdir=confdirtoscan
69
<br><a name="awstats_buildstaticpages"><H2 style="font: 22px arial,helvetica,sanserif color: #606060"><u>awstats_buildstaticpages.pl</u></H2></a>
70
<br>awstats_buildstaticpages allows you to launch AWStats with -staticlinks option
71
<br>to build all possible pages allowed by AWStats -output option.
74
<br>awstats_buildstaticpages.pl (awstats_options) [awstatsbuildstaticpages_options]
76
<br> where awstats_options are any option known by AWStats
77
<br> -config=configvalue is value for -config parameter (REQUIRED)
78
<br> -update option used to update statistics before to generate pages
79
<br> -lang=LL to output a HTML report in language LL (en,de,es,fr,...)
80
<br> -month=MM to output a HTML report for an old month=MM
81
<br> -year=YYYY to output a HTML report for an old year=YYYY
83
<br> and awstatsbuildstaticpages_options can be
84
<br> -awstatsprog=pathtoawstatspl gives AWStats software (awstats.pl) path
85
<br> -dir=outputdir to set output directory for generated pages
86
<br> -builddate=%YY%MM%DD Used to add build date in built pages filenames
87
<br> -staticlinksext=xxx For pages with .xxx extension instead of .html
88
<br> -buildpdf[=pathtohtmldoc] Build a PDF file after building HTML pages.
89
<br> Output directory must contains icon directory
90
<br> when this option is used (need 'htmldoc').
92
<br>New versions and FAQ at http://awstats.sourceforge.net
97
<br><a name="urlaliasbuilder"><H2 style="font: 22px arial,helvetica,sanserif color: #606060"><u>urlaliasbuilder.pl</u></H2></a>
98
<br>Urlaliasbuilder generates an 'urlalias' file from an input file.
99
<br>The input file must contain a list of URLs (It can be an AWStats history file).
100
<br>For each of thoose URLs, the script get the corresponding HTML page and catch the
101
<br>header information (title), then it writes an output file that contains one line
102
<br>for each URLs and several fields:
103
<br>- The first field is the URL,
104
<br>- The second is title caught from web page.
105
<br>This resulting file can be used by AWStats urlalias plugin.
107
<br>Usage: urlaliasbuilder.pl -site=www.myserver.com [options]
109
<br>The site parameter contains the web server to get the page from.
110
<br>Where options are:
111
<br> -urllistfile=Input urllist file
112
<br> If this file is an AWStats history file then urlaliasbuilder will use the
113
<br> SIDER section of this file as its input URL's list.
114
<br> -urlaliasfile=Output urlalias file to build
115
<br> -overwrite Overwrite output file if exists
116
<br> -secure Use https protocol
118
<br>Example: urlaliasbuilder.pl -site=www.someotherhost.com
120
<br>New versions and FAQ at http://awstats.sourceforge.net
122
<br>This script was written from Simon Waight original works title-grabber.pl.
126
<br><a name="logresolvemerge"><H2 style="font: 22px arial,helvetica,sanserif color: #606060"><u>logresolvemerge.pl</u></H2></a>
127
<br>logresolvemerge allows you to merge several log files into one output,
128
<br>sorted on date. It also makes a fast reverse DNS lookup to replace
129
<br>all IP addresses into host names in resulting log file.
130
<br>logresolvemerge comes with ABSOLUTELY NO WARRANTY. It's a free software
131
<br>distributed with a GNU General Public License (See COPYING.txt file).
132
<br>logresolvemerge is part of AWStats but can be used alone as a log merger
133
<br>or resolver before using any other log analyzer.
136
<br> logresolvemerge.pl [options] file
137
<br> logresolvemerge.pl [options] file1 ... filen
138
<br> logresolvemerge.pl [options] *.*
140
<br> -dnslookup make a reverse DNS lookup on IP adresses
141
<br> -dnscache=file make DNS lookup from cache file first before network lookup
142
<br> -showsteps print on stderr benchmark information every 8192 lines
143
<br> -addfilenum if used with several files, file number can be added in first
144
<br> field of output file.
146
<br>This runs logresolvemerge in command line to open one or several web
147
<br>server log files to merge them (sorted on date) and/or to make a reverse
148
<br>DNS lookup (if wanted). The result log file is sent on standard output.
149
<br>Note: logresolvemerge is not a 'sort' tool to sort one file. It's a
150
<br>software able to output sorted log records (with a reverse DNS lookup
151
<br>included or not) even if log records are dispatched in several files.
152
<br>Each of thoose files must be already independently sorted itself
153
<br>(but that is the case in all web server log files). So you can use it
154
<br>for load balanced log files or to process several old log files.
156
<br>Don't forget that the main goal of logresolvemerge is to send log records to
157
<br>a log analyzer in a sorted order without merging files on disk (NO NEED
158
<br>OF DISK SPACE AT ALL) and without loading files into memory (NO NEED
159
<br>OF MORE MEMORY). Choose of output records is done on the fly.
161
<br>So logresolvemerge is particularly usefull when you want to output several
162
<br>and/or large log files in a fast process, with no use of disk or
163
<br>more memory and in a chronological order through a pipe (to be used by a log
166
<br>Note: If input records are not 'exactly' sorted but 'nearly' sorted (this
167
<br>occurs with heavy servers), this is not a problem, the output will also
168
<br>be 'nearly' sorted but a few log analyzers (like AWStats) knowns how to deal
171
<br>WARNING: If log files are old MAC text files (lines ended with CR char), you
172
<br>can't run this tool on Win or Unix platforms.
174
<br>WARNING: Because of important memory holes in ActiveState Perl version, use
175
<br>another Perl interpreter if you need to process large lof files.
177
<br>Now supports/detects:
178
<br> Automatic detection of log format
179
<br> Files can be .gz/.bz2 files if zcat/bzcat tools are available in PATH.
180
<br>New versions and FAQ at http://awstats.sourceforge.net
187
<script language=javascript>
188
var date='$Date: 2004/01/04 17:37:18 $';
189
document.writeln("Last revision: "+date);