*** OpenBSD on soekris quick install guide
***              (C)opyleft 2006 by Dettus 
***                    as of May, 2nd 2006
******************************************

0. Disclaimer
-------------
This mini-howto is the shortest way of installing OpenBSD on your soekris
computer. You won't need to set up nfsd or bootp for that one. It is meant
exclusively for those people how wish to have a mass-storage device like a
hard-drive or a compact-flash-card in it.
All you need is a bootfloppy, a dhcpd- and a tftpd-server. You might need a
runinng OpenBSD-box for this one.

1. Setting up a dhcpd-server
----------------------------
If you haven't already got a dhcp-server up and running, all you need is the
following dhcpd.conf-file:

  allow booting;
  allow bootp;
  option routers 192.168.1.1;
  option subnet-mask 255.255.255.0;
  option domain-name-servers 192.168.1.1;
  default-lease-time 21600;
  max-lease-time 43200;

  subnet 192.168.1.0 netmask 255.255.255.0 {
	range 192.168.1.100 192.168.1.200;
        next-server 192.168.1.1;
        filename "pxeboot";
  }

The 'filename "pxeboot"'- along with the 'allow' lines are the ones setting up
a bootserver. Start your dhcpd by typing 

 % dhcpd -d sis0

(sis0 being your ethernet device)

 lines are the ones setting up
a bootserver. Start your dhcpd by typing 

 % dhcpd -d sis0

(sis0 being your ethernet device on the dhcpd-server)

2. Setting up tftpd
-------------------
For tftpd, all you need is a directory somewhere on your harddrive. For example
/tftpboot.

  % mkdir /tftpboot
  % cd /tftpboot

Get the files pxeboot and floppy39.fs from an OpenBSD-server of your choosing.

  % wget ftp://ftp.openbsd.org/pub/OpenBSD/3.9/i386/pxeboot
  % wget ftp://ftp.openbsd.org/pub/OpenBSD/3.9/i386/floppy39.fs

Mount the floppy-image, and copy the to files "bsd" and "boot" to /tftpboot

  % vnconfig /dev/svnd0c floppy39.fs
  % mount /dev/svnd0c /mnt
  % cp /mnt/* /tftpboot
  % umount /mnt
  % vnconfig -u /dev/svnd0c

Set up a file called /tftpboot/etc/boot.conf, containing the two following lines

  stty com0 19200
  set tty com0

(assuming that your soekris' serial console speed is 19200 baud)

And your set. Start the tftpd

  % /usr/libexec/tftpd -s /tftpboot

Check if it is running

  % cd
  % tftp localhost
  tftp> get pxeboot

If not, go the inetd.conf way: Add the following lines to your /etc/inet.conf

  tftp  dgram   tcp   wait    root    /usr/libexec/tftpd      tftpd -s /tftpboot
  tftp  dgram   tcp6  wait    root    /usr/libexec/tftpd      tftpd -s /tftpboot
  tftp  dgram   udp   wait    root    /usr/libexec/tftpd      tftpd -s /tftpboot
  tftp  dgram   udp6  wait    root    /usr/libexec/tftpd      tftpd -s /tftpboot

and restart inetd by typeing

  % pkill -HUP inetd.conf

3. Boot your soekris
--------------------
That's it! Now you are set to boot up your soekris machine. Connect it to a
computer of your choosing, via the serial device. Fire up minicom, or tip, cu,
whatever, and press Ctrl-p when said so.
Use the 
 
  > boot f0

command there. You will be dropped of at the "(I)nstall, (U)pgrade or (S)hell"
prompt. Happy installing!

(Get the latest version at 
http://www.dettus.net/openbsd_on_soekris_quickinstall.txt)




________          __    __                 .____  ____  ___          ___\./
\______ \   _____/  |__/  |_ __ __  ______ |   _| \   \/  /___  ___ |_  /|\ 
 |    |  \_/ __ \   __\   __\  |  \/  ___/ |  |    \     / \  \/  /   |  |
 |    `   \  ___/|  |  |  | |  |  /\___ \  |  |    /     \  >    <    |  |
/_______  /\___  >__|  |__| |____//____  > |  |_  /___/\  \/__/\_ \  _|  |
        \/     \/                      \/  |____|       \_/      \/ |____|