You are here

NuoDB Database on AWS: Getting a Quick Start!

It’s a woeful day for Engineering when somebody from the Marketing department writes a techblog, but sometimes they create a tool so easy to run that somebody from marketing can use and explain it. 

Over the past month, I’ve been working on a series of short value prop demo videos that feature the core values NuoDB provides, including Scale-Out Performance, Continuous Availability, Geo-Distributed Deployment, and No Knobs Administration. A lot of folks get excited when we tell them what we can do – but not surprisingly, they want to take it for a spin themselves.

Luckily for those interested in Amazon Web Services (AWS), Engineering built the NuoDB AWS Quickstart Script. The AWS Quickstart script is a python script that can be used to start a configurable multi-machine/multi-region cluster in a matter of minutes. This allows you to get your feet wet and start evaluating NuoDB much quicker than other database options. The steps below will cover - start to finish - setting up that experience for yourself. 

Before you start:

If you don’t have an AWS account sign up here. (You have to navigate through 5 pages, all in all about 3 minutes or less)

Next, find the operating system you are using and install the necessary tools. 

OSX

Fedora, CentOS, RHEL

  • sudo yum -y install gcc git python-devel python-pip

Ubuntu

  • sudo apt-get install gcc git python-dev python-pip

Setting up your AWS account for use with NuoDB AWS Quickstart:

Navigate to this page to reference the steps below to set up your AWS IAM (Identity and Access Management) and Keypairs for each region. 

IAM:

From your AWS Console navigate to services, then IAM

Once in IAM click on Users, then “Create New User” 

  • Enter a username for your new account - like "NuoDB"
  • Make sure "Generate an access key for each user" is checked
  • When the "Access Key ID" and "Secret Access Key" are shown to you copy them to a location you can access later. If you lose the "Secret Access Key" you will have to recreate the key pair.
  • When back at the page that shows you a list of users click on the username you just created
  • Click on Attach User Policy
  • Select "Amazon EC2 Full Access"
  • Finish by selecting Apply Policy

Keypairs:

Note: You can set up Keypairs for each region, or for as many as you plan to use.

First: Select the region where you want to run. Once in the region of your choice select Key Pairs and “Create Key Pair” * I like to name my Key pair in correspondence to the region.

When the Key pair is created a .pem file will be downloaded by your browser, keep this file handy, because you’ll want to store it in the same directory as your NuoDB AWS Quickstart script. Repeat these steps for each Amazon region that you would want to run NuoDB.

Quickstart Script:

Download the latest release of the AWS Quickstart Script to your local machine and extract it.

Add the .pem files from the previous keypair step from each region to the new directory you created. 

Running the Script:

While in the directory you created run: nuodb_aws_quickstart.py create

Your output:

Below you’ll be prompted for some personal information about your account as well as configurable information about your cluster. 

knox-macbook-pro:quickstart kanderson$ nuodb_aws_quickstart.py create
What email address would you like health alerts sent to? [name@email.com
What is your AWS access key? [xxxxxxxxxxxxxxxxx] 
What is your AWS secret? [xxxxxxxxxxxxxxxxxxxxxxxx] 
What is the name of your cluster? [test] 
What is the admin password of your NuoDB domain? [bird] 
How many AWS regions? (1-9)? 1
 1) ap-northeast-1            
 2) ap-southeast-1            
 3) ap-southeast-2            
 4) eu-central-1              
 5) eu-west-1                 
 6) sa-east-1                 
 7) us-east-1                 
 8) us-west-1                 
 9) us-west-2                 
Choose one:7
us-east-1 --- How many servers? (1-20) 3
us-east-1 --- Choose a keypair:
 1) East                      
Choose one:1
us-east-1 --- Determining AMIs (Loading...) 
us-east-1 --- Finding subnets... 
Saving this information for later to ./config.json
Creating the cluster.

Accessing the NuoDB Domain

Once the script has finished booting up the machines you will receive a link where you can access the NuoDB Automation Console. Copy the link highlighted below into your browser and begin using the NuoDB Software. 

########################################################################################
You can now access the NuoDB Admin Center (Username: domain Password: bird) at http://ec2-54-152-124-204.compute-1.amazonaws.com:8888
where you'll find documentation, samples and demos (check out Storefront!)
and the Automation Console (create and manage databases).
Other instances in the cluster may still be booting and will join the cluster over time.

########################################################################################

Now that you have access to your Amazon instances, you’re ready to start using and testing NuoDB! Your first stop should be the NuoDB Automation Console. 

LOGIN: domain
PASSWORD: bird

The Automation Console is the administration tool for NuoDB databases. It allows you to create databases, manage their operation, monitor performance, view metrics, and other statistics.  

After you’ve gotten comfortable with the Automation Console, a fun next stop is the Storefront Demo.  The Storefront Demo is a sample e-commerce application that can be used to explore NuoDB’s key capabilities. In the coming weeks, I’ll be writing blogs to help users understand how to test NuoDB for each of these capabilities.  For now, each of these value prop scenarios has a guided tour within Storefront, so feel free to explore NuoDB yourself!

 

Add new comment