This guide will walk you through connecting to a MongoDB database and assumes that you have already created a database on Modulus. You will need two things,
- the ID of your database and
- the credentials for the user account that you created when you created the database.
To find your database ID proceed to your dashboard, click on the databases menu item on the left
Then select your database from the list.
Then click on the administration menu item for the database.
The connection strings in this dashboard include the database ID.
If you are not sure what your user & password is for the database is you should select the 'users' on the menu to the left.
In the 'users' tab you will see the users on the database, and you can reset the password by selecting the small 'gear wheel' to the right of the username. Make sure you do not have 'read-only' for the user selected.
Also, make sure you do not have the ' @ ' symbol in your database username or password.
When you select the 'gear wheel' this will pop up:
Adding your database to Robomongo
Once you have downloaded Robomongo:
Open the Robomongo application.
When you open the Robomongo application a little window should pop up which allows you to add/create new database connections.
If the window to add mongo connections does not appear when you open Robomongo click this button
To add your database to Robomongo select the 'create' button here, or 'right-click' and select 'add.'
The 'connection settings' window will now appear.
- You can enter anything for 'Name' - this will not affect your connection to the mongo.
- Enter the 'Address' - this should be something like olympia.modulusmongo.net
- Leave the port as 27017
On the 'Authentication' tab
Select this box if it is not already checked:
Remember the database id you grabbed earlier from the connection string on the 'administration' section of the mongo dashboard? That is the 'database id' for the 'Database' field. Do not mistake this with what you named your database.
- Enter the 'database id' for the 'Database' field (should be a short alpha-numeric id)
- Enter the user name you created for your database in the 'User Name' field
- Do not use the credentials you use to log in to my.xervo.io (unless you use the same username and password to log in to the web dashboard - this is not recommended).
- Enter the password for that database user.
- Not sure what the password is? Refer to 'gear wheel' noted above.
- Make sure you have SCRAM-SHA-1 selected for the 'Auth Mechanism'
- Select 'Save'
If you forgot the password for the database user, refer to the 'gear wheel' part mentioned above.
Make sure you 'SCRAM-SHA-1' selected for the Auth Mechanism
'SSH' & 'Advanced' tab
Do not enter anything here. Do not enter a default database. Ignore these tabs.
Example 'SSH' tab: (notice: nothing is entered in any field in the screen snip below)
Example 'Advanced' tab: (notice: nothing is entered in any field here either. Do not enter a 'default database,' leave that blank. Don't use this tab. Ignore this tab.
After making sure you ignored and entered nothing in any field on the 'SSH' and 'Advanced' tab, make sure you select 'Save'
Connecting to your databaseNow that you have saved your 'Connection Settings' you will be taken back to the 'MongoDB Connections' window. Select the database you want to connect to, and select 'Connect.'
If you run into any trouble or errors submit a support ticket by emailing firstname.lastname@example.org
or use the 'Status & Support' menu to the left (by selecting this link): Submit a Support Request