From: eldy <> Date: Sun, 9 Nov 2003 04:53:05 +0000 (+0000) Subject: maillogconvert.pl: Added support for MDaemon mail server log files X-Git-Tag: AWSTATS_6_0_BETA~142 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=8a63cae54b525b9574f8d3824edddf19ec9aa90b;p=thirdparty%2FAWStats.git maillogconvert.pl: Added support for MDaemon mail server log files --- diff --git a/docs/awstats_changelog.txt b/docs/awstats_changelog.txt index 3468ff37..50a925b4 100644 --- a/docs/awstats_changelog.txt +++ b/docs/awstats_changelog.txt @@ -35,6 +35,8 @@ New features/improvements: with Perl 5.8. - maillogconvert.pl: Allow to process qmail log preprocessed by tai64nlocal tool. +- maillogconvert.pl: Added support for MDaemon mail server log files. + Other/Documentation: - Prepare code for decodeUTFkeys plugin. diff --git a/docs/awstats_config.html b/docs/awstats_config.html index 0e1355b2..59e44a37 100644 --- a/docs/awstats_config.html +++ b/docs/awstats_config.html @@ -242,7 +242,7 @@ when reading it), follow the example:
4.1+ for tag %NS-n
5.0+ for tag %WY-n
5.1+ for tag %Wm-n, %Wy-n, %Dw-n
-
# "LogFile" contains the web server logfile to analyze. +
# "LogFile" contains the web, ftp or mail server logfile to analyze.
# You can use a full path or relative path from awstats.pl directory.
# Example: "/var/log/apache/access.log"
# Example: "../logs/mycombinedlog.log" @@ -307,8 +307,9 @@ when reading it), follow the example:

# 3 - Webstar native log format
# 4 - Apache or Squid native common log format (NCSA common/CLF log format)
# With LogFormat=4, some features (browsers, os, keywords...) can't work. -
# "your_own_personalized_log_format" = If your log is a personalized format, -
# you must use the following syntax keys to define the log format string: +
# "your_own_personalized_log_format" = If your log is ftp, mail or other format, +
# you must use following keys to define the log format string (See FAQ +
# for ftp, mail or exotic web log format examples):
# %host Host client name or IP address
# %lognamequot Authenticated login/user with format: "alex"
# %logname Authenticated login/user with format: alex diff --git a/docs/awstats_faq.html b/docs/awstats_faq.html index 71d7b1ef..37868dd7 100644 --- a/docs/awstats_faq.html +++ b/docs/awstats_faq.html @@ -50,7 +50,7 @@ Here, you can find the most common questions and answers about AWStats setup/usa FAQ-COM025 How to use AWStats with no server log
FAQ-COM050 What is the log size limit AWStats can analyze ?
FAQ-COM090 Setup for FTP server log files.
-FAQ-COM100 Setup for MAIL log files (Sendmail, Postfix, QMail, Exchange).
+FAQ-COM100 Setup for MAIL log files (Sendmail, Postfix, QMail, MDaemon, Exchange).
FAQ-COM110 Setup for MEDIA SERVER log files (Realmedia, Windows media, Darwin streaming server).
FAQ-COM120 How to rotate my logs without loosing data.
FAQ-COM130 How to run AWStats frequently ?
@@ -115,10 +115,14 @@ Because AWStats is in Perl, it can works on all Operating Systems.
Examples of used platforms (bold means 'tested by author', others were reported by AWStats users to work correctly) :
OS:
-Windows 2000, Windows NT 4.0, Windows Me, Linux, Macintosh, Solaris, Aix, BeOS, ...
-Web/Wap/Proxy/FTP/Mails/Streaming servers
-Apache 1.3.x and 2, IIS 5.0, WebStar, WebLogic, WebSite, Windows Media Server, Tomcat, Squid, Sendmail, Postfix, QMail, -Roxen, Resin, ProFTP, Lotus Notes/Domino, Darwin, IPlanet, IceCast, ZeroBrand, Zeus, Zope, Abyss, www4mail, ...
+Windows 2000, Windows NT 4.0, Windows Me, Linux (RedHat, Mandrake, Debian, Suse...), Macintosh, Solaris, Aix, BeOS, ...
+Web/Wap/Proxy/Streaming servers
+Apache 1.3.x and 2, IIS 5.0, WebStar, WebLogic, WebSite, Windows Media Server, Tomcat, Squid, +Roxen, Resin, Lotus Notes/Domino, Darwin, IPlanet, IceCast, ZeroBrand, Zeus, Zope, Abyss...
+FTP servers
+ProFTP, ...
+Mails servers
+Sendmail, Postfix, QMail, Mdaemon, www4mail, ...
Perl interpreters:
ActivePerl 5.6, Perl 5.8, Perl 5.6, Perl 5.0, mod_perl for Apache, ...
@@ -284,14 +288,14 @@ Now you can use AWStats as usual (run the update process and read statistics).
-FAQ-COM100 : SETUP FOR MAIL LOG FILES (SENDMAIL, POSTFIX, QMAIL, EXCHANGE...)
+FAQ-COM100 : SETUP FOR MAIL LOG FILES (SENDMAIL, POSTFIX, QMAIL, MDAEMON, EXCHANGE...)
PROBLEM:
What do I have to do to use AWStats to analyze my mail log files.
SOLUTION:

This tip works with AWStats 5.5 or higher.

-For Postfix, Sendmail or QMail log files
+For Postfix, Sendmail, QMail or MDaemon log files

You must setup AWStats to use a mail log file preprocessor (maillogconvert.pl is provided into AWStats tools directory, but you can use the one of your choice):
@@ -302,13 +306,13 @@ For standard Postfix, Sendmail and standard QMail logfiles, set
LogFile="perl /path/to/maillogconvert.pl standard < /pathtomaillog/maillog |"
 -And for VAdmin QMail logfiles (multi-host/virtualhost mail servers running vadmin software)
+If the logfiles are compressed, they can be processed this way
-LogFile="perl /path/to/maillogconvert.pl vadmin < /pathtomaillog/maillog |"
+LogFile="gzip -cd /var/log/maillog.0.gz | /path/to/maillogconvert.pl standard |"
 -If the logfiles are compressed, they can be processed this way
+And for VAdmin QMail logfiles (multi-host/virtualhost mail servers running vadmin software)
-LogFile="gzip -cd /var/log/maillog.0.gz | /path/to/maillogconvert.pl vadmin |"
+LogFile="perl /path/to/maillogconvert.pl vadmin < /pathtomaillog/maillog |"
 Then change: @@ -346,9 +350,12 @@ Now you can use AWStats as usual (run the update process and read statistics).For Exchange log files

-If someone can understand the Exchange log format, he can explain it to me at eldy@users.sourceforge.net.
-Until this server will log messy data, just forget using AWStats or use a more serious -mail server (sendmail, postfix, ...). Sorry.
+Despite the high number of possible log format provided with Exchange, +none of them is built enough seriously to offer an interseting analyze (missing informations, +messy data, no id to join multiple records for same mail, etc...). +For this reason, an "interesting" log analysis is a joke with Exchange log files (No data is +better than false data). So forget using AWStats or use a more serious mail server (sendmail, +postfix, qmail, mdaemon, ...). Sorry.