blob: 2a05f89d89b21a3a65c535fbaabed3ef03e02379 [file] [log] [blame]
Dean Troyer54b97322014-06-20 17:53:55 -05001<!DOCTYPE html>
2<html lang="en">
3 <head>
4 <meta charset="utf-8">
5 <title>USB Boot Server Guide - DevStack</title>
6 <meta name="description" content="">
7 <meta name="author" content="">
8
9 <!-- Le HTML5 shim, for IE6-8 support of HTML elements -->
10 <!--[if lt IE 9]>
11 <script src="http://html5shim.googlecode.com/svn/trunk/html5.js"></script>
12 <![endif]-->
13
14 <!-- Le styles -->
15 <link href="../assets/css/bootstrap.css" rel="stylesheet">
16 <link href="../assets/css/local.css" rel="stylesheet">
17 <style type="text/css">
18 body { padding-top: 60px; }
19 dd { padding: 10px; }
20 </style>
21
22 <!-- Le javascripts -->
23 <script src="../assets/js/jquery-1.7.1.min.js" type="text/javascript" charset="utf-8"></script>
24 <script src="../assets/js/bootstrap.js" type="text/javascript" charset="utf-8"></script>
25 </head>
26
27 <body>
28
29 <div class="navbar navbar-fixed-top">
30 <div class="navbar-inner">
31 <div class="container">
32 <a class="brand" href="/">DevStack</a>
33 <ul class="nav pull-right">
34 <li><a href="../overview.html">Overview</a></li>
35 <li><a href="../changes.html">Changes</a></li>
36 <li><a href="../faq.html">FAQ</a></li>
Adrien Cunineaff3e12014-10-21 13:46:54 +020037 <li><a href="https://git.openstack.org/cgit/openstack-dev/devstack">git.openstack.org</a></li>
Dean Troyer54b97322014-06-20 17:53:55 -050038 <li><a href="https://review.openstack.org/#/q/status:open+project:openstack-dev/devstack,n,z">Gerrit</a></li>
39 </ul>
40 </div>
41 </div>
42 </div>
43
44 <div class="container">
45 <section id="overview">
46 <h1>USB Boot: Undoable Stack Boot</h1>
47 <p>Boot DevStack from a USB disk into a RAM disk.</p>
48 </section>
49
50 <section id="requirements">
51 <div class="page-header">
52 <h2>Prerequisites</h2>
53 </div>
54
55 <h3>Hardware</h3>
56 <p>This guide covers the creation of a bootable USB drive. Your
57 computer BIOS must support booting from USB and You will want at least 3GB of
58 RAM. You also will need a USB drive of at least 2GB.</p>
59
60 <h3>Software</h3>
61 <p>Ubuntu 11.10 (Oneiric Ocelot) is required on host to create images.</p>
62 </section>
63
64 <section id="installation">
65 <div class="page-header">
66 <h2>Installation <small>bit blasting</small></h2>
67 </div>
68
69 <h3>Set Up USB Drive</h3>
70 <ul>
71 <li>Insert the USB drive into the computer. Make a note of the device name, such as
72 <code>sdb</code>. Do not mount the device.</li>
73 <li>Install the boot system:
74 <pre>tools/build_usb_boot.sh /dev/sdb1</pre>
75 <p>This calls tools/build_ramdisk.sh to create a 2GB ramdisk
76 containing a complete development Oneiric OS plus the
77 OpenStack code checkouts. It then writes a syslinux boot sector
78 to the specified device and creates <code>/syslinux</code>.</p>
79 </li>
80 <li>If desired, you may now mount the device:
81 <pre>mount /dev/sdb1 /mnt/tmp
82# foo
83umount /mnt/tmp</pre>
84 </li>
85 </ul>
86
87 <p>Now <a href="ramdisk.html">return</a> to the RAM disk Guide to kick
88 off your DevStack experience.</p>
89
90 </section>
91
92 <footer>
93 <p>&copy; Openstack Foundation 2011-2013 &mdash; this is not an official OpenStack project...</p>
94 </footer>
95
96 </div> <!-- /container -->
97
98 </body>
99</html>