Preparing the MongoDB Environment

How to:

Configure the Java CLASSPATH

The following components are the prerequisites needed to use the adapter for MongoDB:

Java. To use this Java-based adapter, you must have the JDK installed. MongoDB requires Version 1.8 or later. Java can be downloaded from http://www.java.com.
The location of the JDK must be specified in an environment variable.

If you are using Linux, add a line to your profile with the location where Java is installed. For example:
```
export JAVA_HOME=/usr/java/jdk1.8.0_45 
```
Alternatively, add this variable to the server environment. From the Data Management Console or the Web Console, go to the Workspace page. Expand the Configuration Files and Miscellaneous folders. Double-click Environment - edaenv.cfg and add JAVA_HOME to the file. For example
```
JAVA_HOME=/usr/java/jdk1.8.0_45
```
If you are using Windows, right-click Computer and click Properties. Then select Advanced System Settings and click Environment Variables. Add the locations to your PATH variable. For example:
```
C:\Program Files\Java\jdk8\bin\server;C:\Program Files\Java\jdk8\bin;
```
BI Connector JDBC Driver for MongoDB. The BI Connector JDBC driver is available from mongoDB website:
```
mysql-connector-java-5.1.43/mysql-connector-java-5.1.43-bin.jar
```

Procedure: How to Configure the Java CLASSPATH

The location of the driver jar files must be specified to the server. You must extract the jar files to a location on your system and specify their location.

This can be done in the system CLASSPATH or in the DataMigrator or WebFOCUS Reporting Server IBI_CLASSPATH variable as follows:

From the Web Console sidebar, click Workspace

or

From the Data Management Console, expand the Workspace folder.
Expand the Java Services folder. Right-click DEFAULT and select Properties.

The Java Services Configuration page opens.
Click the chevrons to expand Class Path.
In the IBI_CLASSPATH box, enter the full location of the jar files shown below. The file names must be entered one per line.
```
path/mysql-connector-java-5.1.43/mysql-connector-java-5.1.43-bin.jar
```
Note: For a server running on Windows, use Windows syntax for directory names. For example:
```
directory\ mysql-connector-java-5.1.43/mysql-connector-java-5.1.43-bin.jar
```
Scroll down and click the Save and Restart Java Services button.