Merge lp:~nick-schutt/lava-project/nicks_add_calxeda_docs into lp:lava-project

[Nicholas Schutt]

add dhclient files

[lp:~nick-schutt/lava-project/nicks_add_calxeda_docs]

58. By Nicholas Schutt on 2013-04-22

add files for dhclient to initramfs

=== modified file 'doc/ipmi-pxe-deploy.rst'
--- doc/ipmi-pxe-deploy.rst	2013-04-17 15:19:32 +0000
+++ doc/ipmi-pxe-deploy.rst	2013-04-22 13:53:29 +0000
@@ -229,12 +229,52 @@
 Creating the kernel and initrd for pxe booting
 ..............................................
 
-An initrd can be created from a running ubuntu system/
+An initrd can be created from a running ubuntu system
 
 1. Install ubuntu on a target server.
 
-
-2. Specify what you need in a new initrd. Make sure to include any required libraries.
+2. Set up busybox for initrd. 
+
+Note: It is important to include a full-featured version of busybox. This version
+must support the 'busybox --install -s' command to automatically install links
+to commands that can then be called from a bash shell.
+
+Copy the correct version of busybox into /usr/lib/initramfs-tools/bin:
+
+::
+
+  $ /bin/busybox
+  BusyBox v1.19.3 (Ubuntu 1:1.19.3-7ubuntu1.1) multi-call binary.
+  Copyright (C) 1998-2011 Erik Andersen, Rob Landley, Denys Vlasenko
+  and others. Licensed under GPLv2.
+  See source distribution for full notice.
+
+  Usage: busybox [function] [arguments]...
+     or: busybox --list[-full]
+     or: function [arguments]...
+
+          BusyBox is a multi-call binary that combines many common Unix
+          utilities into a single executable.  Most people will create a
+          link to busybox for each function they wish to use and BusyBox
+          will act like whatever it was invoked as.
+
+  Currently defined functions:
+          [, [[, adjtimex, ar, arp, arping, ash, awk, basename, blockdev, brctl, bunzip2, bzcat, bzip2, cal, cat, chgrp, chmod, chown,
+          chroot, chvt, clear, cmp, cp, cpio, crond, crontab, cttyhack, cut, date, dc, dd, deallocvt, depmod, df, diff, dirname, dmesg,
+          dnsdomainname, dos2unix, dpkg, dpkg-deb, du, dumpkmap, dumpleases, echo, ed, egrep, env, expand, expr, false, fdisk, fgrep, find,
+          fold, free, freeramdisk, ftpget, ftpput, getopt, getty, grep, groups, gunzip, gzip, halt, head, hexdump, hostid, hostname, httpd,
+          hwclock, id, ifconfig, ifdown, ifup, init, insmod, ionice, ip, ipcalc, kill, killall, klogd, last, less, ln, loadfont, loadkmap,
+          logger, login, logname, logread, losetup, ls, lsmod, lzcat, lzma, md5sum, mdev, microcom, mkdir, mkfifo, mknod, mkswap, mktemp,
+          modinfo, modprobe, more, mount, mt, mv, nameif, nc, netstat, nslookup, od, openvt, passwd, patch, pidof, ping, ping6, pivot_root,
+          poweroff, printf, ps, pwd, rdate, readlink, realpath, reboot, renice, reset, rev, rm, rmdir, rmmod, route, rpm, rpm2cpio,
+          run-parts, sed, seq, setkeycodes, setsid, sh, sha1sum, sha256sum, sha512sum, sleep, sort, start-stop-daemon, stat, static-sh,
+          strings, stty, su, sulogin, swapoff, swapon, switch_root, sync, sysctl, syslogd, tac, tail, tar, taskset, tee, telnet, telnetd,
+          test, tftp, time, timeout, top, touch, tr, traceroute, traceroute6, true, tty, tunctl, udhcpc, udhcpd, umount, uname, uncompress,
+          unexpand, uniq, unix2dos, unlzma, unxz, unzip, uptime, usleep, uudecode, uuencode, vconfig, vi, watch, watchdog, wc, wget, which,
+          who, whoami, xargs, xz, xzcat, yes, zcat
+
+
+3. Specify additional binaries and libraries that you need in a new initrd.
 
 Note: The busybox command implements many commands by default, but it is best to
 include the actual binaries for each command since the busybox versions
@@ -252,25 +292,40 @@
 Note: It is good to include many common commands since the master initrd may be
 used for debugging issues.
 
+
 */usr/share/initramfs-tools/hooks/master-extras  (sample)*
 
 ::
 
   . /usr/share/initramfs-tools/hook-functions
 
+  copy_exec /bin/tar
+  copy_exec /bin/bzip2
+  copy_exec /bin/gzip
+  copy_exec /bin/ping
+  copy_exec /usr/bin/wget
+  copy_exec /sbin/ifconfig
+  copy_exec /sbin/parted
+  copy_exec /sbin/resize2fs
+  copy_exec /usr/bin/mkimage
   copy_exec /sbin/mkfs
   copy_exec /sbin/mkfs.ext2
   copy_exec /sbin/mkfs.ext3
   copy_exec /sbin/mkfs.ext4
   copy_exec /sbin/mkfs.vfat
-  copy_exec /sbin/ifconfig
-  copy_exec `which tar`
-  copy_exec `which bunzip2`
-  copy_exec `which dhclient`
-  copy_exec `which fdisk`
-  copy_exec `which parted`
-  copy_exec /bin/ping
-  copy_exec /usr/bin/wget
+  copy_exec /bin/nc
+  copy_exec /sbin/dhclient
+  copy_exec /sbin/fdisk
+  
+  # support dhclient
+  copy_exec /sbin/dhclient
+  copy_exec /sbin/dhclient-script
+  copy_exec /sbin/ip
+  copy_exec /bin/hostname
+  copy_exec /bin/rm
+  copy_exec /bin/mv
+  copy_exec /etc/fstab
+  
   copy_exec /lib/arm-linux-gnueabihf/libnss_compat-2.15.so
   copy_exec /lib/arm-linux-gnueabihf/libnss_compat.so.2
   copy_exec /lib/arm-linux-gnueabihf/libnss_dns-2.15.so
@@ -283,7 +338,7 @@
   copy_exec /lib/arm-linux-gnueabihf/libnss_nisplus-2.15.so
   copy_exec /lib/arm-linux-gnueabihf/libnss_nisplus.so.2
   copy_exec /lib/arm-linux-gnueabihf/libnss_nis.so.2
-
+  
   # Add bash
   copy_exec /bin/bash
   copy_exec /lib/arm-linux-gnueabihf/libtinfo.so.5
@@ -291,7 +346,7 @@
   copy_exec /lib/arm-linux-gnueabihf/libgcc_s.so.1
   copy_exec /lib/arm-linux-gnueabihf/libc.so.6
   copy_exec /lib/ld-linux-armhf.so.3
-
+  
   # Create version info for this image
   echo '#!/bin/sh' > /tmp/lava-master-image-info
   echo "echo $(date +%Y.%m.%d-%H.%M.%S)" > /tmp/lava-master-image-info
@@ -299,7 +354,7 @@
   copy_exec /tmp/lava-master-image-info /sbin
 
 
-3. Run update-initramfs, which will produce a new initrd image.
+4. Run update-initramfs, which will produce a new initrd image.
 
 ::
 
@@ -312,7 +367,7 @@
   /boot/initrd.img-3.5.0-23-highbank
 
 
-4. Copy initrd and vmlinuz to the tftp server
+5. Copy initrd and vmlinuz to the tftp server
 
 
 Debugging with initrd