NetBSD/distrib/notes/sun3/xfer

.\" $NetBSD: xfer,v 1.6 1999/05/19 05:49:06 gwr Exp $	
.
Installation is supported from several media types, including:
.Bl -bullet -compact -offset indent
.It
Tape
.It
NFS
.It
CD-ROM
.It
FTP
.El
.(Note
Installing on a "bare" machine requires some bootable
device; either a tape drive or Sun-compatible NFS server.
.Note)
.Pp
The procedure for transferring the distribution sets onto
installation media depends on the type of media. Instructions
for each type of media are given below.
.Pp
In order to create installation media, you will need all the 
files in the directory
.Dl \&.../NetBSD-\*V/\*[MACHINE]/
.
.Ss2 "Creating boot/install tapes
.
Installing from tape is the simplest method of all.
This method uses two tapes; one called the
.Em boot
tape, and another called the
.Em install No tape.
.Pp
The boot tape is created as follows:
.D1 Ic "cd .../NetBSD-\*V/\*[MACHINE]/installation/tapeimage
.D1 Ic "sh MakeBootTape /dev/nrst0
.Pp
The install tape is created as follows:
.D1 Ic "cd .../NetBSD-\*V/\*[MACHINE]/installation/tapeimage
.D1 Ic "sh MakeInstallTape /dev/nrst0
.Pp
If the tapes do not work as expected, you may need to explicitly
set the EOF mark at the end of each tape segment. It may also be
necessary to use the
.Cm conv=osync
argument to
.Xr dd 1 .
Note that
this argument is incompatible with the
.Cm bs=
argument. Consult
the tape-related manual pages on the system where the tapes are
created for more details.
.
.Ss2 Boot/Install from NFS server:
.
If your machine has a disk and network connection, but no tape drive,
it may be convenient for you to install NetBSD over the network. This
involves temporarily booting your machine over NFS, just long enough
so you can initialize its disk. This method requires that you have
access to an NFS server on your network so you can configure it to
support diskless boot for your machine. Configuring the NFS server
is normally a task for a system administrator, and is not trivial.
.Pp
If you are using a NetBSD system as the boot-server, have a look at
the diskless(8) manual page for guidelines on how to proceed with
this. If the server runs another operating system, consult the
documentation that came with it (i.e. add_client(8) on SunOS).
.Pp
When instructed to boot over the network, your \*[MACHINE] expects to be
able to download a second stage bootstrap program via
.Tn TFTP
after
it has acquired its IP address through
.Tn RARP .
It will attempt to download a file using a name derived from the
machine's recently aquired IP
.if r_sun3 address.
.if r_sun3x address and an extension which corresponds to the
.if r_sun3x machine architecture.
(It may be handy to have a hexadecimal 
calculator for this next step.) The filename
.if r_sun3x prefix
is created by
converting the machine's assigned IP address into hexadecimal,
most-significant octet first, using uppercase characters for the
non-decimal (A-F) digits.
.if r_sun3x \{\
The filename suffix used by all sun3x machines is
.Pa SUN3X .
.\}
.Pp
For example, a \*[MACHINE] which has been assigned IP address 130.115.144.11
will make an
.Tn TFTP
request for
.if r_sun3 .Pa 8273900B .
.if r_sun3x .Pa 8273900B.SUN3X .
Normally, this file
is a symbolic link to the NetBSD/\*[MACHINE]
.Pa netboot
program, which should
be located in a place where the
.Tn TFTP
daemon can find it. (Remember, many
TFTP daemons run in a chroot'ed environment.) The netboot program
may be found in the install directory of this distribution.
.Pp
The netboot program will query a bootparamd server to find the
NFS server address and path name for its root, and then load a
kernel from that location. The server should have a copy of the
netbsd-rd kernel in the root area for your client (no other files
are needed in the client root) and /etc/bootparams on the server
should have an entry for your client and its root directory.
The client will need access to the miniroot image, which can be
provided using NFS or remote shell.
.Pp
If you will be installing NetBSD on several clients, it may be useful
to know that you can use a single NFS root for all the clients as long
as they only use the netbsd-rd kernel. There will be no conflict
between clients because the RAM-disk kernel will not use the NFS root.
No swap file is needed; the RAM-disk kernel does not use that either.
.
.Ss2 Install/Upgrade from CD-ROM
.
This method requires that you boot from another device (i.e. tape
or network, as described above). You may need to make a boot tape
on another machine using the files provided on the CD-ROM. Once
you have booted netbsd-rd (the RAM-disk kernel) and loaded the
miniroot, you can load any of the distribution sets directly from
the CD-ROM. The "install" program in the miniroot automates the
work required to mount the CD-ROM and extract the files.
.
.Ss2 Install/Upgrade via FTP
.
This method requires that you boot from another device (i.e. tape
or network, as described above). You may need to make a boot tape
on another machine using the files in .../install (which you get
via FTP). Once you have booted netbsd-rd (the RAM-disk kernel)
and loaded the miniroot, you can load any of the distribution sets
over the net using FTP. The "install" program in the miniroot
automates the work required to configure the network interface and
transfer the files.
.Pp
The preparations for this installation/upgrade method are easy; all
you make sure that there's some FTP site from which you can retrieve
the NetBSD distribution when you're about to install or upgrade. You
need to know the numeric IP address of that site, and, if it's not on
a network directly connected to the machine on which you're installing
or upgrading NetBSD, you need to know the numeric IP address of the
router closest to the NetBSD machine. Finally, you need to know the
numeric IP address of the NetBSD machine itself.