.\" $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.