Rackspace Private Cloud Sandbox is a fast, free, and easy way to install a Rackspace Private Cloud powered by OpenStack on a single physical device. This method is suitable for anyone who wants to install an OpenStack-powered private cloud for testing or demonstration purposes.
Rackspace Private Cloud Sandbox v1.0 runs Rackspace Private Cloud v4.2.1 powered by the Havana release of OpenStack.
Table of Contents
The Rackspace Private Cloud Sandbox system creates a Rackspace Private Cloud, including all of the APIs and services available in OpenStack Havana, using a single instance.
Because this is a single-node setup, this system does not provide a highly available or high performance solution. However, it is ideal for demonstrations and testing.
QEMU is used as the hypervisor. QEMU has the best performance in this environment, and it is capable of nesting virtualization: a virtual server with the capability to virtualize instances.
This system also features a Rackspace tab in the Horizon dashboard. This is a Python package which operates as a plugin for Horizon, so Horizon or any other upstream packages have not been changed. Because of this plugin, the Horizon cookbook template file for
local_settings.py was modified.
To set up the Rackspace Private Cloud Sandbox, you will require a physical machine with these specifications:
The Rackspace Private Cloud Sandbox system has two different OVAs. One is designed for VMWare Player, Fusion, and Workstation, and the other is designed for VirtualBox.
There is a known issue with the Chrome browser on Apple Mac computers. If you have the Hide Extensions option selected, Chrome will change the file extension from
This section explains how to import the appliance and start the VM on VMWare Player 6, Fusion 6, and Workstation 7 and later.
It is strongly recommended that you use this system on VMWare. You can download VMWare Player 6 for Windows or Linux from the VMWare site.
Download the OVA file and save it to your local device.
In VMWare, import the OVA file. Navigate to File-Import-Choose File .
Select the OVA file, and click Continue to import the virtual machine.
Click Start the VM to start the virtual machine.
When the VM is active, you will be able to use the OpenStack image without the need for bridged networking.
During the import process, you may experience the following messages:
This section explains how to set up Rackspace Private Cloud Sandbox using VirtualBox 4.3.x. Rackspace strongly recommends that you work on a clean installation of VirtualBox. You can download VirtualBox from the VirtualBox site.
VirtualBox provides many network options. While any network setup that functions in your environment will work, the recommended setup is:
In this networking environment, the only network type that you will need to configure is the host-only network. The internal network is configured from within the VM, and the bridged network is configured by the public network to which you are attached.
When the VM is imported, Adapter 1 is set up as a bridged network by default. The bridged device that is set up is an ethernet device, and needs to be the device that you use to connect to the internet. For example, a laptop may have a setting of en1 "wi-fi", whereas a desktop device may use en0 "Ethernet".
If you are not able to use a bridged network for any reason, you can change the network type for Adapter 1 to a NAT network. This will make instances inaccessible, but will still enable you to use all of the OpenStack APIs, including the OpenStack Dashboard.
The settings in the following procedure are a guide only, and might need to be adjusted to suit your environment.
Download the OVA file and save it to your local device.
In VirtualBox, navigate to Preferences-Network-Host-Only Networks.
Click on the icon to add a new host-only network and assign it a name.
Configure the host network settings:
IPv4 Address: 192.168.56.1 IPv4 Network Mask: 255.255.255.0 IPv6 Address:
<Leave this field blank>IPv6 Network Mask Length: 0
Configure the DHCP Server settings:
Server Address: 192.168.56.100 Server Mask: 255.255.255.0 Lower Address Bond: 192.168.56.200 Upper Address Bond: 192.168.56.254
After configuring these settings, click OK to create the network.
Navigate to File Import Choose File .
Select the OVA file, and click Import to import the virtual machine.
After the import process is complete, enable acceleration. Select the new virtual machine and navigate to Settings+System+Acceleration Select the following check boxes:
Configure the adapter settings as follows:
This defaults to the bridged adapter on the ethernet port, but can be set to NAT if you cannot use a bridged network due to network restrictions. However, you will not be able to connect to built instances from within the Sandbox cluster. You will still be able to use Horizon and connect to the built instances via the Horizon console.
Click OK to accept the settings and then click Start the VM to start the virtual machine. This could take a long time; however it will get faster once the image has been saved in the cache.
If the VM fails on first boot:
Log in to the virtual machine from a command prompt, and run these commands to prime the system for the first boot, and to display a list of devices and their corresponding hardware MAC addresses:
$ touch /opt/first.boot $ /sbin/ifconfig | grep -E ^eth
Return to Settings Network in the virtual machine and adjust the MAC addresses until they match those returned by the command.
Shut down the instance and restart it. If the set up has been successful, the instance will boot and be assigned an IP address for both local and external network connections. This could take a long time; however it will get faster once the image has been saved in the cache.
For general information about using the private cloud, refer to the Rackspace article "Creating an Instance in the Cloud".
To access the system, you can use the command line interface or the graphical Horizon dashboard. Both interfaces use the following default credentials:
If you access the system using the command line, the root user is enabled and has SSH access.
These credentials can be used to access any of the OpenStack APIs. For access to the environment variables needed to access the OpenStack APIs using the command line interface, look in the root user's
There is only one flavor available to the virtual machine in this system, which is the
512MB Standard Instance flavor. This ensures that instances are bootable even if they only have the minimum amount of RAM available to them. If you require new flavors, you can create them using either the command line interface, or the Horizon dashboard. The virtual machine comes with one image, Ubuntu 12.04.03.
Cinder is set up on this system as a loopback file. It is a COW file located at
/opt/cinder.img and will grow as you use it. A default Cinder volume type is also created, called
An SSH key is automatically created, called
adminKey, which can be used to boot instances.
When you build an instance, the first boot may take some time to complete. After the first boot, the image will be cached, and subsequent boots will be faster.
System performance is dependent on the speed of your network and of your host machine. The system uses nested hosting, which means that you are virtualizing a virtual machine host which is, in turn, virtualizing virtual machines. This means that it will frequently take some time to complete tasks using the APIs.
All interactions you have with built instances must occur on the host they were booted on. The instances will not be accessible outside of the host virtual machine. Although networking will function correctly, it is recommended that you do not put a lot of load on the built instances. Performance will decline quickly as more load is placed on the host machine.
© 2011-2013 Rackspace US, Inc.
Except where otherwise noted, content on this site is licensed under a Creative Commons Attribution-NonCommercial-NoDerivs 3.0 Unported License