Prerequisite checklist
Use of any of the databases mentioned in this document is subject to the terms and conditions of the respective database supplier. For additional copyright and licensing information, please refer to the individual supplier’s documentation.
In addition to the right to use a specific database, you must have:
-
- A
Figure 2. License file showing database licenses
The screen capture shows the database licenses in a
tridium.licensefile. - A relational database installed on the Supervisor PC: SqlServer, Oracle or MySQL. Embedded (remote) controllers support only the HsqlDbDatabase database. How to install a third-party relational database is beyond the scope of this guide. Look for help on the Internet.
- The IP address to establish a network connection to the database host (this can be localhost for your PC).
- If you are using Oracle’s MySQL database, you need the MySQL Connector installed in your
$niagara.home/jre/lib/ext/folder. You must rename the connector to mysql-connector-java.jar. - Appropriate rights for the required database access.
- PKI (Public Key Infrastructure)-TLS (Transport Layer Security) secure communication provided by a server certificate for the
database connection and the root CA (Certificate Authority) certificate used to sign the server certificate in the platform/station’s
Trust Store. While you can disable secure communication, the best practice is to always enable and implement secure connection
that both encrypts and authenticates the database server.
If you are using a certificate that was not signed by a CA in the System Trust Store (that is, if your company serves as its own CA), you must import the root CA (signer) certificate into your station's User Trust Store. The server certificate for the database, which you select from the
My SQL Server Certdrop–down list on the database Property Sheet must have been signed by a third-party root CA certificate in the System Trust Store or by your company’s root CA certificate in the User Trust Store.
You must know:
- The name of the database instance
- The user name and password to log in to the database
- If the database is using a non-default port number, the port number
- The name of the root CA certificate used to sign the server certificate presented by the database server. This certificate must be in the platform/station Trust Store. The server certificate is in the platform/station’s User Key Store.