Merge "Remove old guides"
diff --git a/doc/source/guides/pxe-boot.rst b/doc/source/guides/pxe-boot.rst
deleted file mode 100644
index f745abb..0000000
--- a/doc/source/guides/pxe-boot.rst
+++ /dev/null
@@ -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.
diff --git a/doc/source/guides/ramdisk.rst b/doc/source/guides/ramdisk.rst
deleted file mode 100644
index 1ba74f2..0000000
--- a/doc/source/guides/ramdisk.rst
+++ /dev/null
@@ -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>/``
diff --git a/doc/source/guides/usb-boot.rst b/doc/source/guides/usb-boot.rst
deleted file mode 100644
index 4f7a494..0000000
--- a/doc/source/guides/usb-boot.rst
+++ /dev/null
@@ -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.