54b9732339
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
120 lines
4.4 KiB
HTML
120 lines
4.4 KiB
HTML
<!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>
|