\documentstyle[fullpage]{article}
\pagestyle{empty}
\addtolength{\topmargin}{-0.25in}
\addtolength{\textheight}{0.25in}
\addtolength{\oddsidemargin}{-0.25in}
\addtolength{\textwidth}{0.25in}
\begin{document}
\begin{center}
{\huge Getting Started With NetBSD/i386 on MITnet}
\end{center}
\bigskip

\noindent NetBSD is a free Unix for many platforms including Intel
386, 486, and Pentium machines.  This document complements the
attached NetBSD/i386 installation notes with some notes about
installing NetBSD/i386 on MITnet.  If you have any questions or
problems during installation, please send mail to {\tt
netbsd-help@mit.edu}.

\small
\begin{itemize}

\item You can get the installation disk images from
/afs/sipb/project/netbsd/i386/floppies.  To copy an image onto a
formatted disk from an Athena workstation, do:

{\tt
cd /usr/tmp\\
cp /afs/sipb/project/netbsd/i386/floppies/{\it image}.fs.gz .\\
gunzip {\it image}.fs.gz\\
dd if={\it image}.fs of=/dev/{\it floppy} bs=8k
}

where {\it image} is the name of the floppy you want to install, and
{\it floppy} is the floppy device for your workstation, which is {\tt
rfd0a} on Decstations, {\tt rdiskette} on Suns, {\tt rfd0h} on
RS6000s, {\tt fd0} on Linux, and {\tt rfd0a} on NetBSD.

\item When entering the cylinder offset for the NetBSD partition,
enter the NetBSD partition's {\em offset} from the first cylinder, not
the number of the first cylinder.  So if your NetBSD partition begins
at cylinder 251, enter 250.

\item You should probably choose a size of at least 16MB for your root
partition, since the Athena software takes up some space there.

\item You can install via NFS from sipb-nfs.mit.edu.  When the
installation floppy gives you a shell prompt, enter:

{\tt
ifconfig {\it device} 18.{\it xx}.{\it yy}.{\it zz} netmask 0xffff0000
{\it flags}\\
route add default 18.{\it xx}.0.1\\
mkdir /mnt/usr/distrib\\
mount -t nfs -o -s,-i 18.181.0.24:/u2/lockers/netbsd /mnt/usr/distrib\\
cd /mnt/usr/distrib/i386/binary/base10\\
Set\_tmp\_dir\\
{\rm [Hit enter when asked for a temporary directory]}\\
Extract base10\\
...
}

where {\it device} and {\it flags} are appropriate for your network
device (see the installation notes) and {\tt 18.{\it xx}.{\it yy}.{\it
zz}} is your IP address.  Repeat the last three commands for each
package you want to install.  You probably want most of the binary
packages as well as the security package in
/mnt/usr/distrib/i386/security.  The binary packages will take up
about 45MB total, and the kernel source package
(/mnt/usr/distrib/source/ksrc10) takes up about 20MB.

\item When you have finished installing NetBSD and have rebooted from
your hard disk, set up your network by editing /etc/myname to have
just your machine name (without the trailing ``.mit.edu''), creating
/etc/mygate containing the line {\tt 18.{\it xx}.0.1}, creating
/etc/hostname.{\it device} containing the line

{\tt inet {\it machinename}.mit.edu 0xffff0000 18.{\it xx}.255.255 {\it flags}}

and editing /etc/hosts to contain

{\tt \begin{tabular}{ll}
127.0.0.1 & localhost localhost.mit.edu\\
18.{\it xx}.{\it yy}.{\it zz} & {\it machinename} {\it machinename}.mit.edu\\
\end{tabular}}

\item When you have rebooted and your network works properly, you can
install Athena software by FTPing the Athena installation script from
sipb.mit.edu:

{\tt
cd /tmp\\
ftp 18.181.0.24\\
{\rm [Enter ``ftp'' as your username and your email address as your
password.]}\\
cd installkits/i386\_nbsd1\\
get i386-netbsd-athena-install.sh\\
quit\\
sh i386-netbsd-athena-install.sh
}

This script is intended to run on a freshly installed system, and will
install a new kernel with loadable kernel module and virtual console
support.  The installation script will also modify several system
files to support the Athena software, will install AFS and the basic
Athena configuration files in /etc/athena, and will create symlinks
from /usr/X11R6 and /usr/athena to the NetBSD system packs in the SIPB
AFS cell.

\item When you are done with the Athena installation, you can try to
get X working by creating a file /etc/XF86Config and a symlink /etc/X
pointing to an X server in /usr/X11/bin.  To learn how to make the
configuration file, read /usr/X11/lib/X11/doc/README.Config.  You
can test your XF86Config file by running /usr/X11/bin/startx.  Once
you have it working, you can turn on the /usr/athena/etc/dm line in
/etc/ttys to have xlogin automatically come up at boot time.

\end{itemize}
\end{document}

