xref: /netbsd/distrib/notes/common/xfer (revision bf9ec67e)
$NetBSD: xfer,v 1.25 2002/05/23 06:05:41 pooka 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
. To boot .Nx , you will need the bootloader

q Ic boot26 and the kernel you wish to boot on a RISC OS filesystem somewhere. c boot26 can boot gzipped kernels, so there's no need to gunzip it.

p .\} \" r_acorn26 . You will need to create a CD with an install kernel on it or have another machine available to allow net booting. See

a cats/ Ns Ar platform Ns Pa /prep for details.

p .\} \" r_cats . 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.

p For laptops that have cardbus slots, you should use the

a bootlap1.fs and

a bootlap2.fs floppy images.

p For older machines with little RAM, use

a 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.

p For old machines that may have EISA, SCSI and more RAM, but only have an 1.2M floppy drive, use

a boot-small.fs .

p For old IBM PS/2 machines with MCA, use

a boot-ps2.fs .

p For all other systems, use

a boot1.fs and

a boot2.fs .

p 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 separate rescue floppy images because of lack of space.

p If you are using a l 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.

p If you are using .Tn MS-DOS to write the floppy image(s) to floppy disk, you should use the c rawrite utility, provided in the

a i386/utilities directory of the .Nx distribution. It will write a file system image (.fs file) to a floppy disk. A c rawrite32 is also available that runs under .Tn MS Windows .

p .\} \" r_i386 . 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.

p .\} .(Note Some .Tn MacOS c 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)

p .\} \" r_macppc . .(Note .Nx*M \*V does not support any framebuffers (yet) so you have to use serial console on installation procedure. .Note)

p 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.

p If you are using a l 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.

p 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 c rawrite utility, provided in the

a i386/installation/misc directory of the .Nx distribution. It will write a file system image (.fs file) to a floppy disk. A c rawrite32 is also available that runs under .Tn MS Windows .

p 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.

p 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/

p The .Tn NEWS PROM also supports tape boot and network boot, but .Nx*M does not support them currently.

p After the boot floppy is prepared, just type c "bo fh" on the PROM prompt to boot it.

p .\} \" r_news68k . 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 .

p The only DECstation with a floppy-disk drive is the Personal DECstation, and that device is not supported as a boot device.

p 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.

p .\} \" r_pmax . 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.

p .\} \" r_vax . You will have to prepare the `ramdisk-root' installation system. There are two ways to invoke the .Nx installation system;

p .(bullet -compact -offset indent Use

a loadbsd.x utility to boot .Nx from .Tn Human68k t Make a boot floppy which contains the installation system .bullet)

p When you chose the first method, you have to put the installation kernel

a netbsd and the

a loadbsd.x utility to a disk accessible from Human68k. These files can be found in

a installation/misc directory of the .Nx distribution.

p To invoke the installation system, just type

p .Dl Ic "loadbsd.x netbsd"

p from the .Tn Human68k command line.

p When you chose the second method, you have to make the boot floppy from the floppy image

a sysinst.fs . The image file can be found in

a installation/floppy directory of the .Nx distribution.

p If you are using a l system to write the floppy image to disks, you should use the

a 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.

p If you are using .Tn Human68k to write the floppy images to disks, you should use the c rawrite utility, provided in the

a installation/misc directory of the .Nx distribution. It will write the file system images (.fs files) to disks.

p To use the boot floppy, insert the floppy to your floppy drive 0, and reboot your computer with OPT.1 key pressed.

p 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

a kern.fs and

a inst.fs respectively, both of which are found in

a installation/floppy directory of the .Nx distribution. See above how to write the images to floppies.

p 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.

p 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.

p .\} \" r_x68k . 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:

p .(bullet -offset indent -compact . .Tn AmigaDOS t .\} \" r_amiga . CD-ROM . t .Tn MS-DOS No floppy .\} \" ! \n[news68k]:\n[hp300]:\n[macppc]:\n[pmax]:\n[vax]:\n[x68k] . t FTP . t Magneto-Optical (M-O) or other removable SCSI disk .\} \" \n[x68k] . t Remote NFS partition . t Tape .\} \" ! \n[macppc]:\n[news68k] . t Existing .Nx partitions, if performing an upgrade .\} \" ! \n[macppc]:\n[news68k] . .bullet)

p . 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 . t 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

a 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.

p Note where you place the files as you will need this later.

p Once you have done this, you can proceed to the next step in the installation process, preparing your hard disk. .\} \" r_amiga . t Em CD-ROM 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.

p 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.

p .\} \" r_amiga Find out where the distribution set files are on the CD-ROM.

p Proceed to the instruction on installation. . t Em MS-DOS floppy Count the number of

a set_name. Ns Ar xx files that make up the distribution sets you want to install or upgrade. 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 You will need one sixth that number of 1.44 MB floppies. \} \" ! r_i386

p 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.

p Place all of the

a "set_name." Ns Ar xx files on the .Tn MS-DOS disks.

p 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[hp300]:\n[macppc]:\n[pmax]:\n[sgimips]:\n[vax]:\n[x68k] . t 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).

p 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 x network configuration and management commands. If you aren't, this documentation should help, but is not intended to be all-encompassing. .Note) . t 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

a x68k/binaries and .Em "change their names to upper case". .\} \" \n[x68k] . t 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

a /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.)

p 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.

p 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 x network configuration and management commands. If you aren't, this documentation should help, but is not intended to be all-encompassing. .Note) . t Em Tape To install .Nx from a tape, you need to make a tape that contains the distribution set files, in .Sq tar format. .(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]

p If you're making the tape on a l system, the easiest way to do so is probably something like:

p .Dl # Ic "tar -cf" Ar "tape_device dist_directories"

p where .Ar tape_device is the name of the tape device that describes the tape drive you're using; possibly

a /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:

p .Dl # Ic "cd .../NetBSD-\*V" .Dl # Ic "cd \*M/binary" .Dl # Ic "tar -cf" Ar tape_device Ic "misc etc kern"

p .(Note You still need to fill in .Ar tape_device No in the example. .Note)

p 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]:\n[sgimips] . t 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:

p Place the distribution sets you wish to upgrade somewhere in your current file system tree. Please note that the

a /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. .\} \" ! \n[hp300]:\n[pmax]:\n[sgimips]:\n[sparc]

p 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.

p Once you have done this, you can proceed to the next step in the upgrade process, actually upgrading your system. .\} \" ! \n[macppc]:\n[news68k] .