Database requirement

The RDBMS driver connects Niagara stations to an RDBMS running in the Supervisor station. The purpose of this database is to import and export historical data and to populate control points with the results of SQL queries against the database. The RDBMS driver supports four third-party databases: MySQL, OracleDatabase or SqlServerDatabase, and HsqlDbDatabase.

An HsqlDbDatabase is configured at the factory to run in each remote controller. HSQLDB (Hyperthreaded Structured Query Language Database) is maintained by the HSQL Development Group and is available under a BSD-type (free) license. For more information about HSQLDB, refer to: http://hsqldb.org/. The driver supports no other third-party database in a remote controller.

One of the other third-party databases is required to run in the Supervisor PC. It is beyond the scope of this document to describe how to set up one of these databases.

Using Workbench, you install, configure and test an RDBMS driver connection to one of these database servers:

Note: Refer to the Niagara 4 Installation Guide for the latest information about supported database versions and supported operating systems.

MySQL database

The MySQL database is an Oracle Corporation RDBMS that requires a GPL (General Purpose License) or proprietary license. In addition to installing the database on your Supervisor computer, the MySQL database requires a Java Data Base Connectivity (JDBC) connector (Connector/J).

You download the connector from: http://dev.mysql.com. It may be named mysql-connector-java-x.x.x.jar, where x.x.x is the version number.

Note: The rdbMySQL-MySQLDatabase component was tested with the MySQL connector version “mysql-connector—java–8.0.24”. Use of earlier versions of this connector is not recommended and not supported.

You may verify with the framework release documentation that the version you downloaded is compatible with the framework, then change the connector name to this generic name: mysql-connector-java.jar and copy it to this folder: C:\Niagara\Niagara.home\jre\lib\ext, where C: represents your drive, and Niagara\Niagara_home represents the location and version number of your unique N4 installation.

OracleDatabase

The OracleDatabase is an Oracle Corporation RDBMS that requires a proprietary license. The supported version may be more recent than version 9i. Contact your support channel for more up-to-date information. For more information about Oracle, refer to: http://www.oracle.com/database/index.html.

SqlServerDatabase

The SqlServerDatabase is a Microsoft RDBMS that requires a proprietary license. For more information about Microsoft SQL Server, refer to: http://www.microsoft.com/sql/default.mspx.

The RDBMS driver does not support Windows Authentication alone. You must have selected SQL Server Authentication (mixed mode) for any user of this database. This is an SQL Server login property, not a Niagara property.

Secure database connection

To prevent malicious hacker attacks on the database or station, the station must be able to authenticate the database server (especially if it is remote) and communication between station and server must be encrypted.