EventTracker: Configuring DLA Extension for AWStats report AWStats Reports Prism Microsystems Corporate Headquarter Date: October 18, 2011 8815 Centre Park Drive Columbia MD 21045 (+1) 410.953.6776 (+1) 410.953.6780 U.S. Toll Free: 877.333.1433
Abstract AWStats is a free powerful tool with lots of features that generates advanced web, streaming, ftp or mail server statistics, graphically. This log analyzer works as a CGI or from command line and shows you all possible information your log contains, in few graphical web pages. This document is designed to help Install, Configure and import AWStats generated report to EventTracker using DLA-Extension feature. The information contained in this document represents the current view of Prism Microsystems, Inc. on the issues discussed as of the date of publication. Because Prism Microsystems, Inc. must respond to changing market conditions, it should not be interpreted to be a commitment on the part of Prism Microsystems, Inc. and Prism Microsystems, Inc. cannot guarantee the accuracy of any information presented after the date of publication. This document is for informational purposes only. Prism Microsystems, Inc. MAKES NO WARRANTIES, EXPRESS OR IMPLIED, AS TO THE INFORMATION IN THIS DOCUMENT. Complying with all applicable copyright laws is the responsibility of the user. Without limiting the rights under copyright, this Guide may be freely distributed without permission from Prism, as long as its content is unaltered, nothing is added to the content and credit to Prism is provided. Prism Microsystems, Inc. may have patents, patent applications, trademarks, copyrights, or other intellectual property rights covering subject matter in this document. Except as expressly provided in any written license agreement from Prism Microsystems, Inc. the furnishing of this document does not give you any license to these patents, trademarks, copyrights, or other intellectual property. The example companies, organizations, products, people and events depicted herein are fictitious. No association with any real company, organization, product, person or event is intended or should be inferred. 2011 Prism Microsystems, Inc. All rights reserved. The names of actual companies and products mentioned herein may be the trademarks of their respective owners. Prism Microsystems, Inc. 2
Table of Contents Purpose... 4 Intended audience... 4 Install and Configure AWStats... 5 Install AWStats package if not installed.... 5 Configure AWStats... 5 Processing building and reading reports... 7 Configure DLA-Extension to import AWStats report to EventTracker.... 7 Viewing Reports in EventTracker... 11 Prism Microsystems, Inc. 3
Purpose The purpose of this document is to help users to Install, Configure, Schedule AWStats report generation and configure DLA Extension to import report in EventTracker. Intended audience EventTracker users who wish to import AWStats report to EventTracker via DLA Extension. Prism Microsystems, Inc. 4
Install and Configure AWStats Install AWStats package if not installed. (Preferable to install on EventTracker Console machine so reports generated by this will be available on same machine) Download Activeperl installer and install. http://www.activestate.com/activeperl/downloads. Download and Install AWStats installer for windows. http://sourceforge.net/projects/awstats/files/awstats/7.0/awstats-7.0.exe. Configure AWStats Once AWStats is installed. Run awstats_configure.pl from install folder. 1. Open command prompt. 2. Change directory to AWSinstall folder C:\Program Files\AWStats\tools> awstats_configure.pl and follow the instruction. 3. Enter apache webserver install path, if installed or enter none to skip. Figure 1 4. Type Y, and then press Enter when asked to build a new Awstats config/profile. Prism Microsystems, Inc. 5
Figure 2 5. Enter profile name. Ex: - Mywebsite. Awstats configuration file will be created in the install directory: C:\Program Files\AWStats\wwwroot\cgi-bin\. NOTE: Repeat the steps for each different webserver logs by providing website name as profile name. For each profile one configuration file will be created.. Open Awstats configuration file from AWStats install path (default C:\Program Files\AWStats\wwwroot\cgi-bin\ on windows ). Locate main setup section and verify following options are set properly in each configuration file. Suggested to create one Logfile folder. Under that create individual folder for each webserver logs. LogFile = C:\Program Files\apache\access.log for apache log or LogFile = C:\WINDOWS\system32\LogFiles\W3SVC1\ex%YY-24%MM-24%DD-24.log for IIS log LogType=W for webserver log LogFormat=1 for apache or 2 for IIS (Refer AWStats manual for more options). LogSeparator=" " SiteDomain=WWW.mywebserver.com BuildReportFormat=html Prism Microsystems, Inc. 6
Processing building and reading reports 1. Open Command Prompt. 2. Change directory to AWstats tools path. 3. Run following commands. perl "C:\Program Files (x86)\awstats\wwwroot\cgi-bin\awstats.pl" -config=mywebsite update (Source webserver log file available in configured path will be parsed and AWSTATS statistics database file will be created). perl "C:\Program Files (x86)\awstats\wwwroot\cgi-bin\awstats.pl" -config=v7demo - output -staticlinks > F:\Logfiles\AWStatsReports\Mywebsite.html (This will generate meaning full graphical webserver statistics html report and report will be available in output path, in my example F:\Logfiles\AWStatsReports\Mywebsite.html ) Above steps should be repeated for each profile. This can be automated by creating batch script and scheduling it via task scheduler. Configure DLA-Extension to import AWStats report to EventTracker. 1. Open EventTracker Enterpri se 2. Type valid user credentials and then click Login. 3. Click the Admin drop-down, and then select Manager Figure 3: Click Admin >> Manager Prism Microsystems, Inc. 7
1. EventTracker displays the Manager Configuration page. 2. Click Direct Log Archive/NetFlow Receiver tab. Figure 4 Figure 5 3. Click Direct log file archiving from external source s checkbox, and then select a port from Associated virtual collection point dropdown. 4. Click the Add button. 5. EventTracker displays the Direct Archiver Configuration pop-up window. Prism Microsystems, Inc. 8
Figure 6: Direct Archiver Configuration Select DLA-Extension from Type dropdown. Type AWstatsreport.ini as Configuration Name. Click Browse and select path of AWStats html report file, and then click Configure. Figure 7 EventTracker displays the Direct Archiver Configuration pop-up window. Prism Microsystems, Inc. 9
Figure 8 Type *.html in File Pattern text box. Select Move to Reports from Action dropdown. Select Operation from Report De stination dropdown. Select Send E-mail to receive the report on e-mail. Type a valid sender e-mail address in the E-mail Id field, and a brief description in subject field. OR Select Send as attachment options to receive reports in attached format or select Send only notification options to receive notification. 4. Click the Add button, and then click the Save button. Prism Microsystems, Inc. 10
Figure 9 NOTE: EventTracker displays Audit reports in Operation dashboard in EventTrackerWeb. Viewing Reports in EventTracker 1. Navigate to Operation, and the click Reports. Prism Microsystems, Inc. 11
Figure 10: Operations >> Reports 2. Once report files are imported will be displayed in Reports page. Click the report title hyperlink to view the report. Figure 11: Reports Prism Microsystems, Inc. 12