×

Getting Started with Aerospike

Open Source - NoSQL - Key-Value Store ++

Speed icon

Speed

99% < 1 millisecond
Predictable low latency

Scale icon

Scale

1 M TPS / 100TB
on just a handful of servers

Reliability icon

Reliability

Strong uptime consistency
and persistence

Aerospike powers some of the largest platforms on the Internet. We focus on speed at scale. We offer clients in a number of languages.

Follow this Getting Started Guide to get your Aerospike server up and running. Servers can be launched using several different options. Detailed instructions are available in the documentation.

OS & Environment

Let's Get Your Aerospike Server Set Up

Linux

Aerospike can run in different Linux environments - your laptop or another machine. It is available as a binary, .rpm, .deb, .tgz, docker container, or you can build from the source at GitHub.

Cloud

Aerospike can run on Amazon EC2, Google Cloud Platform, and other cloud providers.

Virtual Machine

You can use VMware or Virtualbox images to run Aerospike on your Mac or Windows machine.

Vagrant

Use Vagrant virtual machine manager for single click Aerospike installation on your Mac or Windows laptop. You will need VirtualBox or VMware to use Vagrant.

Linux

Let's Install Your Aerospike Server On Linux

Redhat/CentOS

Aerospike runs on CentOS 6+ or newer, RHEL 6+ or newer, and additional versions.

Ubuntu

Aerospike runs on Ubuntu 12.04 LTS or newer.

Debian

Aerospike runs on Debian 6 or later.

Other Linux

Aerospike is also available as a precompiled binary to install on other Linux versions.

GitHub

Aerospike is Open Source. The source code and build instructions are available on Github.

Cloud Options

Deploying Into the Cloud

Amazon Web services

It's easy to get started on Amazon EC2 using the Aerospike Marketplace AMI. It is based on Amazon Linux so you don't need to make an OS choice.

Google

Quickly start an Aerospike cluster with certified local solid-state drives (SSDs). By default, you get two Aerospike servers on two cores with 7.5 GB of RAM and one 1TB persistent disk volume attached.

Internap

Internap offers a free trial of a two-node installation of Aerospike on bare-metal servers with fully dedicated CPU, RAM and SSDs and a client machine.

INetU

INetU helps organizations accelerate business growth and reduce their investment in managing their own IT infrastructure.

Virtual Machine

Aerospike can run on multiple Virtual Machines

Virtual Machines make it convenient to run Aerospike on your computer locally without the need for vagrant or a cloud server. We recommend using VMware or Virtual Box to create your virtual machine.

Vagrant

Using Aerospike with Vagrant

Aerospike is supported on OS X in a virtual machine managed by Vagrant. Vagrant boxes pre-built with Aerospike are available on the Vagrant Cloud service.

Vagrant is an open source tool for building and managing virtualized development environments. Vagrant manages virtual machines running on Oracle VirtualBox, or VMWare.

Aerospike Clients

Let's Pick a Client

Aerospike clients offer native interfaces which allow you to store and retrieve data without requiring JSON formatted calls.

Key-Value++ Features

Aerospike has advanced key-value++ functionality such as: batch, scan, atomic counters, lists, maps, user-defined functions, aggregations and per record time-to-live.

Aerospike provides queries for value-based lookups using secondary indexes. Results can be returned as set of records, or pre-processed using rich User Defined Functions (UDFs) before being returned to the client.

Large lists allow storage of multi-megabyte ordered data such as recent user behavior or sensor data.

Aerospike Concepts in MySQL Terms
Aerospike MySQL
namespace db
set table
bin column
key primary key
record row

Where Would You Like to Run Aerospike?

linux

Linux

cloud

Cloud

virtual machines

Virtual Machines

vagrant

Vagrant

Environments

Select your environment and then click continue.

My Linux Box

We make it easy to get started on your own hardware. Please note that you should already have a Linux box running.

Click continue to select your Linux preference.

In the Cloud

Aerospike has partnered with several cloud vendors to make starting your Community Edition server installation quick and easy. Run Aerospike for free using the Aerospike AMI in the Amazon EC2 marketplace.

Click continue to select your cloud preference.

On my Virtual Machine

Launch your choice of virtual machine with either VMware or Virtualbox. If you're not already set up with VMware or Virtualbox, we provide details to help you get started.

Click continue to select your virtual machine preference.

On Vagrant

Vagrant is a quick and easy way to start your Community Edition server. We have detailed instructions about our Vagrant install for both Mac or Windows.

Click continue to get up and running with Aerospike on Vagrant.

Select Your Linux Preference

Redhat Install Steps

Step 1:
First, on our Linux Redhat server we will download the Aerospike database software. Navigate to your preferred directory, then run:

wget -O aerospike.tgz 'http://aerospike.com/download/server/latest/artifact/el6'

Step 2:
Next, we will un-tar the file. Run:

tar -xvf aerospike.tgz

Step 3:
Our next step will be to cd into the directory and run the install.

cd aerospike-server-community-*-el6
  sudo ./asinstall # will install the .rpm packages

Step 4:
Our last step is to start our Aerospike Database service.

sudo service aerospike start && \
  sudo tail -f /var/log/aerospike/aerospike.log | grep cake
  # wait for it. "service ready: soon there will be cake!"
**Note that root access (sudo) is required to install packages.
Need more help?

Ubuntu Install Steps

Step 1:
First, on our Linux Ubuntu server we will download the Aerospike database software. Navigate to your preferred directory and run:

wget -O aerospike.tgz 'http://aerospike.com/download/server/latest/artifact/ubuntu12'

Step 2:
Next, we will un-tar the file. Run:

tar -xvf aerospike.tgz

