Riva Insight Prerequisites - MongoDb (Insight 2026.3+)

Curtis Massie
Curtis Massie
  • Updated

MongoDB Installation

MongoDB is used to store the Track State Data.

NOTE: The steps below are using MongoDB community version, however the decision on which MongoDB version or MongoDB compatible database to use is up to your organization.  MongoDB compatible databases must support MongoDB APIs. TSS has been confirmed for MongoDB and Amazon DocumentDB.

  1. Download MongoDB (MongoDb Versions)
    • Ensure the download is unblocked.
  2. Install MongoDB
    1. During installation leave all defaults
    2. Make sure that MongoDB Compass is also selected
    3. The setup wizard can take 10 minutes or more to complete
    4. ‘Finish” the setup wizard and the MongoDB Compass will automatically open. Leave the MongoDB Compass open as it will be used in later steps below

MongoDB Shell Installation

The MongoDB Shell will be used to create the root user.

  1. Download Mongo DBShell
    • Ensure the download is unblocked.
  2. Extract the files in a new folder (Eg C:\Program Files\Mongo DB Shell)

MongoDB Root User

  1. Run MongoDB Shell as an Administrator:
    1. Within the MongoDB folder, navigate to the bin folder.
    2. From 'bin' folder, right-click on 'mongosh.exe' and select 'run as Administrator'
  2. Enter 'mongodb://localhost' as the database name (if prompted)
  3. Type 'use admin' to switch to the admin database
    • The prompt should show as admin>
  4. Create a root user using the following command:

    REPLACE user (root) with the user name of your choice, and pwd (mongoAdmin) with a secure password.
    • db.createUser({
    user: "root",
    pwd: "mongoAdmin",
    roles: [{
        role: "root", // Assign the root role
        db: "admin" // Assign to the admin database
    }]
})
  5. Exit the shell by typing 'exit'.

MongoDB Connection

  1. Open MongoDB Compass
  2. Click on '+ Add new connection'
  3. For the connection name, enter mongodb://root:mongo@localhost:27017/?tls=false
    1. Replace user (root) and password (mongo) with the user name and password you created above
  4. Select 'Save & Connect'
  5. The database can now be connected to as localhost:27017