Hurricane SQL Audit APPLICATION NOTE

Transcription

1 Hurricane SQL Audit APPLICATION NOTE May 2015 Cutting edge simplicity

2 Introduction The Hurricane SQL Audit service provides an alternate archive of Hurricane historical events using Microsoft SQL server. Simple database schema using standard textual fields allow easy queries using 3 rd party tools. Requirements The following minimum requirements are needed to the implement Hurricane SQL Audit service. 1) Hurricane Enterprise (Version 2.0 or later) 2) Microsoft SQL Server (2008/2008 R2/2012/2014) Express Edition Standard Edition Enterprise Edition Some installations may require experience in SQL Server configuration on the part of the end user. Installation and Configuration The SQL Audit service is installed by default when installing the Enterprise version of Hurricane. Microsoft SQL Server must be configured and operation in order to use the SQL Audit functionality. Configuration of the SQL Audit service is performed from within the main Hurricane client or the Hurricane System View application. After launching the Hurricane client, select Edit -> Configure System Properties. When the System Properties dialog is displayed, select the SQL tab along the top. From within the System View client s Service View, right click the SQL Audit Service and select Service Properties from the popup menu. Hurricane Page 2 of 5

3 The following items must be configured for proper operation of the SQL Audit service. Server Enter the computer name of the system hosting the Microsoft SQL server software. User/Password Enter the database credentials required for connection and authentication with Microsoft SQL Server. These credentials must have been previously created by the database administrator. Trusted Connection This option allows database server authentication using the credentials provided during Windows logon. Database Authentication This option uses the User and Password values entered previously when connecting and authenticating with Microsoft SQL Server, Hurricane Page 3 of 5

4 Managed Tables If this option is selected, Hurricane SQL Audit service will create new tables daily for the archiving of historical events. Tables are created at midnight using the naming convention AYYMMDDHHMM where: YY represents the last two digits of the current year MM represents the 2 digit month 1-12 DD represents the 2 digit day of the month 1-31 HH represents the 2 digit hour MM represents the 2 digit minute Hurricane will also automatically drop tables from the database when the number of tables reaches the value specified in the Audit Retain configuration parameter (see the Audit table under Hurricane properties). The Managed tables option allows Hurricane to control the amount of data accumulated over the years thereby requiring no intervention on the operators part. Unmanaged Tables This option creates a single table named HAudit. Event data is written to this database table without regard to size. The end user/database administrator is responsible for periodically archiving this data over time. Monitoring Service Status The current SQL Audit service status can be displayed from within the System View application. Select the SQL Connection item from the application s left panel. The current service status is displayed in the right window. Hurricane Page 4 of 5

5 Database and Table Schema Tables created by the SQL Audit service use the following table structure. Column Name Data Type Description Time Var Char 5 Event Time HH:MM Date Var Char 8 Event date DD-MM-YY Event Var Char 40 Event description Name Var Char 30 Card holder name if applicable Card Var Char 6 Card if number if applicable Operator Var Char 10 Operator name if applicable Location Var Char 30 Event location Hurricane Page 5 of 5