Get started with Objectrocket | HumongouS.io Documentation
Get started with Objectrocket

ObjectRocket is a server-side platform that makes it easy to create and manage MongoDB instances right from the cloud. It is powered by Rackspace.

This tutorial covers how to get started on HumongouS.io using databases created from ObjectRocket. To get started, you first need to login to your ObjectRocket account or create one here.

When logging in for the first time, you will be greeted with a lengthy T&C (terms and conditions) agreement. Read through it or save for later and click on agree to go to your ObjectRocket dashboard.

On your dashboard, click Add instance

Create new shard ObjectRocket

A window containing a form to fill pops up , type the name of your MongoDB instance. For the duration of this tutorial, my instance will be humongousio. Select MongoDB under the Service option and choose either MongoDB sharded or MongoDB Replica set under the Type option. We are choosing MongoDB sharded for this tutorial.

In MongoDB, sharding is a method used in storing data across multiple machines. MongoDB uses sharding to support deployments with very large datasets.

Replication on the other hand is the process of synchronizing data across multiple servers.

Click on step 2 when done. In this window, you choose the MongoDB version, the zone you’d like your server to be in, and a subscription plan. Under version, select the latest version that is compatible with the type of work you intend to do. We are selecting v3.0.6, which happens to be the latest version available as at the time of writing this tutorial.

Create new ObjectRocket Instance

Choose a plan that best suits the type of work you will be doing and fits into your budget. For this tutorial, we are selecting the smallest available size. Click confirm and double check all details in the next pop up window to ensure they tally with the options you picked. When you are certain and satisfied, click create.

Your MongoDB instance should be ready in a few seconds, you should see it under the Add instance button when creation is completed.

A MongoDB instance is simply a MongoDB server running on an machine and it can host multiple MongoDB database.

Create a database

Click on your instance name beneath the Add instance button and you will be presented with all the details of the instance you created. At this point, no databases are in your instance but you do need a MongoDB database to proceed so scroll down on your instance details page. Clicking on databases will reveal an Add database button as well as show the databases currently in your instance but since you haven’t created any yet, click on Add database to create one. A new window will pop up asking you to name your database and choose a username and password. Choose a password that’s quite strong but still easy for you to remember. How to create strong passwords

Create DB on ObjectRocket

Click Add Database when done. Your database will now show up under Databases on the instance details page. Click on it to display its details.

ObjectRocket Database details

Copy the details under Database Connect String as this will be your connection string:

iad-mongos2.objectrocket.com:15437/HumongouSio

The hostname (iad-mongos2.objectrocket.com) and the port (15437) are generated for you by ObjectRocket so we probably won’t have the same values. Prepend these details to your connection string:

mongodb://<username>:<password>

The username and password are the ones you entered when you were creating the database so your final connection string should something like this:

mongodb://teamHumongouSio:secretpassword@iad-mongos2.objectrocket.com:15437/HumongouSio

Whitelisting HumongouS.io IP

You won’t be able to connect your database to HumongouS.io just yet and even if you tried, you will get an error. This is not a big deal, but merely a security measure ObjectRocket has put in place. By default, all access to your database are restricted. You need to explicitly allow access to a specific IP address or a range of IPs as this is the only workaround. To add Humongous.io’s IP address, go back to your instance page (the page listing all your databases), and click on Security as you scroll down the page.

ALC ObjectRocket

Click on Add ACL (Access Control List) and enter the HumongouS.io IP address with /32 at the end and then click Add ACL to save.

/32 means “restrict to only this IP address”

You can find the HumongouS.io IP address on the project creation form on Humongous.io.

Get HumongouS.io IP

Whitelist HumongouS.io IP

All incoming requests will now be allowed by your server.

Create a new project on HumongouS

All done!! Now all you need do is to copy your final connection string, go back to HumongouS.io, and paste it in the project creation form. Welcome to the best MongoDB GUI ever, welcome to the GUI that brings your data to life.

If you encounter issues with any of the above steps, please contact us on docs@humongous.io, we will be more than happy to help.