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