NetBSD/distrib/notes/sun3/xfer

.\"	$NetBSD: xfer,v 1.11 2002/07/22 13:59:24 lukem Exp $
.
Installation is supported from several media types, including:
.(bullet -compact -offset indent
Tape
.It
NFS
.It
CD-ROM
.It
FTP
.bullet)
.(Note
Installing on a
.Sq bare
machine requires some bootable device; either a tape drive or
.Tn Sun Ns No -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
.Pp
.Dl Pa \&.../NetBSD-\*V/\*M/
.
.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:
.Pp
.Dl # Ic "cd .../NetBSD-\*V/\*M/installation/tapeimage"
.Dl # Ic "sh MakeBootTape /dev/nrst0"
.Pp
The install tape is created as follows:
.Pp
.Dl # Ic "cd .../NetBSD-\*V/\*M/installation/tapeimage"
.Dl # 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
.Nx
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
.Nx
system as the boot-server, have a look at
the
.Xr 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.
.Xr add_client 8
on
.Tn SunOS ) .
.Pp
When instructed to boot over the network, your \*M 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 acquired IP address,
and in the case of sun3x machines, an extension which corresponds to the
machine architecture.
(It may be handy to have a hexadecimal
calculator for this next step.)
The filename 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.
sun3x machines use a filename suffix of
.Pa .SUN3X .
.Pp
For example, a sun3 which has been assigned IP address 130.115.144.11
will make an
.Tn TFTP
request for
.Pa 8273900B ,
and a sun3x will try
.Pa 8273900B.SUN3X .
Normally, this file
is a symbolic link to the
.Nx*M
.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
.Pa /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
.Nx
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
.Ic 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
.Pa .../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
.Ic 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
.Nx
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
.Nx ,
you need to know the numeric IP address of the
router closest to the
.Nx
machine.
Finally, you need to know the numeric IP address of the
.Nx
machine itself.