$Id: INSTALLATION.txt,v 1.3 2000/11/13 08:19:05 nisimura Exp $ //// How to install NetBSD/luna68k //// There are two ways to boot NetBSD kernel on your LUNA. - network boot using "isiboot" - place NetBSD kernel on the root directory of the LUNA original disk Because there is no provision of installation kernel tailored to run in standalone with the help of memory disk, either way requires to prepare an initial filesystem on an NFS server. o Preparing filesystem to NFS mount NetBSD/luna68k is a cousin of various m68k port of NetBSD. Any set of m68k distribution is useful to run NetBSD/luna68k with minor adjustments as described below. Inflate two files, base.tgz and etc.tgz, to the NFS server. Then replace two files, 'etc/ttys' and 'dev/MAKEDEV', with ones found in ~ftp/NetBSD/luna68k/ directory of NetBSD ftp servers. Make sure to run 'sh ./MAKEDEV all' in dev/ directory. o Preparing BOOTP/DHCP network service NetBSD kernel requests its network parameters and NFS mount point. You need to know its station address (Ethernet MAC address), which can be found using ROM monitor (see how to do). Here is the sample configuration of /etc/bootptab; dayan:\ ht=ethernet:ha=00000a02430f:ip=10.1.1.106:sm=255.255.255.0:\ gw=10.1.1.1:rp=/ccd/filesys/luna68k: where rp= field tells NFS root directory for LUNA exported by NFS server. bf= field is unneccessary to have. Another sample configuration for /etc/dhcpd.conf; group { option subnet-mask 255.255.255.0; option broadcast-address 10.1.1.255; option routers 10.1.1.1; host dayan { hardware ethernet 00:00:0a:02:43:0f; fixed-address 10.1.1.106; next-server 10.1.1.101; option root-path "/ccd/filesys/luna68k"; } } o Network boot with 'isiboot' LUNA ROM monitor can download kernel image via network. 'isiboot' serves this purpose. The server program requires BPF (Berkeley Packet Filter) in the servicing machine to work. The source code of 'isiboot' can be found ~ftp/NetBSD/arch/luna68k/ directory of NetBSD ftp servers. The description is here. SYNOPSIS isiboot [-i interface] [-s directory] [-d tracelevel] DESCRIPTION isiboot is a server which supports LUNA network boot. It listens to ROM monitor download requests and serves for it. The proprietary protocol uses a special Ethernet type and works within a local wire. -i isiboot searchs available network interfaces and chooses one found first. If the servicing machine has multiple network interfaces in action, this option can be used to specify which network interface to use. -s whose directory isiboot server makes chroot(2) to after invocation. Given no provision, isiboot searchs the downloading files in the current directory when started. -d accepts value 1, 2 or 3. Greater number provides more detailed trace. The protocol uses server's hostname to start the downloading dialogue. isiboot makes the name using gethostname(3) trimmed down by the first dot '.' if applicable. [1] Invoke isiboot program on the root directory of NetBSD/luna68k filesystem on NFS server. Use -s option when necessary. [2] Manipulate LUNA ROM monitor as follows; Given '> ' ROM monitor prompt; >[k] start to change boot parameters, ctlr: dk [et] specify network boot, home: omron type a return, isiboot doesn't care this field, sver: servername type another return, fnam: server:/vmunix [pelican:netbsd] specify server hostname and the filename to download. Leading / is not significant. Then type 'g' ROM monitor command to start downloading. You will see the progress like; >[g] text(776872)+data(49788)+bss(131942) When completed, type 'x' ROM monitor command with '-s' string to run NetBSD kernel. -s specifies not to start multiuser mode. >[x -s] The kernel starts to configure itself, and requests BOOTP/DHCP on wire to get network parameters and the name of filesystem to mount. After receving a proper reply, NetBSD/luna68k kernel invokes single user mode shell eventually. o Booting from disk NetBSD/luna68k kernel can be booted off from the vender supplied original operating system. Place kernel image on the root directory, then type to ROM monitor as follows; >[k] ctlr: dk type just a return to make no change, drv: 0 return, par: c and another return, fnam: vmunix [netbsd] specify the name of NetBSD/luna68k kernel. >[g] load the kernel image from disk. Litting front panel LED tells activity. >[x -sa] run the kernel, where -sa instructs to ask which filesystem to mount. Now, tells kernel to mount filesystem provided by NFS server; boot device: sd0 root device (default on sd0a): [le0] le0 to use NFS dump device: return to choose default filesystem (default generic): another return to choose Then kernel requests BOOTP/DHCP for network parameters and its root directory, and eventually invokes single user mode shell when successful. o Installing NetBSD/luna68k on disk NetBSD 'sysinst' utility is not prepared for NetBSD/luna68k. Here is the instruction for manual installation. It's reasonable and prefered to make fresh filesystems from scratch. Vender supplied OS has such a rather obscure convention to keep its root filesystem on partition c that's not comfortable with NetBSD standard. Use disklabel(8) command to make the new filesystem layout. LUNA ROM monitor can search and load kernel images on the root filesystem. To make this possible, the root filesystem must be created in the 'old FFS' format. Make sure to have -O (large letter oh) for newfs(8). Other filesystems do not require the option. Then mount the root filesystem somewhere, say /mnt, and other filesystems for usr/ or var/ underneath it. If you have NetBSD distribution sets on a certain NFS mounted point, goto the directory and then issue a simple loop; # for i in *.tgz do (cd /mnt && tar xvfp - ) < $i done When completed, make sure to place NetBSD/luna68k kernel image on /mnt directory and to replace two files, etc/ttys and dev/MAKEDEV. Run 'sh ./MAKEDEV all' on /mnt/dev/ directory to have device nodes. It's ok to halt the system now by typing 'halt' for # prompt. o Arrange ROM boot parameters for daily use >[k] ctlr: dk type just a return to make no change, drv: 0 another return, par: c [a] change to choose 'a' partion to load, fnam: vmunix [netbsd] >[k+] store those into NVRAM ### EoF (addition and correction to follow) ###