Share this page : facebooktwitterlinkedinmailfacebooktwitterlinkedinmail
Prerequisite

Before install this monitoring tools, we need

  • The Perl to be installed, download it from the official site( either active or strawberry MSI file).
  • Add module CGI: open server role, right click the IIS server, add role, check the CGI under “Application development”:
    IIS_CGI_ISAPI
  • then we need to tell IIS to execute the .pl file by add the script map.
    Open Internet Information Services Manager and open the Handler Mappings interface. image_thumb22Click on the action, “Add Script Map”.

    image

    To allow IIS to execute Perl script files (.pl), configure the new script mapping with the following settings:

    • Request path: *.pl
    • Executable: C:perlbinperl.exe “%s” %s (where ‘C:perl’ is the location where you extracted the Perl binaries)
    • Name: Perl-pl

    image

    In the Request Restrictions dialog, set the Verbs tab to allow the following: GET,HEAD,POST.

    image

    Apply all changes.

    When creating the new script mapping, IIS will ask you if you want to allow this script mapping to run as a CGI application. Answer ‘Yes’ to the dialog.

    image

    Additionally, if Perl scripts will be deployed as CGI files (.cgi), a script mapping will need to be configured for this file type as well:

    • Request path: *.cgi
    • Executable: C:perlbinperl.exe “%s” %s
    • Name: Perl-cgi
    • Verbs: GET,HEAD,POST

    Once finished apply your changes and select ‘Yes’ when IIS prompts you to confirm running the script mapping as an application.

    image

    Once you have configured IIS to run both file types, they will be listed in your Handler Mappings.

Install AWStats

To configure logging in IIS 7, open IIS Manager and select Logging from the server configuration options.

image

In the Logging configuration, set up a single log file per site which rolls over daily using the local time for file naming.

image

Click the Select Fields button and check the boxes next to the required fields.

image

Apply your changes.

Setting Up AWStats

Download the AWStats zip package from Sourceforge. Create a folder called ‘awstats’ in your ‘C:\inetpub\wwwroot’ folder and extract the following files from the downloaded zip file to this folder:

  • /wwwroot/icon
  • /wwwroot/cgi-bin/lang
  • /wwwroot/cgi-bin/lib
  • /wwwroot/cgi-bin/plugins
  • /wwwroot/cgi-bin/awredir.pl
  • /wwwroot/cgi-bin/awstats.model.conf
  • /wwwroot/cgi-bin/awstats.pl

image

Once the files are extracted, copy the “awstats.model.conf” file to a file named “awstats.domain.com.conf” (where domain.com is the site to track), open it in Notepad and configure the options as needed.

The first thing you will need to configure is the log file location, which by default is located here:

  • Server 2003: C:\WINDOWS\system32\LogFiles\W3SVC[IIS_ID]
  • Server 2008: C:\inetpub\logs\LogFiles\W3SVC[IIS_ID]

You can find the IIS ID by looking at the master site listing in IIS Manager and noting the value in the ID column next to the respective site.

image

Set the options in the configuration file. This file has a very good explanation of what each option does, so take a few minutes to review them. Here are a few settings of interest according to the setup above:

  • LogFile=”C:\inetpub\logs\LogFiles\W3SVC1\u_ex%YY-24%MM-24%DD-24.log”
    (Server 2008/IIS 7 where the stats are calculated daily)
  • Change the LogType value to “W” for analyzing web log files
  • LogFormat=”date time cs-method cs-uri-stem cs-username c-ip cs-version cs(User-Agent) cs(Referer) sc-status sc-bytes”
  • SiteDomain=”domain.com”
  • DirIcons=”icon”
  • DefaultFile=”index.php index.html”
  • Set the AllowToUpdateStatsFromBrowser parameter to 1 if you don’t have command line access and have only cgi access.

Once you have saved your configuration file, run the AWStats Perl Script to compile the stats data. The command looks like this:

C:\inetpub\wwwroot\awstats>C:Perl\bin\perl.exe awstats.pl -config=domain.com

image

The above command assumes the following (configuration used for this article):

  • The folder “C:inetpubwwwrootawstats” serves the stats through IIS.
  • Perl was installed to the “C:Perl” directory.
  • The config file is named “awstats.domain.com.conf”.

Finally, you can access the stats data through your browser. This URL is publically available for anyone to view unless you configure security via IIS. To test our configuration, just browse to:

http://localhost/awstats/awstats.pl?config=domain.com