MongoDB Document Database

This will require Data Admin privileges to setup and Builder for implementation.

iDashboards is able to connect to the MongoDB Document Database by using an open source Unity JDBC driver. 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

Unity JDBC for Mongo Purchased

Data Connection

Follow the steps below to set up a data source in iDashboards Admin or Data Hub.

1. Download the required driver:
   • Required file: UnityJDBC_Trial_Install.jar
2. 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
3. Navigate to the installed directory and copy the mongodb_unityjdbc_full.jar
4. Paste the driver, which is .jar file, to the following location:
   • <iDashboards Installation Folder>\ivizgroup\drivers
5. Restart the iDashboards service (iDashboardsSRV)
6. Login to iDashboards Admin
7. Click the Data Sources
8. Click New
9. In the Create a Data Source window fill out the highlighted sections:Additional information regarding the Generic JDBC driver for the Unity Driver configuration:
   •  
   • Data Source Type: Generic JDBC
   • db.url: jdbc:mongo://server_name:27017/database_name
   • db.driverClass: mongodb.jdbc.MongoDriver
10. Click Save

For More Information:

• Creating a Database URL (Connection String)
• Mongo DB Document Database JDBC Documentation
• iDashboards Admin Manual 10. Managing Data Sources

Disclaimer: iDashboards Technical Support Engineers are not proficient in the Management and Integration of every API that exists as new APIs are being created everyday with each company that wants to provide seamless integration with other software. However, we do our best to help you make these connections because we want to assist you in your success. If you do not see an article for a connection you would like to make please contact iDashboards Support and know that it will take a bit of time to figure out what is necessary for this integration.

If the above is unable to resolve the issue, then please contact iDashboards Support for further assistance.