This version of the documentation is archived and no longer supported.

Install BI Connector on Red Hat Enterprise-based Linux


The MongoDB Connector for BI and associated utilities are compatible only with MongoDB server version 3.2 or greater.

To set up MongoDB Connector for BI with a business intelligence tool such as Tableau, follow the steps on this page.


  • OpenSSL installed on your host.

To verify OpenSSL is installed on your system, run the following command:

rpm -qa | grep -i openssl

If OpenSSL is not installed, use your package manager to install it.

MongoDB User Permissions

If your MongoDB instance uses authentication, your BI Connector instance must also use authentication. The user that connects to MongoDB via the mongosqld program must have permission to list all of the databases in your MongoDB deployment, as well as permission to read from all the namespaces to wish to read data from.

For more details about MongoDB user permissions in BI Connector, see User Permissions for Cached Sampling.

Install the BI Connector


Download the MongoDB Connector for BI.

Download the BI Connector from the MongoDB Download Center.


Install the MongoDB Connector for BI.

  1. Extract the downloaded .tar archive:

    tar -xvzf mongodb-bi-linux-{arch}-{platform}-{version}.tgz
  2. Install the programs within the bin/ directory into a directory listed in your system PATH:

    sudo install -m755 bin/mongo* /usr/bin/

Install the Authentication Plugin

If your MongoDB instance uses authentication, your BI Connector instance also needs to use authentication. The BI Connector authentication plugin simplifies the process by authenticating directly against MongoDB without SSL certificates.

Launch the BI Connector

You are now ready to launch the BI Connector. The following guide contains detailed information on BI Connector configuration, schema generation, and launch options: