conf file, from step 7) and create an index file that's used to build the reports. This will parse your log files (as defined in the "LogFile" parameter in your. Where "domino" in the "-config=domino" parameter refers to the middle name in the "" filename from step 7. Run your initial update by opening a command prompt, navigating to the "cgi-bin" directory from step 6, and entering the following command: The install for ActivePerl doesn't require a reboot, so you can actually install it on a live Domino server if you're feeling brave.ĩ. For Windows, you can use the free ActivePerl distribution at. If you don't have Perl installed on your server, download and install it. optionally add the sample Notes file tracking report additions ( see below) to the # EXTRA SECTIONS section near the bottom of the file.Ĩ. Change "AllowToUpdateStatsFromBrowser" to "1" if you want to be able to update the stats from a browser (DANGER - this could be resource intensive on a busy server) otherwise, if you will be doing updates programmatically, it should be "0".Change "DirIcons" to the relative HTTP path of your icon directory from step 5 above ("./awstats/icon" should work).Change "SiteDomain" to be the main domain name for this server (like ".Notice that the command ends with a vertical bar (pipe) character - this is important. Where "d:/domino/weblogs" is the path to the log files you defined in step 1 (make sure you use "/" as a directory separator, even on Windows). Open the file in a text editor and make the following changes (please note that Windows users will not be able to read the file very well using Notepad because it uses Unix-style linefeeds, so you'll want to open it in Wordpad or Crimson Editor or something like that): If the file is marked as "Read-Only", you'll want to go to the file properties and uncheck that flag so you can edit it. From the Domino "cgi-bin" directory, make a copy of the file. Copy the contents of the "files from awstats and put them in your "cgi-bin" directory.ħ. Copy the "wwwroot\icon" directory from the awstats files to %DOMINO_DATA_DIR%\domino\html\awstats (for example: "d:\domino\data\domino\html\awstats\icon")Ħ. Create a directory called "awstats" under the %DOMINO_DATA_DIR%\domino\html directory on your server (for example, "d:\domino\data\domino\html\awstats").ĥ. Extract AWStats.zip to a directory of your choice.Ĥ. Save and close the server document, and restart HTTP on the server.ģ. Directory for log files = "d:\domino\weblogs".Enable logging to Domlog.nsf = "Disabled".Enable logging to log files = "Enabled".Max size of access log = "0" (release 6 and higher).Max Log Entry Length = "10 kb" (release 6 and higher). Open the server document in your Public Name and Address Book/Domino Directory and go to the "Internet Protocols - HTTP" tab, and set the following fields: Set up your Domino server to log to text files. Instructions for setting up AWStats on Dominoġ. I encourage you to also refer to both the Domino Administrator Help and the AWStats documentation for more information and explanation. Here are some pretty basic step-by-step directions on how to set up your Lotus Domino server to use the AWStats tool (note that when I make reference to "%DOMINO_DATA_DIR%" below, I mean the Domino data directory on your server - usually something like "d:\domino\data"). As an example for how nice the reports look, you can look at the stats for the AWStats site. It can also be used on Windows, Unix, or Linux servers, because it's just a series or Perl scripts (very complex ones, but that's what they are). One of the nicer log reporting tools available is the free and open-source AWStats application, which not only has really nice default reporting options, but is also very customizable and has a number of plug-ins. Many people make modifications to the DomLog.nsf database design, which can be useful, but logging stats to a database can cause performance problems on busy servers, and a large DomLog database is pretty slow and unwieldy in the middle of the day.įortunately, if you send your web log stats to a text file, it gets written in a standard logging format which can be parsed and sliced and diced by a number of popular reporting applications. As a web server, Domino can send traffic information to text files or to a DomLog database, but there's no real reporting built-in, so you're stuck with reams of information and no good way to look at it. Lotus Notes/Domino doesn't have very good built-in web log reporting functionality (and by that I'm referring to logs of website traffic, not blogs). Nsftools - Using AWStats To Report On Domino Web Logs Using AWStats To Report On Domino Web Logs
0 Comments
Leave a Reply. |