Bebop

What is?

Bebop is our PXE (read as in "pixie") system. We use it for install new machines over the network. If you want to install Linux on your box, you're welcome anytime to come, visit us and, of course, install Linux.

How does it work?

We have an OpenWRT router offering DHCP 'round the network and a local server where the boot images are hosted. The images are mounted on the router via NFS and served through TFTP. That's all!

How can i reproduce Bebop in my local network?

Prepare a folder on your local server

Assumptions

• You're running Debian<ref> Debian Home Page on your local server. If not, please refer to the documentation of your distro.

Steps

• SSH to your local server with proper credentials:

   $ ssh user@server

• Gain root privileges:

   $ sudo -i

• Install NFS, if not installed:

   $ apt-get install nfs-kernel-server nfs-common

• Create a directory wherever you want to store the boot images:

   $ mkdir /path/to/optimal/place

• Make the directory accesible through NFS:

   $ echo "/path/to/optimal/place"    *(ro,no_subtree_check)" >> /etc/exports

• Logout form the server:

   Ctrl-D # exit from sudo
   Ctrl-D # exit from ssh login

Prepare your router to serve the files through tftp

Assumptions

• You have already configured a router with OpenWRT

Steps

• SSH to your router with proper credentials:

   $ ssh root@myrouter

• Create a directory for mounting the files over the network:

   $ mkdir /mnt/tftpboot

• Install the folowing packages to enable nfs features:

   $ opkg install nfs-utils kmod-fs-nfs kmod-fs-nfs-common

• Edit fstab to automatically mount the nfs directory at boot time:

   $ vi /etc/config/fstab
   # add the folowing entry
   config 'mount'
       option 'target' '/mnt/pxe'
       option 'device' 'YOUR.LOCAL.SERVER.IP:/path/to/optimal/place/'
       option 'fstype' 'nfs'
       option 'options' 'nolock'
       option 'enabled' 1

• If the automount does not work, you can manually boot with:

   $ mount -t nfs MY.LOCAL.SERVER.IP:/path/to/optimal/place /mnt/tftpboot -o nolock

• Edit /etc/config/dhcp to enable tftp. It should look like:

   $ vi /etc/config/dhcp
   
   config dnsmasq
       ... a lot of config done before...
       option enable_tftp '1'
       option tftp_root '/mnt/tftpboot'
       ... a lot more config
   
   config boot 'linux'
       option filename 'pxelinux.0'
       option serveraddress 'MY.ROUTER.IP.ADDRESS'
       option servername 'router'

• Reboot your router

   $ reboot