openstack/devstack
Code Issues Proposed changes

Merge "Remove old guides"

Browse Source
This commit is contained in:
Jenkins 2014-11-05 08:13:48 +00:00 committed by Gerrit Code Review
commit bd4fe54fa4
3 changed files with 0 additions and 283 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

140
doc/source/guides/pxe-boot.rst
View File

@ -1,140 +0,0 @@
`DevStack </>`__
- `Overview <../overview.html>`__
- `Changes <../changes.html>`__
- `FAQ <../faq.html>`__
- `git.openstack.org <https://git.openstack.org/cgit/openstack-dev/devstack>`__
- `Gerrit <https://review.openstack.org/#/q/status:open+project:openstack-dev/devstack,n,z>`__
PXE Boot Server Guide: Magic Dust for Network Boot
==================================================
Boot DevStack from a PXE server to a RAM disk.
Prerequisites Hardware & OpenWRT
--------------------------------
Hardware
~~~~~~~~
The whole point of this exercise is to have a highly portable boot
server, so using a small router with a USB port is the desired platform.
This guide uses a Buffalo WZR-HP-G300NH as an example, but it is easily
generalized for other supported platforms. See openwrt.org for more.
OpenWRT
~~~~~~~
Any recent 'Backfire' build of OpenWRT will work for the boot server
project. We build from trunk and have made the images available at
`http://openwrt.xr7.org/openwrt <http://openwrt.xr7.org/openwrt>`__.
Installation bit blasting
-------------------------
Install the Image
~~~~~~~~~~~~~~~~~
This process follows `the OpenWRT doc OEM
Install <http://wiki.openwrt.org/toh/buffalo/wzr-hp-g300h>`__ to tftp
the new image onto the router. You need a computer to set up the router,
we assume it is a recent Linux or OS/X installation.
- Get openwrt-ar71xx-wzr-hp-g300nh-squashfs-tftp.bin
::
wget http://openwrt.xr7.org/openwrt/ar71xx/openwrt-ar71xx-wzr-hp-g300nh-squashfs-tftp.bin
- Connect computer to LAN port 4 (closest to WAN port)
- Set computer interface to IP address in the 192.168.11.2
- Add static arp entry for router
::
arp -s 192.168.11.1 <mac-address>
- Start TFTP transfer attempt
::
tftp 192.168.11.1
binary
rexmt 1
timeout 60
put openwrt-ar71xx-wzr-hp-g300nh-squashfs-tftp.bin
- Power on router. Router will reboot and initialize on 192.168.1.1.
- Delete static arp entry for router
::
arp -d 192.168.11.1
- Set computer to DHCP, connect and telnet to router and set root
password.
Configure the Router
~~~~~~~~~~~~~~~~~~~~
- Update ``/etc/opkg.conf`` to point to our repo:
::
src/gz packages http://192.168.5.13/openwrt/build/ar71xx/packages
- Configure anon mounts:
::
uci delete fstab.@mount[0]
uci commit fstab
/etc/init.d/fstab restart
- Reset the DHCP address range. DevStack will claim the upper /25 of
the router's LAN address space for floating IPs so the default DHCP
address range needs to be moved:
::
uci set dhcp.lan.start=65
uci set dhcp.lan.limit=60
uci commit dhcp
- Enable TFTP:
::
uci set dhcp.@dnsmasq[0].enable_tftp=1
uci set dhcp.@dnsmasq[0].tftp_root=/mnt/sda1/tftpboot
uci set dhcp.@dnsmasq[0].dhcp_boot=pxelinux.0
uci commit dhcp
/etc/init.d/dnsmasq restart
Set Up tftpboot
~~~~~~~~~~~~~~~
- Create the ``/tmp/tftpboot`` structure and populate it:
::
cd ~/devstack
tools/build_pxe_boot.sh /tmp
This calls ``tools/build_ramdisk.sh`` to create a 2GB ramdisk
containing a complete development Oneiric OS plus the OpenStack code
checkouts.
- Copy ``tftpboot`` to a USB drive:
::
mount /dev/sdb1 /mnt/tmp
rsync -a /tmp/tftpboot/ /mnt/tmp/tftpboot/
umount /mnt/tmp
- Plug USB drive into router. It will be automounted and is ready to
serve content.
Now `return <ramdisk.html>`__ to the RAM disk Guide to kick off your
DevStack experience.

86
doc/source/guides/ramdisk.rst
View File

@ -1,86 +0,0 @@
`DevStack </>`__
- `Overview <../overview.html>`__
- `Changes <../changes.html>`__
- `FAQ <../faq.html>`__
- `git.openstack.org <https://git.openstack.org/cgit/openstack-dev/devstack>`__
- `Gerrit <https://review.openstack.org/#/q/status:open+project:openstack-dev/devstack,n,z>`__
Stack-in-a-Box: Try before you mkfs
===================================
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.
Prerequisites Hardware
----------------------
USB Boot
~~~~~~~~
`This guide <usb-boot.html>`__ covers the creation of a bootable USB
drive. Your computer BIOS must support booting from USB.
PXE Boot
~~~~~~~~
`This guide <pxe-boot.html>`__ 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.
Installation bit blasting
-------------------------
Install DevStack
~~~~~~~~~~~~~~~~
Grab the latest version of DevStack via https:
::
sudo apt-get install git -y
git clone https://git.openstack.org/openstack-dev/devstack
cd devstack
Prepare the Boot RAMdisk
~~~~~~~~~~~~~~~~~~~~~~~~
Pick your boot method and follow the guide to prepare to build the RAM
disk and set up the boot process:
- `USB boot <usb-boot.html>`__
- `PXE boot <pxe-boot.html>`__
Fire It Up
~~~~~~~~~~
- 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.
- Select 'DevStack' from the Boot Menu.
- Log in with the 'stack' user and 'pass' password.
- Create ``devstack/localrc`` 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:
::
ADMIN_PASSWORD=openstack
- Fire up OpenStack!
::
./run.sh
- See the processes running in screen:
::
screen -x
- Connect to the dashboard at ``http://<ip-address>/``

57
doc/source/guides/usb-boot.rst
View File

@ -1,57 +0,0 @@
`DevStack </>`__
- `Overview <../overview.html>`__
- `Changes <../changes.html>`__
- `FAQ <../faq.html>`__
- `git.openstack.org <https://git.openstack.org/cgit/openstack-dev/devstack>`__
- `Gerrit <https://review.openstack.org/#/q/status:open+project:openstack-dev/devstack,n,z>`__
USB Boot: Undoable Stack Boot
=============================
Boot DevStack from a USB disk into a RAM disk.
Prerequisites
-------------
Hardware
~~~~~~~~
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.
Software
~~~~~~~~
Ubuntu 11.10 (Oneiric Ocelot) is required on host to create images.
Installation bit blasting
-------------------------
Set Up USB Drive
~~~~~~~~~~~~~~~~
- Insert the USB drive into the computer. Make a note of the device
name, such as ``sdb``. Do not mount the device.
- Install the boot system:
::
tools/build_usb_boot.sh /dev/sdb1
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 ``/syslinux``.
- If desired, you may now mount the device:
::
mount /dev/sdb1 /mnt/tmp
# foo
umount /mnt/tmp
Now `return <ramdisk.html>`__ to the RAM disk Guide to kick off your
DevStack experience.