From: eldy <> Date: Sat, 3 May 2003 15:09:22 +0000 (+0000) Subject: Added QMail support. X-Git-Tag: AWSTATS_5_5_BETA~4 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=447186b52e2b538f768c702eed6daff1db8529cb;p=thirdparty%2FAWStats.git Added QMail support. --- diff --git a/docs/awstats_changelog.txt b/docs/awstats_changelog.txt index c98c2f00..73197bf1 100644 --- a/docs/awstats_changelog.txt +++ b/docs/awstats_changelog.txt @@ -35,6 +35,7 @@ New features/improvments: AddDataArrayShowDaysOfMonthStats parameters were added. - Added -staticlinksext to build static pages with another extension than default .html +- Added QMail support. Other/Documentation: - Added Isle of Man, Monserat, and Palestinian flag icon. diff --git a/docs/awstats_faq.html b/docs/awstats_faq.html index 27b37eff..aaa5e669 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, Exchange).
+FAQ-COM100 Setup for MAIL log files (Sendmail, Postfix, QMail, Exchange).
FAQ-COM110 Setup for MEDIA SERVER log files (Realmedia, Windows media server).
FAQ-COM120 How to rotate my logs without loosing data.
FAQ-COM130 How to run AWStats frequently ?
@@ -115,7 +115,7 @@ Examples of used platforms (bold means 'tested by author', others were reported 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, +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, IPlanet, IceCast, ZeroBrand, Zeus, Zope, www4mail, ...
Perl interpreters:
ActivePerl 5.6, Perl 5.8, Perl 5.6, Perl 5.0, mod_perl for Apache, ...
@@ -251,7 +251,8 @@ LogFile="/var/log/xferlog"
NotPageList=""
ShowLinksOnUrl=0
ShowMenu=1 -
ShowMonthDayStats=UVHB +
ShowMonthStats=UVHB +
ShowDaysOfMonthStats=HB
ShowDaysOfWeekStats=HB
ShowHoursStats=HB
ShowDomainsStats=HB @@ -276,16 +277,16 @@ Now you can use AWStats as usual (run the update process and read statistics).
-FAQ-COM100 : SETUP FOR MAIL LOG FILES (SENDMAIL, POSTFIX, EXCHANGE...)
+FAQ-COM100 : SETUP FOR MAIL LOG FILES (SENDMAIL, POSTFIX, QMAIL, EXCHANGE...)
PROBLEM:
What do I have to do to use AWStats to analyze my mail log files.
SOLUTION:

-For Sendmail or PostFix log files
+For PostFix or Sendmail log files

1- First, install a mail log convertor like SMA to use it as a pre-processor for AWStats update process (to convert your mail log into a readable format):
-For this, you can download an copy sma (or sma.exe) file and sma.conf into same directory +For this, you can download and copy sma (or sma.exe) file and sma.conf into same directory than awstats.pl file.
Edit sma.conf to change the ClogFormat and ClogSentOnly parameter to :
@@ -313,7 +314,8 @@ LogFile="/pathtosma/sma -O clog -f /pathtosmaconf/sma.conf /pathtomaillog/maillo
LogFormat="%time2 %email %email_r %host %host_r %method %url %code %bytesd"
ValidSMTPCodes="1"
ShowMenu=1 -
ShowMonthDayStats=HB +
ShowMonthStats=HB +
ShowDaysOfMonthStats=HB
ShowDaysOfWeekStats=HB
ShowHoursStats=HB
ShowDomainsStats=0 @@ -337,6 +339,61 @@ LogFile="/pathtosma/sma -O clog -f /pathtosmaconf/sma.conf /pathtomaillog/maillo
Now you can use AWStats as usual (run the update process and read statistics).

+ +For QMail or Sendmail log files
+
+1- First, install a Qmail log convertor like Maillogconv to use it +as a pre-processor for AWStats update process (to convert your Qmail log into a readable format):
+For this, you can download and copy maillogconv file into same directory +than awstats.pl file.
+
+2- Then setup AWStats to analyze Maillogconv processed mail log:
+Copy config awstats.model.conf file to "awstats.mail.conf".
+Modify this new config file: +
+For standard QMail and SendMail logfiles, set
+ +LogFile="/path/to/maillogconv standard /pathtomaillog/maillog |"
+ +And for VAdmin QMail logfiles (multi-host/virtualhost mail servers running vadmin software)
+ +LogFile="/path/to/maillogconv vadmin /pathtomaillog/maillog |"
+ +If the logfiles are compressed, they can be processed this way
+ +LogFile="gzip -cd /var/log/maillog.0.gz | /path/to/maillogconv vadmin /var/log/maillog |"
+ +Then change: + +
LogFormat="%time2 %email %email_r %host %host_r %method %url %code %bytesd" +
ValidSMTPCodes="1" +
ShowMenu=1 +
ShowMonthStats=HB +
ShowDaysOfMonthStats=HB +
ShowDaysOfWeekStats=HB +
ShowHoursStats=HB +
ShowDomainsStats=0 +
ShowHostsStats=HBL +
ShowAuthenticatedUsers=0 +
ShowRobotsStats=0 +
ShowEMailSenders=HBL +
ShowEMailReceivers=HBL +
ShowSessionsStats=0 +
ShowPagesStats=0 +
ShowFileTypesStats=0 +
ShowFileSizesStats=0 +
ShowBrowsersStats=0 +
ShowOSStats=0 +
ShowOriginStats=0 +
ShowKeyphrasesStats=0 +
ShowKeywordsStats=0 +
ShowHTTPErrorsStats=0 + +
+
+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 won't log in a clever way, just forget using AWStats or use a more serious @@ -373,7 +430,8 @@ Modify this new config file:
LogFormat="%host %other %logname %time1 %methodurl %code %bytesd %uabracket %other %other %other %other %other %other %other %other"
LogSeparator="\s+"
ShowMenu=1 -
ShowMonthDayStats=UHB +
ShowMonthStats=UHB +
ShowDaysOfMonthStats=HB
ShowDaysOfWeekStats=HB
ShowHoursStats=HB
ShowDomainsStats=HB @@ -463,7 +521,8 @@ Modify this new config file: LogFile="/pathtomediaserver/mediaserverlog"
LogFormat="c-ip date time cs-uri-stem c-starttime x-duration c-rate c-status c-playerid c-playerversion c-playerlanguage cs(User-Agent) cs(Referer) c-hostexe c-hostexever c-os c-osversion c-cpu filelength filesize avgbandwidth protocol transport audiocodec videocodec channelURL sc-bytes"
ShowMenu=1 -
ShowMonthDayStats=UHB +
ShowMonthStats=UHB +
ShowDaysOfMonthStats=HB
ShowDaysOfWeekStats=HB
ShowHoursStats=HB
ShowDomainsStats=HB