devstack/doc/source/guides/usb-boot.rst
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

1.5 KiB

DevStack

USB Boot: Undoable Stack Boot

Boot DevStack from a USB disk into a RAM disk.

Prerequisites

Hardware

This guide covers the creation of a bootable USB drive. Your computer BIOS must support booting from USB and You will want at least 3GB of RAM. You also will need a USB drive of at least 2GB.

Software

Ubuntu 11.10 (Oneiric Ocelot) is required on host to create images.

Installation bit blasting

Set Up USB Drive

  • Insert the USB drive into the computer. Make a note of the device name, such as sdb. Do not mount the device.

  • Install the boot system:

    tools/build_usb_boot.sh /dev/sdb1

    This calls tools/build_ramdisk.sh to create a 2GB ramdisk containing a complete development Oneiric OS plus the OpenStack code checkouts. It then writes a syslinux boot sector to the specified device and creates /syslinux.

  • If desired, you may now mount the device:

    mount /dev/sdb1 /mnt/tmp
    # foo
    umount /mnt/tmp

Now return to the RAM disk Guide to kick off your DevStack experience.

© Openstack Foundation 2011-2013 — this is not an official OpenStack project...