Software > Quick Start

Getting Started

Five tips to get you going even faster with Mirantis OpenStack:

  1. Get your cloud deployed in 60 minutes or less*: The Quick Start Guide below shows how to stand up your own Mirantis OpenStack cloud with Virtual Box or vApp.
  2. Get the concept: See an overview of what OpenStack provides, from self-service provisioning to management of cloud compute, networking, storage and more.
  3. Get the doc: The Mirantis OpenStack User Guide details installing, configuring, scaling running in a real-world multi-node physical environment, certified to 100 nodes.
  4. Get the deep dive: A comprehensive list of 50+ Mirantis and Community resources from the MCA100 Certification Study Guide
  5. Get expert support: Register for 30 days’ complimentary trial support from Mirantis.

* 60 minutes too long? Get your on-demand Private Cloud as a Service instantly with Mirantis OpenStack Express


Quick Start Guide

0. Prerequisites

This example works with Virtual Box using a host machine with a minimum of 8 GB of RAM, but 16 GB works better. In an hour, you’ll have a demonstration OpenStack cluster on a single server using VirtualBox. (vSphere users: check out the OpenStack/VMware vApp Quickstart Kit).

  • Download the latest version of VirtualBox and install the Extension Pack.
  • Run VirtualBox on a stable host system; Mac OS 10.7.x/10.8.x, CentOS 6.4, or Ubuntu 12.04 are preferred and fully supported by the scripts below. 

1. Get VirtualBox Scripts

2. Follow these simple steps to launch OpenStack

Unzip the archive containing the VirtualBox scripts;

you should see something like this:

-% ls -l
total 24
-rw-r--r--  1 mike  staff   419 Nov 18 19:32
drwxr-xr-x  6 mike  staff   204 Dec  5 20:04 actions
-rwxr-xr-x  1 mike  staff  3132 Dec  5 20:04
drwxr-xr-x  5 mike  staff   170 Dec  5 18:06 functions
drwxr-xr-x  4 mike  staff   136 Dec  3 20:25 iso
-rwxr-xr-x  1 mike  staff   865 Nov 18 19:32

The iso directory needs to contain a single ISO image for Mirantis OpenStack, which you can deploy by starting with Fuel, so you’ll need to cd to that directory. For example:

-% md5sum MirantisOpenStack-6.0.iso
6ea53431e6e2f507840edf46044746b4  MirantisOpenStack-6.0.iso

-% md5sum MirantisOpenStack-6.0.img 
b4b1ec2f2a12beb20eaaf6f14511d512  MirantisOpenStack-6.0.img

-% md5sum MirantisOpenStack-6.0-upgrade.tar.lrz
4538309980f8ba8da2811e3bc9d87be5  MirantisOpenStack-6.0-upgrade.tar.lrz

The file contains a configuration that can be fine-tuned. For example, you can select how many virtual nodes to launch and how much memory to give them. For a purely physical install, you can even set the number of virtual child nodes to create to zero.

Since your OpenStack deployment starts with Fuel, run the Fuel launch script:

-% ./
  • Once executed, this script picks up an image from the
    directory, creates a VM, mounts the image to this VM, and automatically installs the admin node. 
  • Once the installation of the admin node is complete, Fuel will create slaves for Mirantis OpenStack and PXE-boot them from the admin node. (Using bare-metal nodes? Be sure they’re on the same L2 network as the admin node and PXE boot them; Fuel will discover them automatically.) 
  • Finally, the installer gives you a link to access the Web-based UI for the admin node. Follow that URL and start installation of the cluster.

And, say hello to Mirantis OpenStack!