install revision 1.5
1Installing NetBSD is a relatively complex process, but, if you have 2this document in hand and are careful to read and remember the 3information which is presented to you by the install program, it 4shouldn't be too much trouble. 5 6Before you begin, you must have already prepared your hard disk as 7detailed in the section on preparing your system for install. 8 9The following is a walk-through of the steps necessary to get NetBSD 10installed on your hard disk. If you wish to stop the installation, 11you may hit Control-C at any prompt, but if you do, you'll have to 12begin again from scratch. 13 14 Transfer the install miniroot filesystem onto the hard disk 15 partition used by NetBSD for swapping, as described in the 16 "Preparing your System for NetBSD Installation" section above. 17 18 You then need to have "ixemul.library" in your LIBS: directory 19 on AmigaDOS. You also need to have the "loadbsd" program 20 in your command path. If AmigaDOS complains about loadbsd 21 not being an executable file, be sure that the "Execute" 22 protection bit is set. If not, set it with the command: 23 Protect loadbsd add e 24 25 Next you need to get yourself into NetBSD by loading the 26 kernel from AmigaDOS with loadbsd like so: 27 28 loadbsd -b netbsd 29 30 If you have an AGA machine, and your monitor will handle 31 the dblNTSC mode, you may also include the "-A" option to 32 enable the dblNTSC display mode. 33 34 You should see the screen clear and some information about 35 your system as the kernel configures the hardware. Note which 36 hard disk device(s) are configured (sd0, sd1, etc). Then 37 you will be prompted for a root device. At this time type 38 'sd0*', where '0' is the device which contains the swap 39 partition you created during the hard disk preparation. 40 41 The system should continue to boot. For now ignore WARNING: 42 messages about bad dates in clocks. Eventually you will be 43 asked to enter the pathname of the shell, just hit return. 44 After a short while you should see a welcome message and a 45 prompt, asking if you wish to proceed with the installation. 46 47 If you wish to proceed, enter "y" and then return. 48 49 If you have configured your hard drive[s] correctly it 50 should find the drive and partition that you selected to 51 use as your root. You will be prompted for which device 52 you want to use for your root. If you have multiple disks 53 present with root partitions defined, you will need to be 54 sure you enter the device name of the correct partition you 55 want to install NetBSD on. 56 57 YOU ARE NOW AT THE POINT OF NO RETURN. If you confirm that 58 you want to install NetBSD, your hard drive will be modified, 59 and perhaps its contents scrambled at the whim of the install 60 program. 61 62 If you are sure you want to proceed, enter "yes" at the 63 prompt. 64 65 The install program will now make the root filesystem you 66 specified. There should be only one error in this section 67 of the installation. It will look like so: 68 69 newfs: ioctl (WDINFO): Invalid argument 70 newfs: /dev/rsd0a: can't rewrite disk label 71 72 If there are any others, restart from the the beginning of 73 the installation process. This error is ok as the Amiga 74 does not write disklabels currently. You should expect 75 this error whenever using newfs. 76 77 Next the install program will ask you which drive and 78 partition you wish to use as /usr. First it will list the 79 available drives. Choose one. Next it will give you a 80 list of the partitions on that disk along with their sizes, 81 types, etc.. Choose the letter that corresponds to the 82 partition you wish to use for /usr. If you are doing a 83 full install this should be at the very least 45M-50M large. 84 If everything is ok the install program will then format 85 and mount your /usr. If not then it will ask again for a 86 drive and partition. 87 88 When this completes your root partition will be mounted on 89 /mnt and your /usr partition on /mnt/usr. An fstab will 90 have been created and initialized to correctly mount these 91 two file systems. This fstab will be in /mnt/etc. 92 93 What you do from this point on depends on which media you're 94 using to install NetBSD. Follow the appropriate instructions, 95 given below. 96 97 To install from an AmigaDOS partition: 98 99 You first need to mount the AmigaDOS partition 100 using the mount_ados command. If e.g. your AmigaDOS 101 partition is the first partition on sd0 you could 102 type: 103 104 mkdir /mnt/ados 105 mount_ados -o ro /dev/sd0d /mnt/ados 106 107 You can use `disklabel sd0' to find out what types 108 of partitions are on the disk `sd0'. 109 110 Next goto the directory in which you stored the 111 distribution sets. If e.g. you stored them in the 112 root directory of the partition: 113 114 cd /mnt/ados 115 116 When there, run "Set_tmp_dir" and choose the default 117 temporary directory, by hitting return at the 118 prompt. 119 120 Run the "Extract" command, giving it as its sole 121 argument the name of the distribution set you wish 122 to extract. For example, to extract the base 123 distribution, use the command: 124 125 Extract base11 126 127 and to extract the games distribution: 128 129 Extract game11 130 131 If the distribution sets are in different directories, 132 you will need to cd to each directory in turn, runing 133 "Set_tmp_dir" and the appropriate "Extract" command(s). 134 135 Continue this process until you've finished installing 136 all of the sets which you desire to have on your 137 hard disk. Once you have extracted all sets and 138 are at the "#" prompt again, proceed to the section 139 "Configuring Your System," below. 140 141 To install from tape: 142 143 The first thing you should do is pick a temporary 144 directory where the distribution files can be stored. 145 To do this, use the command "Set_tmp_dir" and enter 146 your choice. The default is /mnt/usr/distrib. 147 148 After you have picked a temporary directory, 149 you should issue the load command: 150 151 Load_tape 152 153 Next, you will be told to insert the media into 154 the appropriate drive, and hit return. Continue 155 to follow instructions until you are returned to 156 the "#" prompt. 157 158 Go to the directory which contains the first 159 distribution set you wish to install. This is 160 either the directory you specified above, or possibly 161 a subdirectory of that directory. 162 163 When there, run "Set_tmp_dir" again, and choose 164 the default temporary directory, by hitting 165 return at the prompt. 166 167 Run the "Extract" command, giving it as its sole 168 argument the name of the distribution set you 169 wish to extract. For example, to extract the base 170 distribution, use the command: 171 172 Extract base11 173 174 and to extract the games distribution: 175 176 Extract game11 177 178 After the extraction is complete, go to the location 179 of the next set you want to extract, "Set_tmp_dir" 180 again, and once again issue the appropriate 181 extract command. Continue this process until 182 you've finished installing all of the sets which you 183 desire to have on your hard disk. 184 185 After each set is finished, if you know that you 186 are running low on space you can remove the 187 distribution files for that set by saying: 188 189 rm set_name.?? 190 191 For example, if you wish to remove the distribution 192 files for the game09 set, after the "Extract game09" 193 command has completed, issue the command: 194 195 rm game11.?? 196 197 Once you have extracted all sets and are at the "#" prompt 198 again, proceed to the section "Configuring Your System," 199 below. 200 201 To install via FTP or NFS: 202 203 First, use Set_tmp_dir to pick a temporary directory 204 for the installation files. /mnt/usr/distrib is 205 suggested. 206 207 Configure the appropriate ethernet interface i.e. le0 208 if you have a 2065 or ed0 if you have a AMIGNET from 209 Hydra Systems. 210 211 ifconfig <ifname> <ipaddr> [netmask <netmask>] 212 213 where <ifname> is the interface name (e.g. ed0, etc.), 214 and <ipaddr> is the numeric IP address of the interface. 215 If the interface has a special netmask, supply 216 the word "netmask" and that netmask at the end of the 217 command line. For instance, without a special netmask: 218 219 ifconfig ed0 129.133.10.10 220 221 or with a special netmask 222 223 ifconfig ed0 128.32.240.167 netmask 0xffffff00 224 225 You should also be able to use SLIP or PPP as the network 226 connection. 227 [XXX instructions for ppp or slip would be usefull 228 perhaps the next release] 229 230 If the NFS server or FTP server is not on a directly- 231 connected network, you should set up a route to it 232 with the command: 233 234 route add default <gate_ipaddr> 235 236 where <gate_ipaddr> is your gateway's numeric IP address. 237 238 If you are NFS-mounting the distribution sets, 239 mount them on the temporary directory with the command: 240 241 mount -t nfs <serv_ipaddr>:<dist_dir> <tmp_dir> 242 243 where <serv_ipaddr> is the server's numeric IP address, 244 <dist_dir> is the path to the distribution files on 245 the server, and <tmp_dir> is the name of the local 246 temporary directory. 247 248 Once this is done, proceed as if you had loaded the 249 files from tape, "cd"ing to the appropriate directories 250 and running "Set_tmp_dir" and "Extract" as appropriate. 251 252 If you are retrieving the distribution sets using ftp, 253 cd into the temp directory, and execute the command: 254 255 ftp <serv_ipaddr> 256 257 where <serv_ipaddr> is once again the server's 258 numeric IP address. Get the files with FTP, 259 taking care to use binary mode to transfer 260 all files. 261 262 Once you have all of the files for the distribution sets 263 you wish to install, you can proceed using the instructions 264 above as if you had installed the files from a tape. 265 266 267Configuring Your System: 268----------- ---- ------ 269 270Once you have finished extracting all of the distribution sets that 271you want on your hard drive and are back at the "#" prompt, 272you are ready to configure your system. 273 274The configuration utility expects that you have installed the base 275system. If you have not, you will not be able to run it successfully 276(nor will you have a functional system regardless of configuration). 277 278To configure the newly installed operating system, run the 279command "Configure". 280 281Configure will ask for the machine's hostname, domain name, and other 282network configuration information. 283 284Once you have supplied `Configure' all that it requests, your machine 285will be configured well enough that when you reboot it it will 286almost be a completely functional NetBSD system. 287 288>>> Copy the kernel from the miniroot filesystem at this point <<< 289 290Once you are done with `Configure', halt the system with the "halt" 291command (wait for "halted" to be displayed) and reboot. Then again 292boot NetBSD this time with the command: 293 294 295 loadbsd netbsd 296 297You need to do your final tweeks now. First mount your file systems 298like so: 299 300 mount -av 301 302Your system is now complete but not completely configured; you 303should adjust the /etc/sendmail.cf file as necessary to suit your 304site and/or disable sendmail and other network related programs. 305These things can be found in /etc/netstart. Use vi, if you installed 306the man pages you can type `man vi' or `man ed' for instructions 307on how to use these somewhat non-intuitive editors. 308 309You should also put a copy of the netbsd kernel in your root partition. 310This can be done easily by mounting the AmigaDOS partition containing 311the kernel you used to start NetBSD and copying the "netbsd" file to 312the root: 313 mount -r -t ados /dev/sd0d /mnt 314 cp /mnt/netbsd / 315(where /dev/sd0d is the AmigaDOS partition where you have netbsd, and 316/mnt/netbsd is the appropriate path of the netbsd file). 317 318Once you are done with the rest of configuration unmount your file 319systems and halt your system, then reboot: 320 321 cd / 322 umount -av 323 halt 324 <reboot> 325 326Finally you can now boot your system and it will be completely 327functional: 328 329 loadbsd -a netbsd 330 331When it boots off of the hard drive, you will have a complete 332NetBSD system! CONGRATULATIONS! (You really deserve them!!!) 333