Microsoft® Site Server Express Usage Import and Report Writer Readme File

Start Page

Readme

Microsoft^® Site Server Express Usage Import and Report Writer Release Notes

Program Elements Installed
System Requirements
Getting Started
Known Issues

Program Elements Installed

You can install the following Usage Import and Report Writer files on your computer:

Import.exe: Usage Import.
Analysis.exe: the command line Report Writer module.
AnalysisGui.exe: the graphical interface Report Writer module.
MSUsage.mdb: a Microsoft® Access-compatible database that will be used to hold information from your log files.
Template.zip: a zipped template for new files with the format of MSUsage.mdb. Unzip this template when you want to create new databases.

Unless you specify otherwise in your setup, the Windows default directory is \Program Files\UAExpress, and the group that is created is Microsoft Site Server Express under the IIS program group:

The following folders are created in the main program directory.

Cache
Catalog
ISAPI
Message
Open Visits
Reports
Schedule
Utility

The Catalog folder contains the standard analysis report forms (*.mfa). It is also the default folder for storing any new analysis reports that you create.

System Requirements

Microsoft® Windows NT®
Pentium processor
32 MB of memory is recommended (16 MB minimum)
15 MB disk space for program files, plus space for your log files
Optional:
Internet connection to look up HTML titles, resolve IP addresses, and run Whois queries
Microsoft Word version 7 or later to produce Word reports
Microsoft Excel version 7 or later to produce spreadsheet reports
HTML 2 Browser (tables) or later to display HTML reports

Database supported:

Microsoft® Access

Note Microsoft® Access is not required for Access-compatible versions of Usage Import or Report Writer.

Getting Started

Importing a Log File

Obtain a copy of your Internet server log file.
Start Usage Import.
Configure an Internet site using the Server manager (from the File menu or from the toolbar).
Create a Log data source with the appropriate log file type by right-clicking the Log data sources icon, and then clicking New.
Specify a server of the appropriate type (FTP, Gopher, or WWW) by right-clicking the scroll icon, and then clicking New.
Configure a site by right-clicking the newly created server icon, and then clicking New.
Open the Log file manager (from the File menu or from the toolbar) and type in the path to your log file that you obtained above, or identify it using the Browse button.
Press the green Start import button on the toolbar to begin the import.

Note The first time you import a log file, the program will walk you through these steps.

Creating a Report

Start Report Writer; this may run concurrently with Usage Import.
Click the Create a report from the catalog option.
Select a report to run, such as Executive Summary.
Click Finish on the first option panel. You can explore the full range of options available in this sequence of panels later on.
From the schematic representation of your report content, click the green Create analysis report button. (Default is an HTML report which will be opened with your browser.)

You have now successfully completed a session with Usage Import and Report Writer.

Extended Logging

To install hyperext_log.dll download

Copy hyperext_log.dll into the IIS install directory on your server.

Run REGEDT32.EXE

Go to the HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\W3SCVC\Parameters key.

Edit the "Filter Dlls" by double-clicking it.

Add ,c:\path\to\hyperext_log.dll to the value (including the comma).

Save the value.

Go to the HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\UsageAnalyst\ISAPI key. If you need to create some of the keys click the Add Key on the Edit menu.

Add a new string value named ServerDomain by clicking New on the Edit menu and selecting String Value. Set the value of this item to the DNS domain name of the server to which the cookies will apply. For example,

for www.microsoft.com, set this value to microsoft.com