Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
GitHub Mirror of OpenStack Compute (Nova)
Python C++ Shell Other

This branch is 12745 commits ahead, 1 commit behind rackerlabs:stackforge

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
apidocs
bin
bzrplugins/novalog
contrib
dbaas-mycnf
doc
etc/nova
firstboot
integration
nova
patches
plugins/xenserver
po
reddwarf-guest
reddwarf
reddwarfclient
rsdns
smoketests
tools
xsd
.bzrignore
.gitignore
.gitreview
.mailmap
Authors
HACKING
LICENSE
MANIFEST.in
README
README.rst
builddeb.sh
pylintrc
run_tests.py
run_tests.sh
setup.cfg
setup.py

README.rst

Reddwarf (Database As A Service)

Preface

Reddwarf is extending the OpenStack Nova to enable Database as a Service.

Get more information and get involved with the OpenStack community.

Getting Started

The information below is set to be run on a VM. Inside 'integration/vagrant' folder is a file called 'VagrantFile'. This is a script that runs with Vagrant (http://www.vagrantup.com) and VirtualBox (http://www.virtualbox.org/). The versions we are currently using are Vagrant version 0.8.7 and Virtualbox 4.1.4 r74291. Please be aware that virtualization must be enabled in your systems BIOS to get virtualbox running with ANY 64b image.

  1. Create a new Folder:

    [nix:~]$ mkdir ~/dev
    [nix:~]$ cd ~/dev
    
  2. (Required) Download the openvz glance image from:

    [nix:~/dev]$ mkdir ~/dev/glanceimg
    [nix:~/dev]$ cd ~/dev/glanceimg
    [nix:~/dev/glanceimg]$ wget http://c629296.r96.cf2.rackcdn.com/debian-squeeze-x86_64-openvz.tar.gz
    
  3. (Required) Define the environment variable for glance images (path to directory of debian-squeeze-x86_64-openvz.tar.gz):

    [nix:~/dev]$ export GLANCEIMAGES=~/dev/glanceimg
    
  4. Fresh check out from github.:

    [nix:~/dev]$ git clone git://github.com/rackspace/reddwarf.git
    
  5. Enter the directory reddwarf/integration/vagrant:

    [nix:~/dev]$ cd reddwarf/integration/vagrant
    
  6. Startup the Virtual Machine with Vagrant:

    [nix:~/dev/reddwarf/integration/vagrant]$ vagrant up
    

Command Downloads the necessary files and starts up a Virtual Box image to start using.

Quick Setup

  1. On your host machine (i.e. do NOT use vagrant ssh to enter it):

    [nix:~/dev/reddwarf/integration/vagrant]$ ./reddwarf-ci vagrantci
    

This automates all the manual steps below in order.

  1. Install dependencies (install)
  2. Build all the required packages (build)
  3. Initialize Nova environemnt (initialize)
  4. Run the CI tests (test)

Manual Setup Reddwarf

  1. This will ssh in to the virtual machine:

    [nix:~/dev/reddwarf/integration/vagrant]$ vagrant ssh
    
  2. This is the home location for vagrant and will have all the files in the integration/vagrant folder:

    [vagrant:~]$ cd /vagrant
    
  3. This will be sure the environment has all the required dependencies installed:

    [vagrant:/vagrant]$ reddwarf-ci install
    
  4. This will build all the packages required to start and run nova. This includes the guest-agent package that will run on the instances that listens for events from the API:

    [vagrant:/vagrant]$ reddwarf-ci build
    
  5. This will clean and prepare the environment to start running nova as a clean setup. You can run this multiple times to refresh the environment:

    [vagrant:/vagrant]$ reddwarf-ci initialize
    

Testing Reddwarf

This is the integration tests for reddwarf that will run a plethora of tests and be sure that everything is setup and working correctly.:

[vagrant:/vagrant]$ reddwarf-ci test

You can run specific groups of tests by specifying the group paramter. The below example shows running just the volume tests:

[vagrant:/vagrant]$ reddwarf-ci test --group=nova.volumes.driver

Starting Up Reddwarf/Nova Manually

  1. Start all the services in a screen session:

    [vagrant:/vagrant]$ reddwarf-ci start
    
  2. Stop all the screen services, also kills all the screen sessions:

    [vagrant:/vagrant]$ reddwarf-ci stop
    

Example Calls/Utilties for Reddwarf/Nova

  1. Open up a new terminal and goto integration/vagrant:

    [nix:~]$ cd ~/dev/reddwarf/integration/vagrant
    
  2. SSH into the vagrant box:

    [nix:~]$ vagrant ssh
    
  3. Go to the source bin directory:

    [vagrant:~]$ cd /src/bin
    
  4. Run reddwarf-cli:

    [vagrant:/src/bin]$ ./reddwarf-cli
    
  5. Authenticate:

    [vagrant:/src/bin]$ ./reddwarf-cli auth login admin admin dbaas
    
  6. Create an instance:

    [vagrant:/src/bin]$ ./reddwarf-cli instance create test 1 flavors/2
    [vagrant:/src/bin]$ ./reddwarf-cli instance list
    [vagrant:/src/bin]$ sudo vzlist
    [vagrant:/src/bin]$ sudo vzctl enter 1
    
  7. Create database:

    [vagrant:/src/bin]$ ./reddwarf-cli database create 1 testdb
    
  8. Create a user:

    [vagrant:/src/bin]$ ./reddwarf-cli user create 1 testuser testpass testdb
    
  9. Login to mysql:

    [vagrant:/src/bin]$ mysql -u testuser -ptestpass -h <ipaddress>
    
Something went wrong with that request. Please try again.