Files

Sean M. Collins 09e550c370 Convert all HTML doc to RST

The motivation for this conversion is to have DevStack's docs be
generated using a more familair workflow for OpenStack projects, using
Sphinx.

Changing from raw HTML to RST will also make it easier to contribute
more documentation, as well as making edits less of a hassle.

The majority of the work was done by using Pandoc to convert from HTML
to RST, with minor edits to the output to remove errors in Sphinx.

Change-Id: I9636017965aeade37b950ddf5bdb0c22ab9004bd

2014-10-22 12:27:00 -04:00

2.3 KiB

Raw Blame History

DevStack

Stack-in-a-Box: Try before you mkfs

Run DevStack from a RAM disk to give it a whirl before making the commitment to install it. We'll cover booting from a USB drive or over the network via PXE. We'll even thow in configuring a home router to handle the PXE boot. You will need a minimum of 3GB for both of these configurations as the RAM disk itself is 2GB.

Prerequisites Hardware

USB Boot

This guide covers the creation of a bootable USB drive. Your computer BIOS must support booting from USB.

PXE Boot

This guide covers the installation of OpenWRT on a home router and configuring it as a PXE server, plus the creation of the boot images and PXE support files.

Installation bit blasting

Install DevStack

Grab the latest version of DevStack via https:

sudo apt-get install git -y
git clone https://git.openstack.org/openstack-dev/devstack
cd devstack

Prepare the Boot RAMdisk

Pick your boot method and follow the guide to prepare to build the RAM disk and set up the boot process:

Fire It Up

Boot the computer into the RAM disk. The details will vary from machine to machine but most BIOSes have a method to select the boot device, often by pressing F12 during POST.
Select 'DevStack' from the Boot Menu.
Log in with the 'stack' user and 'pass' password.
Create devstack/localrc if you wish to change any of the configuration variables. You will probably want to at least set the admin login password to something memorable rather than the default 20 random characters:
```
ADMIN_PASSWORD=openstack
```
Fire up OpenStack!
```
./run.sh
```
See the processes running in screen:
```
screen -x
```
Connect to the dashboard at http://<ip-address>/

2.3 KiB Raw Blame History