NetBSD/distrib/notes/common/xfer

.\"	$NetBSD: xfer,v 1.18 2001/05/13 23:25:37 mbw Exp $
.\"
.\" Copyright (c) 1999-2001 The NetBSD Foundation, Inc.
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\" 3. All advertising materials mentioning features or use of this software
.\"    must display the following acknowledgement:
.\"        This product includes software developed by the NetBSD
.\"        Foundation, Inc. and its contributors.
.\" 4. Neither the name of The NetBSD Foundation nor the names of its
.\"    contributors may be used to endorse or promote products derived
.\"    from this software without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
.
.\" ---------- MD instructions on setting up boot media
.
.if r_arm32 \{\
You will need to have an installation kernel and possibly a boot application.
See
.Pa arm32/ Ns Ar platform Ns Pa /prep
for details.
.Pp
.\} \" r_arm32
.
.if r_i386 \{\
If you are not booting off a CD-ROM, you will need to have some floppy
disks to boot off;
either two 1.44 MB floppies or one 1.2 MB floppy.
.Pp
For laptops that have cardbus slots, you should use the
.Pa bootlap1.fs
and
.Pa bootlap2.fs
floppy images.
.Pp
For older machines with little RAM, use
.Pa boot-tiny.fs .
This image is tailored towards old, small-memory systems, and thus does
not contain any PCI or SCSI support. It should work on systems with
4M of RAM. Note that this means 4M available to NetBSD; systems that
are said to have 4M may have 640k of base memory and 3072k of extended
memory, which currently will not work, as this is a total of 3712k.
.Pp
For old machines that may have EISA, SCSI and more RAM, but only
have an 1.2M floppy drive, use
.Pa boot-small.fs .
For all other systems, use
.Pa boot1.fs
and
.Pa boot2.fs
.
.Pp
For the 2-floppy sets (and the CD boot image), utilities to repair
a badly crashed systems are included. The -small and -tiny images
have seperate rescue floppy images because of lack of space.
.Pp
If you are using a
.Ul
system to write the floppy images to
disks, you should use the
.Xr dd
command to copy the file system image(s)
(.fs file) directly to the raw floppy disk.
It is suggested that you read the
.Xr dd 1
manual page or ask your system administrator to determine the correct
set of arguments to use; it will be slightly different from system to
system, and a comprehensive list of the possibilities is beyond the
scope of this document.
.Pp
If you are using
.Tn MS-DOS
to write the floppy image(s) to floppy disk, you should use the
.Ic rawrite
utility, provided in the
.Pa i386/utilities
directory of the
.Nx
distribution.
It will write a file system image (.fs file) to a floppy disk.
A
.Ic rawrite32
is also available that runs under
.Tn MS Windows .
.Pp
.\} \" r_i386
.
.if r_macppc \{\
You should wait to decide where to put the
.Nx
distribution sets until you have figured out how you are going to boot
your system.  Refer back to this section after you have done so.
.Pp
.(Note
Some
.Tn MacOS
.Ic ftp
clients default to downloading files in
.Sq ASCII
mode.  This will render the
.Nx
files useless.  Make sure to set your ftp program to download in
.Sq binary
mode.
.Note)
.Pp
.\} \" r_macppc
.
.if r_news68k \{\
.(Note
.Nx*M
\*V does not support any framebuffers (yet) so
you have to use serial console on installation procedure.
.Note)
.Pp
You will need to have a 1.44 MB floppy disk to boot off.
You must put the boot floppy image onto this disk, which contains
software to install
.Nx
system.
.Pp
If you are using a
.Ul
system (such as
.Tn NEWS-OS
or other
.Nx
machines) to write the floppy images to disks, you should use the
.Xr dd 1
command to copy the file system image(s)
(.fs file(s)) directly to the raw floppy disk.
It is suggested that you read the
.Xr dd 1
manual page or ask your system administrator to determine the correct
set of arguments to use; it will be slightly different from system to
system, and a comprehensive list of the possibilities is beyond the
scope of this document.
.Pp
If you have an i386 machine which runs
.Tn MS-DOS
and use them to write the floppy image(s) to floppy disk,
you can use the
.Ic rawrite
utility, provided in the
.Pa i386/installation/misc
directory of the
.Nx
distribution.
It will write a file system image (.fs file) to a floppy disk. 
A
.Ic rawrite32
is also available that runs under
.Tn MS Windows .
.Pp
Though
.Nx*M
uses the floppy disk to boot for the initial
installation, the
.Nx*M
kernel does not support the
floppy device.
Some other machines or systems are still required to write floppy images
even after
.Nx*M
has been installed.
.Pp
SCSI devices on NWS-12x0 machines are not supported (yet), so they
can only run
.Nx*M
diskless.
No file transfer is needed, and all you have to do is to prepare files on
the server.
More information about diskless setting can be found at
.Lk http://www.netbsd.org/Documentation/network/netboot/
.Pp
The
.Tn NEWS
PROM also supports tape boot and network boot, but
.Nx*M
does not support them currently.
.Pp
After the boot floppy is prepared, just type
.Ic "bo fh"
on the PROM prompt to boot it.
.Pp
.\} \" r_news68k
.
.if r_pmax \{\
First-time installation on a bare machine is not supported, because most
DECstations do not have any suitable load device.
Some versions of the DECstation PROM are buggy and will not boot via
.Tn TFTP
and bootp; other versions are buggy and do not boot via
.Tn MOP .
.Pp
The only DECstation with a floppy-disk drive is the Personal DECstation,
and that device is not supported as a boot device.
.Pp
The recommended installation procedure is to boot an install kernel
via
.Tn TFTP ,
or to use a
.Dq helper
system to write a miniroot diskimage onto a disk, move that
disk to the target installation system, and then boot the miniroot.
.Pp
.\} \" r_pmax
.
.if r_vax \{\
Installing on a
.Sq bare
machine requires some bootable
device; either a tape or floppy drive or a NFS server together
with a machine that can act as a MOP loader, such as another
machine running
.Nx .
.Nx*M
can use both BOOTP/DHCP and
BOOTPARAMS for netboot installations.
.Pp
.\} \" r_vax
.
.if r_x68k \{\
You will have to prepare the `ramdisk-root' installation system.
There are two ways to invoke the
.Nx
installation system;
.Pp
.(bullet -compact -offset indent
Use
.Pa loadbsd.x
utility to boot
.Nx
from
.Tn Human68k
.It
Make a boot floppy which contains the installation system
.bullet)
.Pp
When you chose the first method, you have to put the installation kernel
.Pa netbsd
and the
.Pa loadbsd.x
utility to a disk accessible from Human68k.  These files can be found in
.Pa installation/misc
directory of the
.Nx
distribution.
.Pp
To invoke the installation system, just type
.Pp
.Dl Ic "loadbsd.x netbsd"
.Pp
from the
.Tn Human68k
command line.
.Pp
When you chose the second method, you have to make the boot floppy
from the floppy image
.Pa sysinst.fs .
The image file can be found in
.Pa installation/floppy
directory of the
.Nx
distribution.
.Pp
If you are using a
.Ul
system to write the floppy image to
disks, you should use the
.Pa dd
command to copy the file system images (.fs files) directly to the raw
floppy disks. It is suggested that you read the
.Xr dd 1
manual page or
ask your system administrator to determine the correct set of
arguments to use; it will be slightly different from system to system,
and a comprehensive list of the possibilities is beyond the scope of
this document.
.Pp
If you are using
.Tn Human68k
to write the floppy images to disks, you should use the
.Ic rawrite
utility, provided in the
.Pa installation/misc
directory of the
.Nx
distribution. It will write the file system
images (.fs files) to disks.
.Pp
To use the boot floppy, insert the floppy to your floppy drive 0,
and reboot your computer with OPT.1 key pressed.
.Pp
If you have less than 5MB of memory, you have to use the
`floppy-root' installation system instead of the above
`ramdisk-root' installation system.  `Floppy-root' installation
system is composed of two floppies, `kern' and `inst'.  They are
made from the floppy images
.Pa kern.fs 
and
.Pa inst.fs
respectively, both of which are found in
.Pa installation/floppy
directory of the
.Nx
distribution.  See above how to write the images to floppies.
.Pp
To start the `floppy-root' installation system, insert the `kern' floppy
to your floppy drive 0, and reboot your computer with OPT.1 key pressed.
When you are prompted that `Insert filesystem floppy and press return.',
replace the `kern' floppy with `inst' floppy and press return key.
.Pp
Once booted, the `floppy-root' installation system is identical with
the `ramdisk-root' installation system, except that the former constantly
accesses the floppy disk.  Floppy disks are relatively unreliable
media and cause some warning messages to report access errors, most of
which are corrected and can be ignored.  With the latter installation
system the floppy disk is not used once the system has booted off and can
be removed from the drive.
.Pp
.\} \" r_x68k
.
.ig
XXXX
.\" THIS IS NOT APPLICABLE TO X68K!
Note that if you are installing or upgrading from a writable media,
the media can be write-protected if you wish.
These systems mount a root image from inside the kernel, and will not
need to write to the media.
If you booted from a floppy, the floppy disk may be removed from
the drive after the system has booted.
XXXX
..
.
.\" --------- MI instructions for getting distribution off installation medium
.
Installation is supported from several media types, including:
.Pp
.(bullet -offset indent -compact
.
.if r_amiga \{\
.Tn AmigaDOS
.It
.\} \" r_amiga
.
CD-ROM
.
.if !\n[news68k]:\n[macppc]:\n[pmax]:\n[vax]:\n[x68k] \{\
.It
.Tn MS-DOS No floppy
.\} \" ! \n[news68k]:\n[macppc]:\n[pmax]:\n[vax]:\n[x68k]
.
.It
FTP
.
.if \n[x68k] \{\
.It
Magneto-Optical (M-O) or other removable SCSI disk
.\} \" \n[x68k]
.
.It
Remote NFS partition
.
.if !\n[macppc]:\n[news68k] \{\
.It
Tape
.\} \" ! \n[macppc]:\n[news68k]
.
.if !\n[macppc]:\n[news68k] \{\
.It
Existing
.Nx
partitions, if performing an upgrade
.\} \" ! \n[macppc]:\n[news68k]
.
.bullet)
.Pp
.
The steps necessary to prepare the distribution sets for installation
depend upon which installation medium you choose.
The steps for the various media are outlined below.
.
.(tag MS-DOS\ floppy
.
.if r_amiga \{\
.It Em AmigaDOS partition
To install
.Nx
from an
.Tn AmigaDOS
partition, you need to get the
.Nx
distribution sets you wish to install on your system on to an
.Tn AmigaDOS
partition.
All of the
.Pa set_name.xx
pieces can be placed in a single directory instead of separate ones for each
distribution set.
This will also simplify the installation work later on.
.Pp
Note where you place the files as you will need this later.
.Pp
Once you have done this, you can proceed to the next
step in the installation process, preparing your hard disk.
.\} \" r_amiga
.
.It Em CD-ROM
.if r_amiga \{\
To install
.Nx
from a CD-ROM drive, make sure it is a SCSI CD-ROM on a SCSI bus currently
supported by
.Nx
(refer to the supported hardware list) or an ATAPI cd-rom connected to the
A1200 or A4000 internal IDE connector.
If it is a SCSI CD-ROM on a non-supported SCSI bus like Blizzard-3 SCSI
or Apollo SCSI you must first copy the distribution sets to an
.Tn AmigaDOS
partition as described above.
.Pp
If your SCSI CD-ROM is connected to a supported SCSI host adapter,
or it is an ATAPI cd-rom connected to the A1200/A4000 internal IDE
connector, simply put the CD into the drive before installation.
.Pp
.\} \" r_amiga
Find out where the distribution set files are on the CD-ROM.
.Pp
Proceed to the instruction on installation.
.
.if !\n[news68k]:\n[macppc]:\n[pmax]:\n[vax]:\n[x68k] \{\
.It Em MS-DOS floppy
Count the number of
.Pa set_name. Ns Ar xx
files that make up the
distribution sets you want to install or upgrade.
.ie r_i386 \{\
You will need one fifth that number of 1.2 MB floppies, or one sixth that
number of 1.44 MB floppies.
You should only use one size of floppy for the install or upgrade
procedure; you can't use some 1.2 MB floppies and some 1.44 MB floppies.
.\} \" r_i386
.el \{\
You will need one sixth that number of 1.44 MB floppies.
\} \" ! r_i386
.Pp
Format all of the floppies with
.Tn MS-DOS .
Do
.Em not
make any of them bootable
.Tn MS-DOS
floppies, i.e. don't use
.Li format /s
to format them.
(If the floppies are bootable, then the
.Tn MS-DOS
system files that make them bootable will take up some space, and you
won't be able to fit the distribution set parts on the disks.)
If you're using floppies that are formatted for
.Tn MS-DOS
by their manufacturers, they probably aren't bootable, and you can use
them out of the box.
.Pp
Place all of the
.Pa "set_name." Ns Ar xx
files on the
.Tn MS-DOS
disks.
.Pp
Once you have the files on
.Tn MS-DOS
disks, you can proceed to the next step in the installation or upgrade process.
If you're installing
.Nx
from scratch, go to the section on preparing your hard disk, below.
If you're upgrading an existing installation, go directly to the
section on upgrading.
.\} \" ! \n[news68k]:\n[macppc]:\n[pmax]:\n[vax]:\n[x68k]
.
.It Em FTP
The preparations for this installation/upgrade method are
easy; all you need to do is make sure that there's an 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.
If you don't have access to a functioning nameserver during
installation, the IP address of
.Sy ftp.netbsd.org
is
.Li 204.152.184.75
(as of April, 2001).
.Pp
Once you have this information, you can proceed to the next
step in the installation or upgrade process.
If you're installing
.Nx
from scratch, go to the section on preparing your hard disk, below.
If you're upgrading an existing installation, go directly to
the section on upgrading.
.(Note
This method of installation is recommended only for those already familiar
with using
.Bx
network configuration and management commands.
If you aren't, this documentation should help, but is not intended to
be all-encompassing.
.Note)
.
.if \n[x68k] \{\
.It Em M-O disk
To install
.Nx
from a device such as a removable SCSI disk or a magneto-optical disk,
the media
.Em must
be of the
.Tn IBM
.Em Super-floppy
format.
The
.Tn Human68k
format is not recognized by this release of the
.Nx*M .
If you have a
.Tn MS-DOS
or
.Tn MS Windows
machine with an M-O drive connected, use it.
If you don't, and if you have a program to handle
.Tn IBM
format M-O for
.Tn Human68k ,
copy all the files in the subdirectory
.Pa x68k/binaries
and
.Em "change their names to upper case".
.\} \" \n[x68k]
.
.It Em NFS
Place the
.Nx
distribution sets you wish to install into a
directory on an NFS server, and make that directory mountable
by the machine on which you are installing or upgrading
.Nx .
This will probably require modifying the
.Pa /etc/exports
file on of the NFS server and resetting its mount daemon (mountd).
(Both of these actions will probably require superuser
privileges on the server.)
.Pp
You need to know the numeric IP address of the NFS server,
and, if the server is 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.
.Pp
Once the NFS server is set up properly and you have the
information mentioned above, you can proceed to the next step
in the installation or upgrade process.
If you're installing
.Nx
from scratch, go to the section on preparing your hard disk, below.
If you're upgrading an existing installation, go directly to the
section on upgrading.
.(Note
This method of installation is recommended only for those already
familiar with using
.Bx
network configuration and management commands.
If you aren't, this documentation should help, but is not intended to
be all-encompassing.
.Note)
.
.if !\n[macppc]:\n[news68k]:\n[i386]:\n[i386] \{\
.It Em Tape
To install
.Nx
from a tape, you need to make a tape that
contains the distribution set files, in
.Sq tar
format.
.if \n[pmax]:\n[vax] \{\
.(Note
the tape devices with which
.Nx*M
is believed to work is the
.Tn DEC
TK-50. This is a very slow device.  Installation via disk or network is
recommended if at all possible.
.Note)
.\} \" \n[pmax]:\n[vax]
.Pp
If you're making the tape on a
.Ul
system, the easiest way
to do so is probably something like:
.Pp
.Dl # Ic "tar -cf" Ar "tape_device dist_directories"
.Pp
where
.Ar tape_device
is the name of the tape device that
describes the tape drive you're using; possibly
.Pa /dev/rst0 ,
or something similar, but it will vary from system to system.
(If you can't figure it out, ask your system administrator.)
In the above example,
.Ar dist_directories
are the
distribution sets' directories, for the distribution sets you
wish to place on the tape.
For instance, to put the
.Sy misc, base, No and Sy etc
distributions on tape (in
order to do the absolute minimum installation to a new disk),
you would do the following:
.Pp
.Dl # Ic "cd \&.../NetBSD-\*V"
.Dl # Ic "cd \*M/binary"
.Dl # Ic "tar -cf" Ar tape_device Ic "misc etc kern"
.Pp
.(Note
You still need to fill in
.Ar tape_device No in the example.
.Note)
.Pp
Once you have the files on the tape, you can proceed to the
next step in the installation or upgrade process.
If you're installing
.Nx
from scratch, go to the section on preparing your hard disk, below.
If you're upgrading an existing installation, go directly to the section
on upgrading.
.\} \" ! \n[macppc]:\n[news68k]
.
.if !\n[macppc]:\n[news68k] \{\
.It Em Upgrade
If you are upgrading
.Nx ,
you also have the option of installing
.Nx
by putting the new distribution sets somewhere in your existing
file system, and using them from there.
To do that, you must do the following:
.Pp
Place the distribution sets you wish to upgrade somewhere in
your current file system tree.
.if !r_pmax \{\
Please note that the
.Pa /dev
on the floppy used for upgrades only knows about
.Li wd0 ,
.Li wd1 ,
.Li sd0 ,
.Li sd1 ,
and
.Li sd2 .
If you have more than two IDE drives or more than three SCSI drives, you
should take care not to place the sets on the high-numbered drives.
.\} \" ! r_pmax
.Pp
At a bare minimum, you must upgrade the
.Sy base
and
.Sy kern
binary distributions, and so must put the
.Sy base
and
.Sy kern
sets somewhere in your file system.
If you wish, you can do the other sets, as well, but you should
.Em not
upgrade the
.Sy etc
distribution; it contains contains system configuration files
that you should review and update by hand.
.Pp
Once you have done this, you can proceed to the next step in
the upgrade process, actually upgrading your system.
.\} \" ! \n[macppc]:\n[news68k]
.
.tag)