Web Reporting

Introduced with version 2.11 of EventSentry are ASP web pages that can be used to generate database reports used by the ODBC action of EventSentry.

•	Windows 2000 (or higher) based computer with the Internet Information Server, capable of running ASP pages.

During the installation make sure that you select the Database Support option. This will install all ASP web reports files into the Web sub folder of the EventSentry installation directory.

It is recommended that you also select the Setup IIS option during the installation. This option will automatically setup a virtual directory on your web server, which you can access by navigating to http://localhost/EventSentry/ (replace "localhost" with host name of the computer where IIS is running). If the IIS web server is located on a different computer, then you can either run the setup again on that computer or configure IIS manually by coping all files from the Web subdirectory to that computer.

Note: You cannot run the EventSentry setup on one computer and configure IIS automatically on another computer.

When running a web server other than IIS, simply serve the appropriate directory (..\Program Files\EventSentry\Web) through the web server.

Make sure to password-protect these web pages as the event logs may contain security-sensitive information.

After configuring the web server, open the configuration file WebReportsConfig.xml to verify or edit the ODBC DSN Name, username and password. You can find this file in the folder where you installed EventSentry or by clicking on the Configure Web Reports shortcut in the EventSentry start menu folder.

You can now navigate with your web browser to the index page, e.g. http://yourserver/eventsentry/index.asp.

A manual installation of the web reports can also be performed, however the web reports files will need to have been installed on a computer beforehand.

Copy all files from the \Program Files\EventSentry\Web directory to the computer running the web server, e.g. \Inetpub\wwwroot\EventSentry\Web. You should make this directory available (share) to all EventSentry users through IIS. You can skip this step if you point the virtual directory directly to the \Program Files\EventSentry\Web later.

Copy the three XML files from the \Program Files\EventSentry directory (WebReports.xml, WebReportsConfig.xml, WebReportsLanguages.xml) to the parent directory of the directory where the main ASP files installed, e.g. \Inetpub\Wwwroot\EventSentry. You can skip this step if you point the virtual directory directly to the \Program Files\EventSentry\Web later.

3.	Copy the file eventsentry_iis.dll to a folder on the web server and register it by running "regsvr32 eventsentry_iis.dll". You can un-register the DLL anytime by running "regsvr32 /u eventsentry_iis.dll".

4.	Change the NTFS permissions on the parent folder to only allow authorized users access to the web reports. Remember that anybody with access to those files will be able to view the event logs of your entire organization, so make sure you assign the permissions carefully.

5.	Create an ODBC system DSN that points to the database, using the eventsentry_web user to login. You can also use an ODBC connection string in the ODBCDSN field.

1.	Serve (share) the directory containing the ASP files (\Program Files\EventSentry\Web by default, or \Inetpub\Wwwroot\EventSentry\Web) using a Virtual Directory through the web server using IIS's Internet Information Services Manager.

2.	When using Windows Server 2003, make sure that the ASP component in IIS is installed (Control Panel -> Add/Remove Programs)

Configure the security settings of the virtual directory to not allow anonymous access. It is recommended that you use "Integrated Windows Authentication" instead of "Basic Authentication". This will not require you to specify a password when using Internet Explorer and will also not transmit your password in clear text.

5.	Set the default file for the Virtual Directory to index.asp in the Documents tab, it is enough to only have the index.asp file in the list.

The web reports include the following three XML files, which are stored in the EventSentry installation directory by default:

This is the main configuration file for the web reports and automatically configured during the product installation. The file contains the database connection properties (DSN, password etc.) and the default selections for most search dialogs (e.g. default search limit).

This file needs to be configured whenever you change the name of the System DSN or the password of the eventsentry_web user. It is recommended that you edit this file through the Profile Editor, but you can also open the WebReportsConfig.xml file by clicking on "Configure Web Reports" in the EventSentry start menu folder.

These files enables the translation of the web reports into other languages. You can currently configure the web reports to display in the following languages:

•	English (default)

WebReportsLanguages-EN.xml

•

German

WebReportsLanguages-DE.xml

•

Japanese

WebReportsLanguages-JP.xml

•	Portuguese

WebReportsLanguages-PT_BR.xml

•

French

WebReportsLanguages-FR.xml

•

Korean

WebReportsLanguages-KR.xml

It is recommended that install all language files with the web reports, however it is possible to only install the language file that you configured the web reports for. For example, if you configured the web reports for German, then it is enough to install the WebReportsLanguages-DE.xml language file.

If you would like to contribute and offer the translation of an additional language then please email us at support@netikus.net and let us know which language you would like to translate into.

The WebReports.xml file contains SQL queries that are used throughout the web reports. It is not recommended that you edit this file.