Merge "Remove old guides"
This commit is contained in:
Jenkins
Gerrit Code Review
commit
bd4fe54fa4
@ -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.
|
|
||||||
@ -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>/``
|
|
||||||
@ -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.
|
|
||||||
Loading…
Reference in New Issue
Block a user