ODBC Driver for MongoDB

Prerequisites

ODBC Driver for MongoDB works under control of an ODBC driver manager. ODBC driver manager is not distributed along with our driver and must be installed separately.

ODBC Driver for MongoDB is compatible with 2 ODBC driver managers:

• iODBC
• UnixODBC

In case when using other ODBC driver managers, ODBC Driver for MongoDB will be installed, but it will require manual modification of configuration files of these managers.

Installation

To install the driver, you should download the archive containing installation files, unpack and run installation with root privileges. See the detailed description of these steps below:

1. Download the archive from Devart website. By default, the archive will be downloaded into the ~/Downloads folder (or the selected one);
2. Run the 'Terminal' program;
3. Navigate to the 'Downloads' folder:

   cd /Users/test/Downloads

   

4. Unpack devartodbcmongo-osx.tar:

   tar -xf devartodbcmongo-osx.tar

   

5. Execute the install.sh script with root user privileges and specify the password:

   sudo ./install.sh

   

6. Read the EULA carefully.

   

7. Agree to the license agreement:

   

8. Select the installation folder for ODBC Driver for MongoDB (or accept the suggested path):

   

9. Select the used ODBC driver manager (iODBC by default):

   

10. Specify the path (or remain the default: /Library/ODBC) to odbc.ini and odbcinst.ini files.

    

11. If you have an activation key, you should create a file, for example with the "mongodb.lic" name on your computer and paste the activation key into it. Then, specify the path to it in order to activate the product.

    To add/update the mongodb.lic file to an already installed driver, you need to create/replace this file in the directory with the installed driver, and save the new activation key to it.

    

Driver is installed successfully.

After the driver is installed, two DSNs with the names DEVART_MONGODB_x64 and DEVART_MONGODB_x86 are created. You can use them to test connection with MONGODB server, we will use DEVART_MONGODB_x64 as a sample. Now perform the following steps:

1. Open the odbc.ini file, the location of which was indicated during the installation. Find the DEVART_MONGODB_x64 section and specify the required connection settings:

   Server=<your MongoDB server address>
   Port=<your MongoDB Port>
   Database=<your MongoDB database name>
   

2. Run the iODBC Test Command utility and test connection using the following command:

   DSN=DEVART_MONGODB_x64

   

See also:

• Installation on Windows
• Installation on Linux