install revision 1.6 1 $NetBSD: install,v 1.6 1998/01/14 06:50:27 scottr Exp $
2
3 Installing NetBSD is a relatively complex process, but, if you have
4 this document in hand and are careful to read and remember the
5 information which is presented to you by the install program, it
6 shouldn't be too much trouble.
7
8 Before you begin, you must have already prepared your hard disk as
9 detailed in the section on preparing your system for install.
10
11 The following is a walk-through of the steps necessary to get NetBSD
12 installed on your hard disk. If you wish to stop the installation,
13 you may hit Control-C at any prompt, but if you do, you'll have to
14 begin 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 Don't do this right now. As non of the network cards are supported,
137 it doesn't make any sense.
138
139 8. Edit the fstab - again....
140 =============================
141 Since the network configuration might have lead to additional (nfs)
142 filesystem entries, you get another chance to modify your fstab.
143
144 9. Installing the distribution sets
145 ===================================
146 You are finally at the point where some real data will be put on
147 your freshly-made filesystems. Select the device type you whish
148 to install from and off you go....
149 Some notes:
150 - If you want to install from tape, please read the section
151 about how to create such a tape.
152 The tape device name will be "nrst0" for the first tape
153 drive, "nrst1" for the second, etc.
154 - Install at least the base and etc sets.
155 - If you have to specify a path relative to the mount-point and
156 you need the mount-point itself, enter '.'.
157 - For previous NetBSD users: If you want to install from a
158 GEMDOS filesystem, you don't need to rename the distribution
159 sets as you may have done in previous versions of NetBSD.
160
161 10. Timezone selection and device-node building
162 ===============================================
163 The isn't much to say about this. Just select the timezone you
164 are in. The installer will make the correct setup on your root
165 filesystem. After the timezone-link is installed, the installer
166 will proceed by creating the device nodes on your root filesystem.
167 Be patient, this will take a while...
168
169 11. Installing the kernel
170 =========================
171 Because the kernel didn't fit on the install-disks, the installer
172 asks you about the disk your kernel is on. You can specify the
173 floppy with disk 'fd0' and partition 'b' for 720K disks and
174 partition 'c' for 1.4M disks, or one of the hard disk partitions.
175
176 12. Installing the bootstrap
177 ============================
178 Finally, the installer ask you if you want to install the bootblock
179 code on your root disk. This is a matter of personal choise and can
180 also be done from a running NetBSD system. See the 'installboot(8)'
181 manual page about how to do this.
182
183 13. You did it!
184 ===============
185 Congratulations, you just installed NetBSD successfully! If you
186 also installed a bootblock, you only have to reboot your atari to
187 enter your freshly build system. If you didn't, get back to section
188 1 (How to boot the miniroot). Just substitute 'md0a' by your NetBSD
189 root disk.
190
191
192 Some extra remarks:
193 ===================
194
195 If you don't want to use the bootloader. You could use the following
196 setup:
197 Reserve a small GEMDOS partition of about 4Mb. This is
198 enough to put in a few kernels. Put the netbsd kernel
199 into this partition. Also, edit your /etc/fstab to always
200 mount this partition, say as /kernels. Now make a symlink
201 from /netbsd to /kernels/netbsd.
202 This sceme is particulary handy when you want to make your
203 own kernel. When compilation is finished, you just copy
204 your kernel to /kernels/netbsd and reboot. It's wise to
205 make sure there is _always_ a 'known to work' kernel image
206 present.
207