Olares/docs/developer/develop/mw-view-mongodb-data.md

outline, description

outline	description
2 3	Learn how to view and manage MongoDB data in beOS Pro using CLI or Bytebase.

View MongoDB data

To use MongoDB in beOS Pro, install it from Market first. This guide walks you through the installation steps and shows how to access it from beOS Pro.

Install MongoDB service

Before connecting, install the MongoDB service from Market.

1. Open Market from the Launchpad and search for "MongoDB".
2. Click Get, then Install, and wait for the installation to complete.

Once installed, the service and its connection details will appear in the Middleware list in Control Hub.

Get connection information

Before connecting, obtain MongoDB connection details from the Control Hub.

1. Open Control Hub from Launchpad.

2. In the left navigation pane, go to Middleware and select Mongodb.

3. On the Details panel, record the following information:

   • Mongos: The host address provided by Control Hub. Used for Bytebase connection.
   • User: Used for Bytebase connection.
   • Password: Used for both CLI and Bytebase.

   {width=60% style="margin-left:0"}

Access via CLI

You can use the beOS Pro terminal to access the MongoDB container.

1. In Control Hub, open the beOS Pro terminal at the bottom of the left navigation pane.

2. Retrieve the Pod name for the middleware:

   kubectl get pods -n os-platform | grep tapr-middleware
   

3. Record the Pod name that starts with tapr-middleware, then enter the container:

   kubectl exec -it -n os-platform <tapr-middleware-pod> -- sh
   

4. Connect to MongoDB using mongosh:

   mongosh "mongodb://root:<your password from controlhub>@mongodb-mongodb-headless.mongodb-middleware:27017"
   

Manage via Bytebase

Bytebase provides a graphical interface for database management and schema changes.

Install Bytebase

1. Open Market and search for "Bytebase".
2. Click Get, then Install.

First-time setup

When launching Bytebase for the first time, you must configure an administrator account.

:::tip Remember these credentials. Only the admin account can create new database instances. :::

1. Open Bytebase from Launchpad.
2. Follow the on-screen prompts to set up your admin account with email and password.

Create a MongoDB instance

1. Log in to Bytebase with your admin account.
2. In the left navigation pane, select Instances, then click + Add Instance.
3. Choose MongoDB as the database type.
4. Fill in the connection fields using values from Control Hub:
   • Host or Socket: Enter the Mongos host address and do not include the port.
   • Port: Keep the default, usually 27017.
   • Username: Enter the User value from Control Hub.
   • Password: Enter the Password value from Control Hub.
5. Click Test Connection to verify connectivity, then click Create.

Creating an instance in Bytebase does not create a new database. Once the instance is created, you can use the corresponding client tools to inspect and manage data.