Web Reports

 Top  Previous  Next

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

 

1. Requirements

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

 

2a. Installation with EventSentry Installer

During the installation, choose a Custom Installation and make sure that you select the Database Support option. This will install all ASP web reports files into the Web subfolder of the EventSentry installation directory.

 

If you plan on using the ASP pages with IIS, then it is recommended that you also select the Setup IIS option during the installation. A virtual directory will automatically be setup on your web server, which you should be able to access by navigating to http://localhost/EventSentry/. 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.

 

2b. Manual Installation

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

 

File Installation & Configuration

1.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.
2.Copy the two XML files from the \Program Files\EventSentry directory (WebReports.xml, WebReportsConfig.xml) to the parent directory of the directory where the main ASP files installed, e.g. \Inetpub\Wwwroot\EventSentry.
3.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.
4.Create an ODBC system DSN that points to the database, using the eventsentry_web user to login.
5.Open the configuration file WebReportsConfig.xml file and set the ODBC DSN Name, username and password

 

IIS Configuration

1.Serve (share) the directory containing the ASP files using a Virtual Directory through the web server using IIS's Internet Information Services Manager.
2.Make sure that the ASP component in IIS is installed (Control Panel -> Add/Remove Programs)
3.Configure the virtual directory to allow "Script Only" execution and "Read" access
4.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.

 

3. Included Files

The web reports include the following files:

 

       WebReportsConfig.xml**

               SPECIFIES DATABASE LOGIN INFORMATION AND CONFIGURATION PARAMETERS

 

       eventsentry_db_inc.asp

               GENERIC INCLUDE FILE CONTAINING FUNCTIONS AND DEFINITIONS

 

       index.asp

               THE MAIN WEB PAGE SHOWING A DATABASE SUMMARY

 

       eventsentry_db.asp

               THE SEARCH PAGE. USE THIS WEB PAGE TO QUERY THE EVENTSENTRY DATABASE.

 

       eventsentry_db_detail.asp

               SHOWS THE DETAILS OF AN EVENT LOG ENTRY, CALLED FROM eventsentry_db.asp.

 

       eventsentry_location_mapping.asp

               ASSIGN COMPUTERS TO LOCATIONS, CALLED FROM eventsentry_db.asp

 

       eventsentry_heartbeat_status.asp

               CURRENT HEARTBEAT STATUS, CALLED FROM index.asp.

 

       eventsentry_heartbeat_history.asp

               HEARTBEAT HISTORY, CALLED FROM OTHER HEARTBEAT PAGES.

 

       eventsentry_heartbeat_uptime.asp

               HEARTBEAT UPTIME, CALLED FROM OTHER HEARTBEAT PAGES.

 

       eventsentry_diskspace.asp

               SHOWS DISKSPACE STATISTICS, CALLED FROM index.asp.

 

       eventsentry_diskreport.asp

               SHOWS DISKSPACE REPORTS, CALLED FROM index.asp.

 

       eventsentry_environment.asp

               SHOWS ENVIRONMENT STATISTICS, CALLED FROM index.asp.

 

       eventsentry_fc_xml.asp

               INTERNAL PAGES USED FOR FLASH CHARTS, CALLED FROM eventsentry_diskspace.asp.

 

       eventsentry_fc_xml_environment.asp

               INTERNAL PAGES USED FOR FLASH CHARTS, CALLED FROM eventsentry_environment.asp.

 

       eventsentry_tracking_process.asp

               SEARCH PAGE FOR PROCESSES, CALLED FROM index.asp.

 

       eventsentry_header.asp & eventsentry_footer.asp

               HEADER & FOOTER FILES NEEDED BY ALL FILES

 

       *.js, *.css, *.swf

               ADDITIONAL JAVASCRIPT, STYLESHEET AND SHOCKWAVE FILES NEEDED

 

       images sub directory

               IMAGES USED ON ALL PAGES

 

[ ** These files may need to be edited ]