1 rizwank 1.1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2 <html>
3 <head>
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.38 $ - $Author: eldy $ - $Date: 2004/12/18 22:04:23 $ -->
11 </head>
12
13 <body topmargin=10 leftmargin=5>
14
15
16 <table style="font: 10pt arial,helvetica,verdana" cellpadding=0 cellspacing=0 border=0 bgcolor=#FFFFFF width=100%>
17
18 <!-- Large -->
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>
22 rizwank 1.1 <br>
23 <font style="font: 16pt arial,helvetica,sans-serif" color=#EEEEFF><b>AWStats logfile analyzer 6.3 Documentation</b></font><br>
24 <br>
25 </td>
26 <td bgcolor=#9999cc align=center>
27
28 </td>
29 </tr>
30
31 </table>
32
33
34 <br><br><H1 style="font: 26px arial,helvetica,sans-serif">Other utilities</H1>
35
36 <br>
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>
39 <br><br>
40
41 <!--
42 <br>
43 rizwank 1.1 <br><a name="awstats_configure"><H2 style="font: 18px arial,helvetica,sans-serif color: #606060"><u>awstats_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>
46 <br>
47 <br> This tool is not yet available...
48
49 <br>
50 <br>
51 -->
52
53 <br>
54 <br><a name="awstats_updateall"><H2 style="font: 18px arial,helvetica,sans-serif 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.
58 <br>
59 <br>Usage: awstats_updateall.pl now [options]
60 <br>
61 <br>Where options are:
62 <br> -awstatsprog=pathtoawstatspl
63 <br> -configdir=confdirtoscan
64 rizwank 1.1
65 <br>
66 <br>
67
68 <br>
69 <br><a name="awstats_buildstaticpages"><H2 style="font: 18px arial,helvetica,sans-serif 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.
72 <br>
73 <br>Usage:
74 <br>awstats_buildstaticpages.pl (awstats_options) [awstatsbuildstaticpages_options]
75 <br>
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
82 <br>
83 <br> and awstatsbuildstaticpages_options can be
84 <br> -awstatsprog=pathtoawstatspl gives AWStats software (awstats.pl) path
85 rizwank 1.1 <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').
91 <br>
92 <br>New versions and FAQ at http://awstats.sourceforge.net
93
94 <br>
95 <br>
96
97 <br>
98 <br><a name="logresolvemerge"><H2 style="font: 18px arial,helvetica,sans-serif color: #606060"><u>logresolvemerge.pl</u></H2></a>
99 <br>logresolvemerge allows you to merge several log files into one output,
100 <br>sorted on date. It also makes a fast reverse DNS lookup to replace
101 <br>all IP addresses into host names in resulting log file.
102 <br>logresolvemerge comes with ABSOLUTELY NO WARRANTY. It's a free software
103 <br>distributed with a GNU General Public License (See COPYING.txt file).
104 <br>logresolvemerge is part of AWStats but can be used alone as a log merger
105 <br>or resolver before using any other log analyzer.
106 rizwank 1.1 <br>
107 <br>Usage:
108 <br> logresolvemerge.pl [options] file
109 <br> logresolvemerge.pl [options] file1 ... filen
110 <br> logresolvemerge.pl [options] *.*
111 <br>Options:
112 <br> -dnslookup make a reverse DNS lookup on IP adresses
113 <br> -dnscache=file make DNS lookup from cache file first before network lookup
114 <br> -showsteps print on stderr benchmark information every 8192 lines
115 <br> -addfilenum if used with several files, file number can be added in first
116 <br> field of output file.
117 <br>
118 <br>This runs logresolvemerge in command line to open one or several web
119 <br>server log files to merge them (sorted on date) and/or to make a reverse
120 <br>DNS lookup (if wanted). The result log file is sent on standard output.
121 <br>Note: logresolvemerge is not a 'sort' tool to sort one file. It's a
122 <br>software able to output sorted log records (with a reverse DNS lookup
123 <br>included or not) even if log records are dispatched in several files.
124 <br>Each of thoose files must be already independently sorted itself
125 <br>(but that is the case in all web server log files). So you can use it
126 <br>for load balanced log files or to process several old log files.
127 rizwank 1.1 <br>
128 <br>Don't forget that the main goal of logresolvemerge is to send log records to
129 <br>a log analyzer in a sorted order without merging files on disk (NO NEED
130 <br>OF DISK SPACE AT ALL) and without loading files into memory (NO NEED
131 <br>OF MORE MEMORY). Choose of output records is done on the fly.
132 <br>
133 <br>So logresolvemerge is particularly usefull when you want to output several
134 <br>and/or large log files in a fast process, with no use of disk or
135 <br>more memory and in a chronological order through a pipe (to be used by a log
136 <br>analyzer.
137 <br>
138 <br>Note: If input records are not 'exactly' sorted but 'nearly' sorted (this
139 <br>occurs with heavy servers), this is not a problem, the output will also
140 <br>be 'nearly' sorted but a few log analyzers (like AWStats) knowns how to deal
141 <br>with such logs.
142 <br>
143 <br>WARNING: If log files are old MAC text files (lines ended with CR char), you
144 <br>can't run this tool on Win or Unix platforms.
145 <br>
146 <br>WARNING: Because of important memory holes in ActiveState Perl version, use
147 <br>another Perl interpreter if you need to process large lof files.
148 rizwank 1.1 <br>
149 <br>Now supports/detects:
150 <br> Automatic detection of log format
151 <br> Files can be .gz/.bz2 files if zcat/bzcat tools are available in PATH.
152 <br>New versions and FAQ at http://awstats.sourceforge.net
153
154 <br>
155 <br>
156
157 <br>
158 <br><a name="maillogconvert"><H2 style="font: 18px arial,helvetica,sans-serif color: #606060"><u>maillogconvert.pl</u></H2></a>
159 <br>maillogconvert is mail log preprocessor that convert a mail log file (from
160 <br>postfix, sendmail or qmail servers) into a human readable format.
161 <br>The output format is also ready to be used by a log analyzer, like AWStats.
162 <br>
163 <br>Usage:
164 <br> perl maillogconvert.pl [standard|vadmin] [year] < logfile > output
165 <br>
166 <br>The first parameter specifies what format the mail logfile is :
167 <br> standard - logfile is standard postfix,sendmail,qmail or mdaemon log format
168 <br> vadmin - logfile is qmail log format with vadmin multi-host support
169 rizwank 1.1 <br>
170 <br>The second parameter specifies what year to timestamp logfile with, if current
171 <br>year is not the correct one (ie. 2002). Always use 4 digits. If not specified,
172 <br>current year is used.
173 <br>
174 <br>If no output is specified, it goes to the console (stdout).
175
176 <br>For example, the following sample from postfix mail log server:
177 <br>
178 <i>
179 <br># 1 Mail fromuser@aol.com -> touser@toserver.com, forward touser@toserver.com -> touser@mainserver.com
180 <br>Jan 01 07:27:31 apollon postfix/smtpd[1684]: connect from remt30.cluster1.charter.net[209.225.8.40]
181 <br>Jan 01 07:27:32 apollon postfix/smtpd[1684]: 2BC793B8A4: client=remt30.cluster1.charter.net[209.225.8.40]
182 <br>Jan 01 07:27:32 apollon postfix/cleanup[1687]: 2BC793B8A4: message-id=<36027278@vneka>
183 <br>Jan 01 07:27:32 apollon postfix/qmgr[13860]: 2BC793B8A4: from=<fromuser@aol.com>, size=2130, nrcpt=1 (queue active)
184 <br>Jan 01 07:27:32 apollon postfix/smtpd[1684]: disconnect from remt30.cluster1.charter.net[209.225.8.40]
185 <br>Jan 01 07:27:38 apollon postfix/local[1689]: 2BC793B8A4: to=<touser@mainserver.com>, orig_to=<touser@toserver.com>, relay=local, delay=6, status=sent ("|/usr/bin/procmail")
186 <br># 2 Reject: 450
187 <br>Jan 01 14:05:44 apollon postfix/smtpd[2114]: connect from baby.mainframe.nl[81.29.4.2]
188 <br>Jan 01 14:05:44 apollon postfix/smtpd[2114]: E0C9D3BD9A: client=baby.mainframe.nl[81.29.4.2]
189 <br>Jan 01 14:05:44 apollon postfix/smtpd[2114]: E0C9D3BD9A: reject: RCPT from baby.mainframe.nl[81.29.4.2]: 450 <touser2@toserver.com>: User unknown in local recipient table; from=<> to=<touser2@toserver.com> proto=ESMTP helo=<baby.mainframe.nl>
190 rizwank 1.1 <br>Jan 01 14:10:16 juni postfix/smtpd[2568]: C34ED1432B: reject: RCPT from relay2.tp2rc.edu.tw[163.28.32.177]: 450 <unknownuser@unknownserver.com>: User unknown in local recipient table; from=<> proto=ESMTP helo=<rmail.nccu.edu.tw>
191 <br># 1 From unknown
192 <br>Jan 01 15:17:05 apollon postfix/smtpd[29866]: connect from tomts12.bellnexxia.net[209.226.175.56]
193 <br>Jan 01 15:17:05 apollon postfix/smtpd[29866]: 578093B8B5: client=tomts12.bellnexxia.net[209.226.175.56]
194 <br>Jan 01 15:17:05 apollon postfix/cleanup[28931]: 578093B8B5: message-id=<20030905131913.EOVH11393.tomts12-srv.bellnexxia.net@tomts12-srv>
195 <br>Jan 01 15:17:06 apollon postfix/qmgr[965]: 578093B8B5: from=<>, size=109367, nrcpt=1 (queue active)
196 <br>Jan 01 15:17:06 apollon postfix/local[32432]: 578093B8B5: to=<touser@mainserver.com>, orig_to=<touser@toserver.com>, relay=local, delay=1, status=sent ("|/usr/bin/procmail")
197 <br>Jan 01 15:17:06 apollon postfix/smtpd[29866]: disconnect from tomts12.bellnexxia.net[209.226.175.56]
198 </i>
199 <br>
200 <br>will give a file that looks like this:
201 <br>
202 <i>
203 <br>2004-01-01 07:27:38 fromuser@aol.com touser@toserver.com remt30.cluster1.charter.net localhost SMTP - 1 2130
204 <br>2004-01-01 14:05:44 <> touser2@toserver.com baby.mainframe.nl - SMTP - 450 0
205 <br>2004-01-01 14:10:16 <> unknownuser@unknownserver.com relay2.tp2rc.edu.tw - SMTP - 450 0
206 <br>2004-01-01 15:17:06 <> touser@toserver.com tomts12.bellnexxia.net localhost SMTP - 1 109367
207 </i>
208 <br>
209 <br>See <a href="awstats_faq.html#MAIL">FAQ-COM100</a> to see how to use maillogconvert.pl with AWStats to analyze mail log files.
210 <br>
211 rizwank 1.1
212 <br>
213 <br>
214
215 <br>
216 <br><a name="urlaliasbuilder"><H2 style="font: 18px arial,helvetica,sans-serif color: #606060"><u>urlaliasbuilder.pl</u></H2></a>
217 <br>Urlaliasbuilder generates an 'urlalias' file from an input file.
218 <br>The input file must contain a list of URLs (It can be an AWStats history file).
219 <br>For each of thoose URLs, the script get the corresponding HTML page and catch the
220 <br>header information (title), then it writes an output file that contains one line
221 <br>for each URLs and several fields:
222 <br>- The first field is the URL,
223 <br>- The second is title caught from web page.
224 <br>This resulting file can be used by AWStats urlalias plugin.
225 <br>
226 <br>Usage: urlaliasbuilder.pl -site=www.myserver.com [options]
227 <br>
228 <br>The site parameter contains the web server to get the page from.
229 <br>Where options are:
230 <br> -urllistfile=Input urllist file
231 <br> If this file is an AWStats history file then urlaliasbuilder will use the
232 rizwank 1.1 <br> SIDER section of this file as its input URL's list.
233 <br> -urlaliasfile=Output urlalias file to build
234 <br> -overwrite Overwrite output file if exists
235 <br> -secure Use https protocol
236 <br>
237 <br>Example: urlaliasbuilder.pl -site=www.someotherhost.com
238 <br>
239 <br>New versions and FAQ at http://awstats.sourceforge.net
240 <br>
241 <br>This script was written from Simon Waight original works title-grabber.pl.
242 <br>
243 <br>
244
245 <br>
246 <hr>
247
248 <script language=javascript>
249 var date='$Date: 2004/12/18 22:04:23 $';
250 document.writeln("Last revision: "+date);
251 </script>
252
253 rizwank 1.1 </body>
254 </html>
|
Return to
awstats_tools.html
CVS log
Up to [RizwankCVS] / geekymedia_web / awstats-6.3 / docs