| Sean M. Collins | 09e550c | 2014-10-21 11:40:08 -0400 | [diff] [blame^] | 1 | `DevStack </>`__ |
| 2 | |
| 3 | - `Overview <../overview.html>`__ |
| 4 | - `Changes <../changes.html>`__ |
| 5 | - `FAQ <../faq.html>`__ |
| 6 | - `git.openstack.org <https://git.openstack.org/cgit/openstack-dev/devstack>`__ |
| 7 | - `Gerrit <https://review.openstack.org/#/q/status:open+project:openstack-dev/devstack,n,z>`__ |
| 8 | |
| 9 | Stack-in-a-Box: Try before you mkfs |
| 10 | =================================== |
| 11 | |
| 12 | Run DevStack from a RAM disk to give it a whirl before making the |
| 13 | commitment to install it. We'll cover booting from a USB drive or over |
| 14 | the network via PXE. We'll even thow in configuring a home router to |
| 15 | handle the PXE boot. You will need a minimum of 3GB for both of these |
| 16 | configurations as the RAM disk itself is 2GB. |
| 17 | |
| 18 | Prerequisites Hardware |
| 19 | ---------------------- |
| 20 | |
| 21 | USB Boot |
| 22 | ~~~~~~~~ |
| 23 | |
| 24 | `This guide <usb-boot.html>`__ covers the creation of a bootable USB |
| 25 | drive. Your computer BIOS must support booting from USB. |
| 26 | |
| 27 | PXE Boot |
| 28 | ~~~~~~~~ |
| 29 | |
| 30 | `This guide <pxe-boot.html>`__ covers the installation of OpenWRT on a |
| 31 | home router and configuring it as a PXE server, plus the creation of the |
| 32 | boot images and PXE support files. |
| 33 | |
| 34 | Installation bit blasting |
| 35 | ------------------------- |
| 36 | |
| 37 | Install DevStack |
| 38 | ~~~~~~~~~~~~~~~~ |
| 39 | |
| 40 | Grab the latest version of DevStack via https: |
| 41 | |
| 42 | :: |
| 43 | |
| 44 | sudo apt-get install git -y |
| 45 | git clone https://git.openstack.org/openstack-dev/devstack |
| 46 | cd devstack |
| 47 | |
| 48 | Prepare the Boot RAMdisk |
| 49 | ~~~~~~~~~~~~~~~~~~~~~~~~ |
| 50 | |
| 51 | Pick your boot method and follow the guide to prepare to build the RAM |
| 52 | disk and set up the boot process: |
| 53 | |
| 54 | - `USB boot <usb-boot.html>`__ |
| 55 | - `PXE boot <pxe-boot.html>`__ |
| 56 | |
| 57 | Fire It Up |
| 58 | ~~~~~~~~~~ |
| 59 | |
| 60 | - Boot the computer into the RAM disk. The details will vary from |
| 61 | machine to machine but most BIOSes have a method to select the boot |
| 62 | device, often by pressing F12 during POST. |
| 63 | - Select 'DevStack' from the Boot Menu. |
| 64 | - Log in with the 'stack' user and 'pass' password. |
| 65 | - Create ``devstack/localrc`` if you wish to change any of the |
| 66 | configuration variables. You will probably want to at least set the |
| 67 | admin login password to something memorable rather than the default |
| 68 | 20 random characters: |
| 69 | |
| 70 | :: |
| 71 | |
| 72 | ADMIN_PASSWORD=openstack |
| 73 | |
| 74 | - Fire up OpenStack! |
| 75 | |
| 76 | :: |
| 77 | |
| 78 | ./run.sh |
| 79 | |
| 80 | - See the processes running in screen: |
| 81 | |
| 82 | :: |
| 83 | |
| 84 | screen -x |
| 85 | |
| 86 | - Connect to the dashboard at ``http://<ip-address>/`` |
| 87 | |
| 88 | © Openstack Foundation 2011-2013 — this is not an official OpenStack |
| 89 | project... |