Getting started with MongoDB for Rackspace Technology dedicated platform

Create an instance

Note

Review the MongoDB overview for help with creating an instance.

Create instance

1. Log in to Mission Control.

2. Select Create Instance from the side panel.

3. Select MongoDB from the Service, Region, and Provider section.

4. Select the Instance heading.

5. Select Create Instance.

6. Enter a name for your instance.

   Any alphanumeric string is valid.

7. Select a provider.

   Options are Rackspace or Azure.

8. Select a database type.

   Each selection includes a brief description at the bottom of the modal. For more detailed information, review the MongoDB overview.

1. Select Configuration.

Configuration

1. Select a version to deploy.

   ObjectRocket offers the latest stable versions of MongoDB, 3.6.12, 4.0.10, and 4.2.8.

2. Select the zone that suits your needs.

   Zones are Rackspace or AWS Direct Connect zones, labeled by airport codes in that region. For more information about the ObjectRocket data centers, review the FAQ or the ObjectRocket zone map.

3. Choose a plan.

   You can always add shards in your plan size when you use a sharded instance, but that isn’t possible for a replica set. For more details, review the plans and pricing.

4. Select a storage engine.

   You can select WiredTiger or MMAPv1. If you choose the WiredTiger engine, you’ll have a minimum plan size of 20 GB.

5. Select encryption.

   You can choose to encrypt your data at rest and any backups for this instance.

1. Click on ACLs to continue.

Access control lists

Access control lists (ACLs) limit what IPs connect to your instance.

Note

ObjectRocket denies access by default, so you need to add any appropriate ACLs for servers that are connecting to ObjectRocket.

1. Enter an IP address or CIDR block and a description. You can also choose to add your ACLs later.

   Only the IP address is mandatory, but descriptions can help when maintaining larger lists.

2. Select Add ACL to include more entries.

1. Select Add Credit Card and enter your payment information.
2. Select Create Instance to spin up your MongoDB instance.

Creating a database

Created instances appear under the Instances heading. Select an instance to view its details and available operations.

To create a database for an instance, use the following steps:

1. Select the appropriate instance.

2. Select Add Database from Database section.

   Enter a name, username, and password.

3. Select Add Database.

Note

All database users have full privileges to the specified database by default. They can create collections and indexes, as well as read and write documents. However, they can’t, by default, perform administrative commands or interact with other databases.

You can also add collections or more users by selecting the database name in the ObjectRocket API or MongoDB shell.

Connect

HTTP

After you’ve created a database with user authentication and added an ACL, you’re ready to test basic connectivity in a terminal session with the MongoDB shell by using the following command:

$ mongo iad-mongos0.objectrocket.com:<PORT>/<DATABASE> -u <USER> -p <PASSWORD>
MongoDB shell version: 2.6.11
connecting to: iad-mongos0.objectrocket.com:<PORT>/<DATABASE>

HTTPS

Note

Mongo shell versions earlier than 3.0 don’t support SSL connections unless you compile it manually with SSL support.

By using the SSL-compiled binaries, run the following command in a terminal session:

$ mongo iad-mongos0.objectrocket.com:<PORT>/<DATABASE>?ssl=true -u <USER> -p <PASSWORD>
MongoDB shell version: 2.6.11
connecting to: iad-mongos0.objectrocket.com:<PORT>/<DATABASE>

View collections

To view collections, use the following steps:

1. Run show collections in the terminal. You should receive output similar to the following:

mongos> show collections
example_collection
system.indexes
system.users

mongos>

You are now connected to the instance and able to perform database operations.

If you have any questions or need more help, contact the Support team.