Step 3:
Our next step will be to cd into the directory and run the install.

cd aerospike-server-community-*-ubuntu12
  sudo ./asinstall # will install the .rpm packages

Step 4:
Our last step is to start our Aerospike Database service.

sudo service aerospike start && \
  sudo tail -f /var/log/aerospike/aerospike.log | grep cake
  # wait for it. "service ready: soon there will be cake!"
**Note that root access (sudo) is required to install packages.
Need more help?

Debian Install Steps

Step 1:
First, on our Linux Debian server we will download the Aerospike database software. Navigate to your preferred directory and run:

wget -O aerospike.tgz 'http://aerospike.com/download/server/latest/artifact/debian6'

For Debian 7, run:

wget -O aerospike.tgz 'http://aerospike.com/download/server/latest/artifact/debian7'

Step 2:
Next, we will un-tar the file. Run:

tar -xvf aerospike.tgz

Step 3:
Our next step will be to cd into the directory and run the install.

cd aerospike-server-community-*-debian?
  sudo ./asinstall # will install the .rpm packages

Step 4:
Our last step is to start our Aerospike Database service.

sudo service aerospike start && \
  sudo tail -f /var/log/aerospike/aerospike.log | grep cake
  # wait for it. "service ready: soon there will be cake!"
**Note that root access (sudo) is required to install packages.
Need more help?

Other Linux Distribution Install Steps

Step 1:
First, on our Linux server we will download the Aerospike database software. Navigate to your preferred directory and run:

wget -O aerospike.tgz 'http://aerospike.com/download/server/latest/artifact/tgz'

Step 2:
Next, we will un-tar the file. Run:

tar -xvf aerospike.tgz

Step 3:
Our next step will be to cd into the directory and run the install.

cd aerospike-server
  sudo ./asinstall # will install the .rpm packages

Step 4:
Our last step is to start our Aerospike Database service.

sudo service aerospike start && \
  sudo tail -f /var/log/aerospike/aerospike.log | grep cake
  # wait for it. "service ready: soon there will be cake!"
**Note that root access (sudo) is required to install packages.
Need more help?

Github Install Steps

Step 1:
Navigate to the Aerospike Server repository

Step 2:
Navigtate to the readme and follow the instructions needed for your particular version of Linux.

Select Your Cloud Preference

Amazon Web Services - EC2 Install Steps

Step 1:
We will start by navigating to the Aerospike AMI. You must have an Amazon AWS account to use AWS. If you do not have an AWS account, Sign up here.

Step 2:
Next, select the size of your Aerospike server. We recommend using the "r3.2xlarge" instance or higher depending upon your RAM requirement for data storage, but you can go as small as the t2.small. Optimize your AWS Server by using bcache.

Step 3:
Once we select our server size, we will set up a Security Group for access. Notice the portal settings below.

Protocol Port Description
TCP 22 SSH Port for accessing the instance.
TCP 3000-3004 Aerospike ports, for clients and other servers to communicate with this instance.
TCP 8081 HTTP Port for accessing AMC via a web browser.

After you have your Security Group configured and have clicked through the Amazon setup wizard. Launch it.

Step 4: Once your server is ready, ssh into it using your key and then run:

sudo service aerospike start
Need more help?

Google Cloud Platform Install Steps

A Google account is required. If you haven't signed up already, you can sign up here.

Step 1:
Go to your Google Developers Console.

Step 2:
Select a Project where you want to install Aerospike. If you want to start fresh, click on "Create Project".

**We recommend using the latest backports-debian-7 OS.

Step 3:
Choose Click-to-Deploy under the Compute menu and click Go on the Aerospike card.

Step 4:
Click on Deploy Cluster.

Need more help?

Internap Install Steps

Step 1:
Sign up for Internap

Step 2:
Once you have an account, select Aerospike Server option to launch.

Server Details:
Each of the Internap servers for the two-node Aerospike cluster is equipped with two 2 x Hex (12) Core CPU, 64GB RAM, 2 x 240GB SSD and 1 x 1TB SATA HDD. Data is stored on SSD and the 1 TB SATA drive stores the operating system. These servers come pre-configured with Aerospike 3 Community Edition.

Need more help?

INetU Install Steps

To learn more about INetU's Aerospike solution. Visit iNetU Aerospike.

Need more help?

Using Virtual Machines with Aerospike

Virtual Machine Steps

Step 1:
Pick the virtual machine option that you want. We recommend either VirtualBox or VMware.

Step 2:
Once you have downloaded either preferred virtual machine software, launch your preferred Linux virtual machine.

Step 3:
After you have your Linux machine up and running, click continue to head over to set up Aerospike for your specific version of Linux. Continue

Install Aerospike Using Vagrant

Vagrant Steps

Step 1:
Download Vagrant

Note: VirtualBox or VMware is required to run Vagrant.

Step 2:
Run the following command to create a directory and cd into it:

mkdir ~/aerospike-vm && cd ~/aerospike-vm

Step 3:
Next, we will be initializing an Aerospike virtual machine with Vagrant:

vagrant init aerospike/centos-6.5

Step 4:
Start Aerospike by running the following:

vagrant up

Step 5:
Let's verify that your setup is successful. Enter the following command and check the log entries to verify Aerospike is running:

vagrant ssh -c "sudo grep -i cake /var/log/aerospike/aerospike.log"

Note: Vagrant comes Pre-installed with 3 clients: Java, C, and Nodejs.For more details about Vagrant. Continue

You are now ready to get started developing on Aerospike. Choose your client and start developing

C

C

C-sharp

C#

libevent

C libevent

erlang

Erlang

Go

Go

Java

Java

node

Node.js

pearl

Perl

php

PHP

Python

Python

ruby

Ruby