devstack/docs/source/guides/usb-boot.html
Dean Troyer 54b9732339 Move static docs into master branch
The hand-maintained static HTML docs for DevStack have been in a
GitHub gh-pages branch; move them into the master branch in
preparation for hosting them in openstack.org infrastructure.

By default tools/build_docs.sh now builds the static HTML output
into docs/html.

Change-Id: Ide5f7d980a294c7a9f8a3decaed0939f1c239934
2014-06-20 18:04:55 -05: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>