devstack/doc/source/guides/usb-boot.html
Monty Taylor 0cbddea50d Move the doc paths to match other repos
In order to build in the Infra system, we'd like to be able to reuse the
existing doc build macros. To support that, move docs/source to
doc/source and docs/html to doc/build/html.

Change-Id: Ibd8e8e82e54c69b182120df67e6ec6908fed2908
2014-10-14 12:13:07 -04:00

100 lines
3.4 KiB
HTML

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>USB Boot Server Guide - DevStack</title>
<meta name="description" content="">
<meta name="author" content="">
<!-- Le HTML5 shim, for IE6-8 support of HTML elements -->
<!--[if lt IE 9]>
<script src="http://html5shim.googlecode.com/svn/trunk/html5.js"></script>
<![endif]-->
<!-- Le styles -->
<link href="../assets/css/bootstrap.css" rel="stylesheet">
<link href="../assets/css/local.css" rel="stylesheet">
<style type="text/css">
body { padding-top: 60px; }
dd { padding: 10px; }
</style>
<!-- Le javascripts -->
<script src="../assets/js/jquery-1.7.1.min.js" type="text/javascript" charset="utf-8"></script>
<script src="../assets/js/bootstrap.js" type="text/javascript" charset="utf-8"></script>
</head>
<body>
<div class="navbar navbar-fixed-top">
<div class="navbar-inner">
<div class="container">
<a class="brand" href="/">DevStack</a>
<ul class="nav pull-right">
<li><a href="../overview.html">Overview</a></li>
<li><a href="../changes.html">Changes</a></li>
<li><a href="../faq.html">FAQ</a></li>
<li><a href="http://github.com/openstack-dev/devstack">GitHub</a></li>
<li><a href="https://review.openstack.org/#/q/status:open+project:openstack-dev/devstack,n,z">Gerrit</a></li>
</ul>
</div>
</div>
</div>
<div class="container">
<section id="overview">
<h1>USB Boot: Undoable Stack Boot</h1>
<p>Boot DevStack from a USB disk into a RAM disk.</p>
</section>
<section id="requirements">
<div class="page-header">
<h2>Prerequisites</h2>
</div>
<h3>Hardware</h3>
<p>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.</p>
<h3>Software</h3>
<p>Ubuntu 11.10 (Oneiric Ocelot) is required on host to create images.</p>
</section>
<section id="installation">
<div class="page-header">
<h2>Installation <small>bit blasting</small></h2>
</div>
<h3>Set Up USB Drive</h3>
<ul>
<li>Insert the USB drive into the computer. Make a note of the device name, such as
<code>sdb</code>. Do not mount the device.</li>
<li>Install the boot system:
<pre>tools/build_usb_boot.sh /dev/sdb1</pre>
<p>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 <code>/syslinux</code>.</p>
</li>
<li>If desired, you may now mount the device:
<pre>mount /dev/sdb1 /mnt/tmp
# foo
umount /mnt/tmp</pre>
</li>
</ul>
<p>Now <a href="ramdisk.html">return</a> to the RAM disk Guide to kick
off your DevStack experience.</p>
</section>
<footer>
<p>&copy; Openstack Foundation 2011-2013 &mdash; this is not an official OpenStack project...</p>
</footer>
</div> <!-- /container -->
</body>
</html>