distrib/notes/sun2/xfer

   1 .\"     $NetBSD: xfer,v 1.3 2002/06/30 12:57:29 lukem Exp $
   2 .
   3 Installation is supported from several media types, including:
   4 .(bullet -compact -offset indent
   5 Tape
   6 .It
   7 NFS
   8 .It
   9 CD-ROM
  10 .It
  11 FTP
  12 .bullet)
  13 .(Note
  14 Installing on a
  15 .Sq bare
  16 machine requires some bootable device; either a tape drive or
  17 .Tn Sun Ns No -compatible
  18 NFS server.
  19 .Note)
  20 .Pp
  21 The procedure for transferring the distribution sets onto
  22 installation media depends on the type of media.
  23 Instructions for each type of media are given below.
  24 .Pp
  25 In order to create installation media, you will need all the
  26 files in the directory
  27 .Pp
  28 .Dl Pa \&.../NetBSD-\*V/\*M/
  29 .
  30 .Ss2 Creating boot/install tapes
  31 .
  32 Installing from tape is the simplest method of all.
  33 This method uses two tapes; one called the
  34 .Em boot
  35 tape, and another called the
  36 .Em install No tape.
  37 .Pp
  38 The boot tape is created as follows:
  39 .Pp
  40 .Dl # Ic "cd .../NetBSD-\*V/\*M/installation/tapeimage"
  41 .Dl # Ic "sh MakeBootTape /dev/nrst0"
  42 .Pp
  43 The install tape is created as follows:
  44 .Pp
  45 .Dl # Ic "cd .../NetBSD-\*V/\*M/installation/tapeimage"
  46 .Dl # Ic "sh MakeInstallTape /dev/nrst0"
  47 .Pp
  48 If the tapes do not work as expected, you may need to explicitly
  49 set the EOF mark at the end of each tape segment.
  50 It may also be necessary to use the
  51 .Cm conv=osync
  52 argument to
  53 .Xr dd 1 .
  54 Note that
  55 this argument is incompatible with the
  56 .Cm bs=
  57 argument.
  58 Consult the tape-related manual pages on the system where the tapes are
  59 created for more details.
  60 .
  61 .Ss2 Boot/Install from NFS server
  62 .
  63 If your machine has a disk and network connection, but no tape drive,
  64 it may be convenient for you to install
  65 .Nx
  66 over the network.
  67 This involves temporarily booting your machine over NFS, just long enough
  68 so you can initialize its disk.
  69 This method requires that you have access to an NFS server on your network
  70 so you can configure it to support diskless boot for your machine.
  71 Configuring the NFS server
  72 is normally a task for a system administrator, and is not trivial.
  73 .Pp
  74 If you are using a
  75 .Nx
  76 system as the boot-server, have a look at
  77 the
  78 .Xr diskless 8
  79 manual page for guidelines on how to proceed with this.
  80 If the server runs another operating system, consult the
  81 documentation that came with it (i.e.
  82 .Xr add_client 8
  83 on
  84 .Tn SunOS ) .
  85 .Pp
  86 When instructed to boot over the network, your \*M expects to be
  87 able to download first and second stage bootstrap programs via
  88 .Tn ND ,
  89 the Network Disk protocol.
  90 The
  91 .Xr ndbootd 8
  92 program will attempt to serve a second-stage bootstrap file using
  93 a name derived from the machine's recently acquired IP
  94 address and an extension which corresponds to the
  95 machine architecture.
  96 (It may be handy to have a hexadecimal
  97 calculator for this next step.)
  98 The filename prefix is created by converting the machine's assigned
  99 IP address into hexadecimal, most-significant octet first,
 100 using uppercase characters for the non-decimal (A-F) digits.
 101 The filename suffix used by all sun2 machines is
 102 .Pa SUN2 .
 103 .Pp
 104 For example, a \*M which has been assigned IP address 130.115.144.11
 105 will be served a second-stage bootstrap file named
 106 .Pa 8273900B.SUN2 .
 107 Normally, this file
 108 is a symbolic link to the
 109 .Nx*M
 110 .Pa netboot
 111 program, which should
 112 be located in a place where the
 113 .Xr ndbootd 8
 114 daemon can find it.
 115 The
 116 .Pa netboot
 117 program may be found in the
 118 .Pa installation/netboot
 119 directory of this distribution.
 120 .Pp
 121 The netboot program will query a bootparamd server to find the
 122 NFS server address and path name for its root, and then load a
 123 kernel from that location.
 124 The server should have a copy of the
 125 .Pa netbsd-RAMDISK
 126 kernel in the root area for your client, hard-linked
 127 under the names
 128 .Pa netbsd
 129 and
 130 .Pa vmunix
 131 (no other files are needed in the client root) and
 132 .Pa /etc/bootparams
 133 on the server
 134 should have an entry for your client and its root directory.
 135 The client will need access to the miniroot image, which can be
 136 provided using NFS or remote shell.
 137 .Pp
 138 If you will be installing
 139 .Nx
 140 on several clients, it may be useful
 141 to know that you can use a single NFS root for all the clients as long
 142 as they only use the
 143 .Pa netbsd-RAMDISK
 144 kernel.
 145 There will be no conflict
 146 between clients because the RAM-disk kernel will not use the NFS root.
 147 No swap file is needed; the RAM-disk kernel does not use that either.
 148 .
 149 .Ss2 Install/Upgrade from CD-ROM
 150 .
 151 This method requires that you boot from another device (i.e. tape
 152 or network, as described above). You may need to make a boot tape
 153 on another machine using the files provided on the CD-ROM. Once
 154 you have booted netbsd-rd (the RAM-disk kernel) and loaded the
 155 miniroot, you can load any of the distribution sets directly from the CD-ROM.
 156 The
 157 .Ic install
 158 program in the miniroot automates the
 159 work required to mount the CD-ROM and extract the files.
 160 .
 161 .Ss2 Install/Upgrade via FTP
 162 .
 163 This method requires that you boot from another device (i.e. tape
 164 or network, as described above). You may need to make a boot tape
 165 on another machine using the files in
 166 .Pa installation/tapeimage
 167 and
 168 .Pa binary/kernel
 169 (which you get via FTP).
 170 Once you have booted
 171 .Pa netbsd-RAMDISK
 172 (the RAM-disk kernel)
 173 and loaded the miniroot, you can load any of the distribution sets
 174 over the net using FTP.
 175 The
 176 .Ic install
 177 program in the miniroot
 178 automates the work required to configure the network interface and
 179 transfer the files.
 180 .Pp
 181 The preparations for this installation/upgrade method are easy; all
 182 you make sure that there's some FTP site from which you can retrieve
 183 the
 184 .Nx
 185 distribution when you're about to install or upgrade.
 186 You need to know the numeric IP address of that site, and, if it's not on
 187 a network directly connected to the machine on which you're installing
 188 or upgrading
 189 .Nx ,
 190 you need to know the numeric IP address of the
 191 router closest to the
 192 .Nx
 193 machine.
 194 Finally, you need to know the numeric IP address of the
 195 .Nx
 196 machine itself.