| blob | 0344c521759fbd41b1d801f3c11002664927f517 |
1 .\" $NetBSD: install,v 1.29 2008/04/30 13:10:48 martin Exp $
2 .\"
3 .\" Copyright (c) 1999, 2000 The NetBSD Foundation, Inc.
4 .\" All rights reserved.
5 .\"
6 .\" Redistribution and use in source and binary forms, with or without
7 .\" modification, are permitted provided that the following conditions
8 .\" are met:
9 .\" 1. Redistributions of source code must retain the above copyright
10 .\" notice, this list of conditions and the following disclaimer.
11 .\" 2. Redistributions in binary form must reproduce the above copyright
12 .\" notice, this list of conditions and the following disclaimer in the
13 .\" documentation and/or other materials provided with the distribution.
14 .\"
15 .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
16 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
17 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
18 .\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
19 .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
20 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
21 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
22 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
23 .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
24 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
25 .\" POSSIBILITY OF SUCH DAMAGE.
26 .\"
27 .
28 .so ../common/sysinst --------------------------------------------
29 .br_ne 7P
30 .
31 .Ss "Installing the NetBSD System (Traditional Method)"
32 The Traditional method of
33 installation can be broken down into three basic steps:
34 .Pp
35 .(bullet -compact
36 Run Mkfs to build a file system or file systems.
37 .It
38 Run the Installer to load the files onto your file systems.
39 .It
40 Run the Booter to boot the system.
41 .bullet)
42 .
43 .Ss2 Preparing the file system(s)
44 .
45 Double-click on the Mkfs application icon to start it up. It will ask you
46 for the SCSI-ID (SCSI target number) of the drive that you are installing
47 .Nx
48 on. Once this is
49 selected, it will present a list of the partitions on that disk. You must
50 first convert the partitions to a type which
51 .Nx
52 can understand. Select
53 each partition on which you wish to build a file system and click on the
54 .Ic Change
55 button. If you are placing the entire installation on a single
56 partition, select the
57 .Ic NetBSD Root\*[Am]Usr
58 radio button. If you are using
59 multiple partitions, select
60 .Ic NetBSD Root
61 for the root partition
62 .Pq Pa /
63 and
64 .Ic NetBSD Usr
65 for all the other partitions. You should select
66 .Ic NetBSD Swap
67 for the swap partition.
68 .Pp
69 When you have finished converting each partition, select each partition and
70 click on the
71 .Ic Format
72 button. You will now be asked for a bunch of
73 parameters for the hard drive and the file system. Usually, you can just
74 take the defaults. If you are installing onto removable media (e.g. a Zip,
75 Jaz, or Syquest), please see the FAQ. Note that although this dialog only
76 has the
77 .Ic OK
78 button, you are not committed, yet. Once you get the values
79 you want, press the
80 .Ic OK
81 button. A dialog will be presented at this point
82 with two options:
83 .Ic Format
84 and
85 .Ic Cancel .
86 If you choose
87 .Ic Cancel ,
88 nothing will be written to your drive. If you choose
89 .Ic Format ,
90 the program will
91 proceed to make a file system.
92 .Pp
93 Mkfs is not a well-behaved Macintosh application. It will not allow any
94 other tasks to run while it does (cooperative multitasking at its best).
95 When it's finished, the program will put up a dialog to ask if you have
96 scanned the output for any error messages. Usually there won't have been
97 any errors, but do scan the output to make sure. Simply click on the
98 .Ic "I Read It"
99 button and the program will quit.
100 .Pp
101 Repeat as necessary for any extra partitions that you wish to make
102 file systems on. Note that you do
103 .Em not
104 need a file system on your swap partition.
105 .Pp
106 When you are finished, click on the
107 .Ic Done
108 button and choose
109 .Ic Quit
110 from the
111 .Ic File
112 menu to exit Mkfs.
113 .
114 .Ss2 Installing the files
115 .
116 Before using the Installer, it is probably a good idea to increase its
117 memory allocation. Select the Installer icon by clicking on it and choose
118 .Ic Get Info
119 from the File menu. Increase both the Minimum and Preferred
120 sizes to as much as you can spare.
121 .Pp
122 Double-click on the Installer icon to start it up. The Installer will
123 present the same SCSI-ID menu that Mkfs did. Select the same SCSI-ID
124 (SCSI target number) that
125 you did for Mkfs - i.e., the one you are installing
126 .Nx
127 on.
128 .Pp
129 If you are installing onto a single root partition
130 .Pq Pa / ,
131 proceed to the
132 .Sx Installation\ of\ base\ files
133 section, below.
134 .Pp
135 If you have not created file systems for
136 .Pa /
137 (root),
138 .Pa usr ,
139 and any other file systems, go back to
140 .Sx Preparing the file system(s)
141 above.
142 .Pp
143 When you started the Installer, it mounted your root partition
144 .Pq Pa / .
145 Just before it printed
146 .Pp
147 .Dl "Mounting partition 'A' as /"
148 .Pp
149 it printed lines like:
150 .Pp
151 .Dl "sd1 at scsi ID 5"
152 .Pp
153 This means that the device for SCSI target 5 ("SCSI ID 5") is
154 .Li sd1 .
155 The partitions
156 are signified by a trailing letter. For instance,
157 .Li sd1a
158 would be
159 the root partition
160 .Pq Pa /
161 of the second SCSI disk in the chain, and
162 .Li sd0g
163 would be the first Usr partition on the first SCSI disk.
164 .Pp
165 You will need to know the proper device to mount the remaining
166 partition(s) by hand:
167 .(enum -offset indent
168 Select
169 .Ic Build Devices
170 from the
171 .Ic File
172 menu.
173 .It
174 Select
175 .Ic Mini Shell
176 from the
177 .Ic File
178 menu.
179 .It
180 You can use the
181 .Ic disklabel
182 command to get a listing of
183 the available partitions and their types and sizes.
184 .It
185 Create the directory mount point(s) with the command:
186 .Pp
187 .Dl # Ic "mkdir path"
188 .Pp
189 E.g. for the
190 .Pa /usr
191 partition type:
192 .Pp
193 .Dl # Ic "mkdir /usr"
194 .It
195 Mount the file systems you wish with the command:
196 .Pp
197 .Dl # Ic "mount device path"
198 For example, if you wish to mount a
199 .Pa /usr
200 partition from the first SCSI disk
201 .Li sd0 ,
202 on
203 .Pa /usr , No you would type:
204 .Pp
205 .Dl # Ic "mount /dev/sd0g /usr"
206 .It
207 Type
208 .Dl # Ic "fstab force"
209 to create a proper
210 .Pa /etc/fstab
211 file.
212 .It
213 Type
214 .Ic quit
215 after you have mounted all the file systems.
216 .bullet)
217 .
218 .Ss2 Installation of base files
219 .
220 Select the
221 .Ic Install
222 menu item from the
223 .Ic File
224 menu and install
225 .Pa base.tgz , etc.tgz , either kern-GENERIC.tgz or kern-GENERICSBC.tgz ,
226 and any other sets you wish to
227 install at this time (see the
228 .Sx NetBSD\ \*V\ Release\ Contents
229 for information
230 about what's in each set). The Installer will print out the
231 filename of each file as it is installed, and will take quite some
232 time to install everything (the base package alone can take over two
233 hours on a slow hard drive).
234 .Pp
235 As is the case with Mkfs, this is not a particularly well-behaved
236 Macintosh application and the machine will be completely tied up
237 while the installation takes place.
238 .Pp
239 At some point after installing the base set, select the
240 .Ic Build Devices
241 option from the
242 .Ic File
243 menu if you have not already done
244 so. This will create a bunch of device nodes for you and will
245 create your initial
246 .Pa /etc/fstab .
247 The Installer program also has an
248 option to give you a mini-shell. Do not use this unless you are
249 sure know what you are doing.
250 .Pp
251 When you are finished installing all of the sets you wish to
252 install, exit the Installer by choosing
253 .Ic Quit No from the Ic File
254 .No menu.
255 .
256 .Ss2 Booting the system
257 .
258 Prior to attempting to boot
259 .Nx*M ,
260 please verify that all of
261 the following are true:
262 .(enum
263 32-bit addressing is enabled [2] in the Memory control panel;
264 .It
265 All forms of virtual memory are disabled (the Memory control
266 panel, RAM Doubler, or other software-based memory enhancement
267 products); and
268 .It
269 Your system is in B\*[Am]W mode (1-bit color or grayscale) as shown
270 by the Monitors control panel. You may choose to have the
271 Booter do this for you automatically by selecting the appropriate
272 check box and radio button in the
273 .Ic Monitors No dialog on the
274 .Ic Options No menu .
275 .enum)
276 .Pp
277 It is probably best to boot your machine with all extensions turned
278 off [2]. You can do this by booting into
279 .Tn Mac OS
280 with the SHIFT key held
281 down. You may have to restart your Macintosh for changes to take effect
282 before proceeding.
283 .(tag [2]
284 .It [2]
285 If your version of the Memory control panel does not have a 32-bit
286 addressing mode radio button, this means that your system is already
287 32-bit clean and is running in 32-bit addressing mode by default. If the
288 Booter complains that you are not in 32-bit mode, it may be necessary
289 for you to press the
290 .Ic Use Defaults
291 button in the Memory control panel to
292 restore 32-bit addressing. You should probably reboot after doing so.
293 If you have an older II-class system (including the II, IIx, IIcx,
294 and SE/30), it is necessary to install Connectix's MODE32 to work around
295 ROM issues which prevent you from enabling 32-bit addressing. Please see the
296 .Nx*M
297 FAQ at
298 .Lk http://www.NetBSD.org/ports/\*M/faq/
299 for more information.
300 .tag)
301 .Pp
302 Double-click on the
303 .Nx*M
304 Booter icon to start the application.
305 Select
306 .Ic Booting
307 from the
308 .Ic Options
309 menu. Check that all of the items in
310 the resulting dialog look sane - especially the SCSI target number.
311 If not, correct
312 them to your preference (the SCSI target number, or "SCSI ID",
313 should be the only thing you need to
314 change). When you are satisfied with your choices, try booting
315 .Nx
316 by selecting
317 .Ic Boot Now No from the
318 .Ic Options No menu.
319 .Pp
320 If you wish to save your preferences, choose
321 .Ic Save Options
322 from the
323 .Ic File
324 menu before Booting (your preferences will not be saved if you
325 forget to do this).
326 .Pp
327 If the system does not come up, send mail to
328 .Mt port-\*M@NetBSD.org
329 describing your software, your hardware, and as complete a description of
330 the problem as you can.
331 .Pp
332 If the system does come up, congratulations, you have successfully installed
333 .Nx \*V .