How to Install MongoDB on AWS Lightsail - Part 1

Introduction

In this tutorial we’ll show you step-by-step how to setup a MonoDB instance using the AWS service Lightsail. Lightsail allows you to spin up servers with operating systems of your choice and they even have installations with the whole tech stack already installed including WordPress, MEAN, and LAMP stacks. We will be creating a CentOS instance and installing MongoDB but you can pick the operating system of your choice. We’ll go through each step in detail and provide screenshots. Part 2 of this article will show you how to connect to your new MongoDB server using the graphical IDE 3T.

Prerequisites

  • We recommend you have some command line experience as we will be executing a lot of terminal commands
  • You should have an amazon aws account but you can always create one before you get started

Spin up a CentOS Server in Lightsail

The first step is to go to AWS Lightsail. You’ll need to login with your AWS credentials to do this. You’ll see a page like below where you click the “Create Instance” button:

Image from Gyazo

Then we selected Linux/Unix and CentOS as our operating system:

Image from Gyazo

Then under SSH Key Pair Manager we clicked “Create New” and you’ll receive a prompt to name your keypair:

Image from Gyazo

We name ours aws_keypair then we clicked “Generate Key Pair” and then “Download Key”. We then moved our key to where we typically keep ours under our user folder ~/.ssh/aws_keypair.

Image from Gyazo

Under choose your instance plan we chose the one that has the free 1 month trial and then clicked “Create Instance”.

A new page will load and you should see a page similar to the following that in a few moments will let you know that your instance is Running:

Image from Gyazo

SSH Into the Instance

Now we want to SSH into our server so we can eventually install MongoDB but in order to get ssh to work first we need to change the permissions on the aws_keypair we created. In a terminal navigate to the directory where you stored the keypair and execute the following:

chmod 400 aws_keypair.pem

Now ssh into the instance with the following command with the public ip address of your instance which you can find on the instance page:

$ ssh centos@34.228.82.4 -i ~/.ssh/aws_keypair.pem

You should receive a response similar to below letting you know that you’re know logged into your CentOS instance as the centos user:

Last login: Thu Jun  6 18:18:44 2019 from 72.21.217.75
[centos@ip-172-26-10-246 ~]$

Installing MongoDB on the CentOS Server

Now that we have the server up and running we need to install MongoDB. To do so we’ve followed MongoDB’s official documentation and performed the following steps from the terminal ssh’d into your CentOS instance.

You’ll need to create a new file that will allow you to install MongoDB directly using the yum package manger. The file we’ll be creating is /etc/yum.repos.d/mongodb-enterprise.repo and you can create it with vi like so:

sudo vi /etc/yum.repos.d/mongodb-enterprise.repo

Because this file doesn’t already exist vi will create the file and open it for us for editing. It should look something like this:

Image from Gyazo

First press the key i to get into “Insert Mode”. Now copy and paste the following text into that file:

[mongodb-enterprise]
name=MongoDB Enterprise Repository
baseurl=https://repo.mongodb.com/yum/redhat/$releasever/mongodb-enterprise/4.0/$basearch/
gpgcheck=1
enabled=1
gpgkey=https://www.mongodb.org/static/pgp/server-4.0.asc

Then to save and exit type :wq ( write and quit ). This will save the file and then we can install MongoDB using yum with the following command:

sudo yum install mongodb-enterprise

You’ll see a bunch of logs pass by in the terminal and you’ll receive several prompts to which you can answer y to all of them. They’ll look similar to below:

Is this ok [y/d/N]:

When MongoDB is successfully installed your terminal will look something like below:

 Installed:
  mongodb-enterprise.x86_64 0:4.0.10-1.el7                                                                          

Dependency Installed:
  cyrus-sasl.x86_64 0:2.1.26-23.el7                    cyrus-sasl-gssapi.x86_64 0:2.1.26-23.el7                    
  perl-Storable.x86_64 0:2.45-3.el7                    perl-Text-ParseWords.noarch 0:3.29-4.el7                    
...
  perl-threads-shared.x86_64 0:1.43-6.el7            

Complete!
[centos@ip-172-26-10-246 ~]$

Now everything from MongoDB is installed. But now we need a folder that can be used as the path to store our database data. Let’s create a mongodb directory for it with the following commands.

[centos@ip-172-26-10-246 ~]$ mkdir mongodb
[centos@ip-172-26-10-246 ~]$ chmod -R 777 mongodb

We make the folder writable because later we are gonna allow MongoDB to also create logs in this folder.

Now we need to make one MongoDB configuration change before we start it. By default MongoDB restricts you from connecting to MongoDB from anywhere other than localhost so we will comment out that configuration by opening up Mongos configuration file /etc/mongod.conf:

[centos@ip-172-26-10-246 /]$ sudo vi /etc/mongod.conf

Now scroll down to the line that says bindIp: 127.0.0.1, hit i to get into “Insert Mode” and comment it out by typing a # at the beginning of the line. This is the only change we need to make and can hit Escape to exit “Insert Mode” then type :wq to write and quit.

Start MongoDB

Finally we are set to start MongoDB. Execute the following command and we’ll dissect the flags afterward:

mongod --dbpath mongodb --port 27017 --logpath mongodb/log --logappend --fork --bind_ip_all
  • –dbpath: Specifies that we want to store the database in the directory we just made mongodb
  • –port: Specifies the port. We like to be explicit here and specify the port number even though this is the default.
  • –logpath: We specify that we want the logs in our mongodb directory under a new log folder. This is why we made the folder writable earlier.
  • –logappend: We use the logappend flag so that it appends logs to one file instead of creating multiple files for logs.
  • –fork: This allows the process to run in the background without taking over our terminal.
  • –bind-ip-all: This allows mongodb to accept connections from everywhere.

If MongoDB started correctly you should get a response similar to below:

[centos@ip-172-26-10-246 ~]mongod --dbpath mongodb --port 27017 --logpath mongodb/log --logappend --fork --bind_ip_all
about to fork child process, waiting until server is ready for connections.
forked process: 4421
child process started successfully, parent exiting

Now mongodb is up and running and you can start accepting connections.

Conclusion

In this step-by-step tutorial we showed you how to create a CentOS instance using the AWS service Lightsail. Then we learned how to log into that instance so that we could install MongoDB. We’ve done most of the grunt work in Part 1 of this tutorial but in Part 2 we’ll pick up where we left off and show you how to connect to MongoDB using an IDE called 3T that will make it easy for you to get started creating databases and viewing data. Thank you so much for joining us and we hope you follow along to Part 2 of this tutorial.

As always if you don’t want to deal with all the complexity that comes with configuring and managing databases in a production environment, please don’t hesitate to reach out to us at Object Rocket because we’d be delighted to manage your database.

Pilot the ObjectRocket Platform Free!

Try Fully-Managed CockroachDB, Elasticsearch, MongoDB, PostgreSQL (Beta) or Redis.

Get Started

Keep in the know!

Subscribe to our emails and we’ll let you know what’s going on at ObjectRocket. We hate spam and make it easy to unsubscribe.