<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>RAMdisk Boot 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>Stack-in-a-Box: Try before you mkfs</h1>
<p>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.</p>
</section>
<section id="requirements">
<div class="page-header">
<h2>Prerequisites <small>Hardware</small></h2>
</div>
<h3>USB Boot</h3>
<p><a href="usb-boot.html">This guide</a> covers the creation of a bootable USB drive. Your
computer BIOS must support booting from USB.</p>
<h3>PXE Boot</h3>
<p><a href="pxe-boot.html">This guide</a> 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.
</section>
<section id="installation">
<div class="page-header">
<h2>Installation <small>bit blasting</small></h2>
</div>
<h3>Install DevStack</h3>
<p>Grab the latest version of DevStack via https:</p>
<pre>sudo apt-get install git -y
git clone https://github.com/openstack-dev/devstack.git
cd devstack</pre>
<h3>Prepare the Boot RAMdisk</h3>
<p>Pick your boot method and follow the guide to prepare to build
the RAM disk and set up the boot process:</p>
<ul>
<li><a href="usb-boot.html">USB boot</a></li>
<li><a href="pxe-boot.html">PXE boot</a></li>
</ul>
<h3>Fire It Up</h3>
<ul>
<li>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.</li>
<li>Select 'DevStack' from the Boot Menu.</li>
<li>Log in with the 'stack' user and 'pass' password.</li>
<li>Create <code>devstack/localrc</code> 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:
<pre>ADMIN_PASSWORD=openstack</pre>
</li>
<li>Fire up OpenStack!
<pre>./run.sh</pre>
</li>
<li>See the processes running in screen:
<pre>screen -x</pre>
</li>
<li>Connect to the dashboard at <code>http://<ip-address>/</code></li>
</ul>
</section>
<footer>
<p>© Openstack Foundation 2011-2013 — this is not an official OpenStack project...</p>
</footer>
</div> <!-- /container -->
</body>
</html>