install revision 1.7
1 $NetBSD: install,v 1.7 1998/06/17 11:55:39 leo Exp $ 2 3Installing NetBSD is a relatively complex process, but, if you have 4this document in hand and are careful to read and remember the 5information which is presented to you by the install program, it 6shouldn't be too much trouble. 7 8Before you begin, you must have already prepared your hard disk as 9detailed in the section on preparing your system for install. 10 11The following is a walk-through of the steps necessary to get NetBSD 12installed on your hard disk. If you wish to stop the installation, 13you may hit Control-C at any prompt, but if you do, you'll have to 14begin again from scratch. 15 16 1. Booting the miniroot 17 ======================= 18 First you need to get yourself into NetBSD. This can be 19 done in a couple ways, both of which currently require 20 GEMDOS. You need either the bootfloppy provided in the 21 distribution or you can copy the loadbsd.ttp program and 22 kernel to a boot floppy disk (1.4M needed) or put them on a TOS 23 partition. Select the loadbsd program and it will 24 ask for parameters, supply: '-b netbsd' (or whatever name 25 you copied the kernel to). You can, of course, also run it 26 from the shell command-line in MiNT: 27 28 loadbsd -b a:/netbsd 29 30 You should see the screen clear and some information about 31 your system as the kernel configures the hardware. Then 32 you will be prompted for a root device. At this time remove 33 the GEMDOS kernel boot floppy from the drive if present and 34 insert the BSD install floppy 1. Now type `md0a' to tell the 35 kernel to load the install filesystem into RAMdisk. While 36 While the kernel is loading, it will show a '.' for each 37 track loaded. After loading 80 tracks, it will ask you 38 to insert the next floppy. At this time, inser the BSD 39 install floppy 2 and hit any key. The kernel continous 40 loading another 40 tracks before it continues to boot. 41 42 Note: If you are using 1.44Mb floppies, you should select 'md1a' 43 instead of 'md0a'. 44 45 The system should continue to boot. For now ignore WARNING: 46 messages about bad dates in clocks. Eventually you will be 47 be asked to enter the pathname of the shell, just hit 48 return. After a short while, you will be asked to select 49 the type of your keyboard. After you have entered a valid 50 response here, the system asks you if you want to install 51 or upgrade your system. Since you are reading the 'install' 52 section, 'i' would be the proper response here... 53 54 2. Entering the installer 55 ========================= 56 The installer starts with a nice welcome messages. Read this 57 message carefully, it also informs you of the risks involved 58 in continuing! If you still want to go on, type 'y'. The 59 installer now continues by trying to figure out your disk 60 configuration. When it is done, you will be prompted to select 61 a root device from the list of disks it has found. 62 63 3. Select your root device 64 ========================== 65 You should know at this point that the disks are NOT numbered 66 according to their scsi-id! The NetBSD kernel numbers the scsi 67 drives (and other devices on the scsi bus) sequentially as it 68 finds them. The drive with the lowest scsi id will be called sd0, 69 the next one sd1, etc. 70 Where you end up after the selection of the root disk depends on 71 the contents of your disk. If it is already partitioned using 72 AHDI, start reading at item 4a, if this disk has no AHDI partitioning 73 but is blank or used by another non-AHDI system, start at item 4b. 74 75 YOU ARE NOW AT THE POINT OF NO RETURN! The programs in section 76 4 will modify your harddisk. Type Control-C NOW if you don't 77 want this. 78 79 4a. Setting AHDI partition id's on your root disk (using edahdi) 80 ================================================================ 81 Because NetBSD imposes a special ordering in disk partitions it 82 uses for root & swap. And because it wants to guard you against 83 an unwanted demolition of partitions used by other systems, you 84 have to tell it what partitions it is allowed to use. You have 85 to mark the partition you want to use as swap 'NBS' or 'SWP' 86 and the other partitions as 'NBD'. Note that all the changes 87 you make to the id's are reversable as long as you remember the 88 original value. 89 In the partition-id editor, the partitions are shown in the order 90 that AHDI created them. When you leave this editor and continue 91 at item 4b, your changes to the id's do have consequences to the 92 partition order! They will show up as follows: 93 a -- the first NBD partition 94 b -- the first NBS partition 95 d (and up) -- the rest of the partitions in AHDI order 96 97 4b. Labeling your root disk (using edlabel) 98 =========================================== 99 You are now allowed to change the partitioning of your disk. If 100 your disk is already partitioned with AHDI DON'T change anything 101 unless you are absolutely sure what you are doing! 102 If you are labeling an empty SCSI disk, you can make life easy for 103 yourself by selecting 'standarize geometry'. This allows you to 104 select a 'sectors per track' and 'tracks/cylinder' value and have 105 the (fictious) SCSI geometry changed accordingly. So if you select 106 64 sect/track and 32 tracks/cylinder, each cilinder is exactly 107 1Mb in size. Well, go ahead and don't forget to save your work 108 before quitting! 109 NOTE: to make sure that NetBSD can create/mount filesystems on 110 the partitions you defined, make sure the 'type' is entered 111 correctly: 112 4.2BSD - filesystems created by NetBSD 113 MSDOS - filesystems shared with GEM 114 115 Just ignore it, it's harmless. 116 117 5. Label additional disks 118 ========================= 119 Now that your root-disk is labeled, you are given the opportunity 120 to label any of the other disks in your system. The procedure is 121 the same as with your root disk. 122 123 6. Setup the fstab 124 ================== 125 Since all disks you want to use with NetBSD are properly labeled, 126 it is time to tell the installer which partition will be associated 127 with the different filesystems. As mentioned above, it is wise to 128 make at least a separate root and /usr filesystem. Depending on 129 what you are planning to do with your system, you might also consider 130 to make a separate /var, /local or /home. 131 When you tell the installer that all of your filesystems are specified 132 correctly, it starts creating them for you. 133 134 7. Configure your network 135 ========================= 136 Currently none of the kernels supplied in the distribution has 137 network support builtin. If you compiled your own kernel, network 138 configuration mostly works. [ Due to space limitiations, some 139 of the network commands are not present on the install floppy ] 140 141 8. Edit the fstab - again.... 142 ============================= 143 Since the network configuration might have lead to additional (nfs) 144 filesystem entries, you get another chance to modify your fstab. 145 146 9. Installing the distribution sets 147 =================================== 148 You are finally at the point where some real data will be put on 149 your freshly-made filesystems. Select the device type you whish 150 to install from and off you go.... 151 Some notes: 152 - If you want to install from tape, please read the section 153 about how to create such a tape. 154 The tape device name will be "nrst0" for the first tape 155 drive, "nrst1" for the second, etc. 156 - Install at least the base and etc sets. 157 - If you have to specify a path relative to the mount-point and 158 you need the mount-point itself, enter '.'. 159 - For previous NetBSD users: If you want to install from a 160 GEMDOS filesystem, you don't need to rename the distribution 161 sets as you may have done in previous versions of NetBSD. 162 163 10. Timezone selection and device-node building 164 =============================================== 165 The isn't much to say about this. Just select the timezone you 166 are in. The installer will make the correct setup on your root 167 filesystem. After the timezone-link is installed, the installer 168 will proceed by creating the device nodes on your root filesystem. 169 Be patient, this will take a while... 170 171 11. Installing the kernel 172 ========================= 173 Because the kernel didn't fit on the install-disks, the installer 174 asks you about the disk your kernel is on. You can specify the 175 floppy with disk 'fd0' and partition 'b' for 720K disks and 176 partition 'c' for 1.4M disks, or one of the hard disk partitions. 177 178 12. Installing the bootstrap 179 ============================ 180 Finally, the installer ask you if you want to install the bootblock 181 code on your root disk. This is a matter of personal choise and can 182 also be done from a running NetBSD system. See the 'installboot(8)' 183 manual page about how to do this. 184 185 13. You did it! 186 =============== 187 Congratulations, you just installed NetBSD successfully! If you 188 also installed a bootblock, you only have to reboot your atari to 189 enter your freshly build system. If you didn't, get back to section 190 1 (How to boot the miniroot). Just substitute 'md0a' by your NetBSD 191 root disk. 192 193 194Some extra remarks: 195=================== 196 197If you don't want to use the bootloader. You could use the following 198setup: 199 Reserve a small GEMDOS partition of about 4Mb. This is 200 enough to put in a few kernels. Put the netbsd kernel 201 into this partition. Also, edit your /etc/fstab to always 202 mount this partition, say as /kernels. Now make a symlink 203 from /netbsd to /kernels/netbsd. 204 This sceme is particulary handy when you want to make your 205 own kernel. When compilation is finished, you just copy 206 your kernel to /kernels/netbsd and reboot. It's wise to 207 make sure there is _always_ a 'known to work' kernel image 208 present. 209