A JDBC driver is a software component enabling a Java application to interact with a database.
To connect with individual databases, JDBC (the Java Database Connectivity API) requires drivers for
each database. The JDBC driver gives out the connection to the database and implements the protocol
for transferring the query and result between client and database.
iDashboards implements native protocols and do not require additional software installed on the
driver host. In other words, iDashboards provides driver connectivity with JDBC Data Source via
the specified driver. This document explains a step-by-step procedure to create the Data Source.
MongoDB directly only offers a Java connector in the form of a jar file which will not function for the use of a JDBC driver. To connect we will use the Unity JDBC driver to MongoDB. As this is a third party driver there may be an added cost to the driver. Evaluation periods of this driver are currently available.
Unity JDBC for Mongo Trial: http://www.unityjdbc.com/download.php?type=mongodb
Unity JDBC for Mongo Purchased: http://www.unityjdbc.com/purchase.php
Data Source Connectivity
Follow the steps below to set up a data source in the iDashboards Admin application for connectivity to the database.
1. Download the required driver:
- Required file is the “UnityJDBC_Trial_Install.jar”
- Run the .jar installer in command prompt by using the below syntax (pathing may be required)
- java –jar UnityJDBC_Trial_Install.jar
- Complete the installer process
- Navigate to the installed directory and copy the “mongodb_unityjdbc_full.jar”
2. Copy the driver, which is implemented as a .jar file, to <iDashboards Installation
3. Restart iDashboards service.
4. Login to iDashboards Admin application, and click the ‘Data Source’ tab.
5. In the Data Sources Section, set the ‘(new)’ data source type to ‘Generic JDBC’, and click on the ‘Add Data Source’ button.
6. Under the ‘Add Data Source’ window, enter the necessary information to connect to the database.
Additional information regarding the Generic JDBC option:
Unity Driver configuration information:
- db.url: jdbc:mongo://server_name:27017/database_name
- db.driverClass: mongodb.jdbc.MongoDriver