Network boot installation instructions

Preparing

1. Ensure your router is able to boot OpenWGT correctly. If not, follow installation instructions here.
2. You have to get a tarball for OpenWGT rootfs from here.

Setting up TFTP, NFS and DHCP server

1. Use your package manager to install a tftpd, nfs-server-tools and dhcpd:

   # if you have a SuSE Linux system
   $ yast -i tftp nfs-utils dhcp-server
   
   # if you have a Debian GNU/Linux system
   $ apt-get install tftpd nfs-kernel-server dhcp3-server
   

TFTP server

1. Afterwards you have to enable the tftpd via inetd or xinetd. For inetd add/change the following line into your /etc/inetd.conf:

   tftp            dgram   udp     wait    nobody  /usr/sbin/tcpd  /usr/sbin/in.tftpd /tftpboot
   

   For xinetd (standard on newer SuSE Linux installations) the /etc/xinetd.d/tftp should looks like:

   service tftp
   {
           socket_type             = dgram
           protocol                = udp
           wait                    = yes
           user                    = root
           server                  = /usr/sbin/in.tftpd
           server_args             = -s /tftpboot
           disable                 = no
   }
   

   So you have to turn the switch disable = yes to disable = no.

NFS server

1. Unpack the downloaded tarball (openwgt-netboot-0.06.tgz) to /wgtroot

   $ mkdir /wgtroot
   $ tar xzf openwgt-netboot-0.06.tgz -C /wgtroot
   

2. Add following line into your /etc/exports:

   /wgtroot	192.168.0.0/16(ro,async,no_root_squash)
   

3. Make a link to a desired kernel:

   $ ln -s /wgtroot/boot/kernel-netboot24-0.06 /tftpboot/vmlinux
   # or
   $ ln -s /wgtroot/boot/kernel-netboot26-0.06 /tftpboot/vmlinux
   

DHCP server

1. Setup a small configuration for your subnet (/etc/dhcpd.conf or /etc/dhcp3/dhcpd.conf):

   #
   # Sample configuration file for ISC dhcpd
   #
   
   option domain-name "lan.home";
   option domain-name-servers 192.168.1.254;
   
   default-lease-time 18000;
   max-lease-time 72000;
   
   ddns-update-style none; ddns-updates off;
   
   # Use this to send dhcp log messages to a different log file (you also
   # have to hack syslog.conf to complete the redirection).
   log-facility local7;
   
   
   subnet 192.168.1.0 netmask 255.255.255.0 {
     range 192.168.1.201 192.168.1.220;
     option broadcast-address 192.168.1.255;
     option routers 192.168.1.254;
   
     host wgt_a {
       hardware ethernet 00:0f:b5:xx:xx:xx;
       fixed-address 192.168.1.200;
     }
   }
   

2. Set the interface dhcpd will listen on:
   
   • SuSE: /etc/sysconfig/dhcpd

     DHCPD_INTERFACE="eth0"
     

   • Debian: /etc/default/dhcp3-server

     INTERFACES="eth0"
     

Start services

/etc/init.d/xinetd restart
/etc/init.d/nfsserver restart
/etc/init.d/dhcpd restart

# or Debian
/etc/init.d/inetd restart
/etc/init.d/nfs-kernel-server restart
/etc/init.d/dhcp3-server restart

Changing CFE environment and kernel command line

1. TODO

Rootfs on USB storage installation instructions

Preparing

1. Ensure your router is able to boot OpenWGT correctly. If not, follow installation instructions here.
2. You have to get a tarball for OpenWGT rootfs from here.

Install on USB storage device

1. Plug the USB device in your PC.
2. If necessary make a backup of the files stored on that device.
3. Look for the correct (scsi) device, representing the USB device with dmesg.
4. Create partitions on the USB device (e.g. with fdisk). Ensure the destination partition for the rootfs is a primary one between number 1-4. You can also use the entire device without partitioning it.
5. If e.g. /dev/sda1 is the destination rootfs-device, create an ext3 filesystem on it:
   

   $ mkfs.ext3 /dev/sda1

6. Now copy the content of the tarball on the USB device:
   

   $ mount /dev/sda1 /mnt; tar xvzf openwgt-usb-0.06.tgz -C /mnt

7. For using it, just plugin the device BEFORE power on the WGT634U.

Last modified: 2005-07-29, 00:50 - Mathias Jeschke