---
title: MongoDB
slug: bhdo/mongodb
createdAt: 2022-11-24T18:29:19.000Z
---

You can generate data from an edge device, then connect and store the data in the MongoDB db-sample database using the DB-MongoDB connector. Data is collected from the selected device. You can perform mongoDB queries.

See the the [MongoDB documentation](https://www.mongodb.com/docs/) for more information.&#x20;

# Step 1: Add Device

Follow the steps to [Connect a Device](https://public-docs.litmus.io/bhdo/connect-a-device). The device will be used to store tags that will be eventually used to create outbound topics in the connector. Make sure to select the **Enable Data Store** check box.&#x20;

For this use case, select the **Simulator&#x20;**&#x64;evice and **Simulator (Gen1)** driver and use the name **PLC1**.

# Step 2: Add Tags

After connecting the device in Belden Horizon Data Operations, you can [Add Tags](https://public-docs.litmus.io/bhdo/add-tags) to the device. Create tags that you want to use to create outbound topics for the connector.&#x20;

For this use case, add two tags with the following details.

- **Name**: Select **int-integer**.&#x20;
- **Value Type**: Select **int**.&#x20;
- **Tag Name**: Enter **temp**.&#x20;
- **Polling Interval**: Enter **1**.&#x20;
- **Address**: Enter **0**.&#x20;



- **Name**: Select **float-float**.&#x20;
- **Value Type**: Select **float**.&#x20;
- **Tag Name**: Enter **pressure**.&#x20;
- **Polling Interval**: Enter **1**.&#x20;
- **Address**: Enter **1**.&#x20;

# Step 3: Add MongoDB Marketplace Application

:::hint{type="info"}
**Note**: The version used in this use case for MongoDB is 4.2.
:::

**To add the MongoDB Marketplace Application:**

1. In Belden Horizon Data Operations, navigate to **Applications&#x20;**> **Marketplace**.
2. Click **Marketplace List** and select **Default Marketplace Catalog**.
3. Click the **MongoDB** application tile.&#x20;
4. From the **Installation script version** drop-down list, select **latest**.&#x20;
5. Enter **MongoDB&#x20;**&#x69;n the **Name&#x20;**&#x66;ield. &#x20;
6. Click **Launch**.&#x20;
7. Navigate to **Applications&#x20;**> **Catalog Apps**.&#x20;
   The MongoDB application appears, pulls the image, and then starts the application. The MongoDB application shows as running.
8. Navigate to **Applications&#x20;**> **Containers**.&#x20;
   The MongoDB application Container is running.
9. Copy the IP address for the MongoDB application.

# Step 4: Add the DB - MongoDB Connector

Follow the steps to [Add a Connector](https://public-docs.litmus.io/bhdo/add-a-connector) and select the **DB - MongoDB&#x20;**&#x70;rovider.&#x20;

Configure the following parameters.&#x20;

- **Name**: A recognizable name to identify the connector.&#x20;
- **Hostname**: Paste the IP address you copied in Step 3. &#x20;
- **Port**: The MongoDB Server port. The default value is **27017**.&#x20;
- **Username**: Enter **user**.&#x20;
- **Password&#x20;**(Optional): Enter the user password.&#x20;
- **Auth database** (Optional): The authentication database name. The default value is **admin**.&#x20;
- **Auth mechanism**: Select **PLAIN**.&#x20;
- **Database**: Enter **db-sample**.&#x20;
- **Collection**: Enter **devicehub**.&#x20;
- **Throttling limit**: The maximum number of messages per second to be processed. The default value is zero, which means that there is no limit.&#x20;
- **Persistent storage**: When enabled, this will cause messages to undergo a store-and-forward procedure. Messages will be stored within Belden Horizon Data Operations when cloud providers are online. &#x20;

# Step 5: Enable the DB - MongoDB Connector

**To enable the connector:&#x20;**

1. Return to the *Belden Horizon Data Operations Integration* browser tab.
2. Click the connection toggle on the connector tile.&#x20;
   The connector shows connected after verifying the certificate, username, and password.

   ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/MVYEulgPfs3NbMcXKeNUw_mongodb.png" size="60" width="351" height="265" caption="Toggle to enable connector" position="center" showCaption="true"}

# Step 6: Create Topics for MongoDB Connector

You will now need to import the tags created in Step 2 as topics for the MongoDB connector. The topics will be created as outbound topics.

**To create outbound topics:**

1. Click the connector tile.
   The connector *Dashboard&#x20;*&#x61;ppears.&#x20;
2. Click the **Topics&#x20;**&#x74;ab.&#x20;
3. Click the **Import from DeviceHub** tags icon.&#x20;
   The *DeviceHub Import&#x20;*&#x64;ialog box appears.

   ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/4fC8yaOKctxiiTvUDGfWu_import-from-devicehub.png" size="80" width="1148" height="570" position="center" showCaption="false"}
4. Select all the tags to import and click **Import**.&#x20;

After importing the tags, click the toggle in the connector tile to restart the connection.&#x20;

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/F1OTvo7oTPKDqR7Am0NRF_mongodb.png" size="60" width="351" height="265" caption="Toggle to enable connector " position="center" showCaption="true"}

# Step 7: Enable Topics

To enable the topics, return to the *Topics&#x20;*&#x74;ab and click the **Enable all topics** icon.&#x20;

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/bCV1JMfeMF7XQryi1HSGr_enable-all-topics.png" size="80" width="1148" height="570" caption="Enable all topics icon" position="center" showCaption="true"}

# Step 8: Make Queries in the MongoDB Container Terminal

**To make queries in the MongoDB container terminal:**

1. In Belden Horizon Data Operations, navigate to **Applications&#x20;**>**&#x20;Containers**.
2. Click the **Terminal&#xA0;**&#x69;con next to the MongoDB container.
   The MongoDB shell opens.
3. From the MongoDB container terminal, enter **mongo&#xA0;**&#x61;nd press **ENTER**.
   The *MongoDB shell version v4.4.4&#xA0;*&#x61;ppears and connects.
4. Enter **show databases&#xA0;**&#x61;nd press **ENTER**.
   The `db-sample `database name appears in the console.
5. Enter **use db-sample&#xA0;**&#x61;nd press **ENTER**.
   The directory switches to db-sample.
6. Enter **show collections&#xA0;**&#x61;nd press **ENTER**.
   The collection list appears.

   ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/9iq-ITtyeaClaoYPT-KDq_applications-mongodb-terminal.png" size="80" width="1231" height="534" caption="MongoDB connector messages" position="center" showCaption="true"}

