From 17314d242e1fea5a5ebc602c2a72fc28fb5473b4 Mon Sep 17 00:00:00 2001 From: Dean Troyer Date: Wed, 29 Oct 2014 22:11:05 -0500 Subject: [PATCH] Remove old guides Change-Id: I2f8cd36aef1e0018ed4d5619c934dc9772823656 --- doc/source/guides/pxe-boot.rst | 140 --------------------------------- doc/source/guides/ramdisk.rst | 86 -------------------- doc/source/guides/usb-boot.rst | 57 -------------- 3 files changed, 283 deletions(-) delete mode 100644 doc/source/guides/pxe-boot.rst delete mode 100644 doc/source/guides/ramdisk.rst delete mode 100644 doc/source/guides/usb-boot.rst diff --git a/doc/source/guides/pxe-boot.rst b/doc/source/guides/pxe-boot.rst deleted file mode 100644 index f745abb7e4..0000000000 --- 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 `__ -- `Gerrit `__ - -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 `__. - -Installation bit blasting -------------------------- - -Install the Image -~~~~~~~~~~~~~~~~~ - -This process follows `the OpenWRT doc OEM -Install `__ 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 - -- 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 `__ 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 1ba74f2322..0000000000 --- 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 `__ -- `Gerrit `__ - -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 `__ covers the creation of a bootable USB -drive. Your computer BIOS must support booting from USB. - -PXE Boot -~~~~~~~~ - -`This guide `__ 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 `__ -- `PXE boot `__ - -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:///`` diff --git a/doc/source/guides/usb-boot.rst b/doc/source/guides/usb-boot.rst deleted file mode 100644 index 4f7a49425b..0000000000 --- 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 `__ -- `Gerrit `__ - -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 `__ to the RAM disk Guide to kick off your -DevStack experience.