Sync usage with man page.
[netbsd-mini2440.git] / distrib / notes / atari / prep
blob7defe08a2d0769ec5c76209d9772b406bb7fbbb3
1 .\"     $NetBSD: prep,v 1.12 2003/02/12 08:18:22 leo Exp $
3 .Ss2 Preparing your hard disk for the NetBSD installation.
4 Note that you will be modifying your hard drives and if you mess something
5 up here you could lose everything on all the drives that you work with.
6 It is therefore advised that you:
7 .(bullet
8 Write down your current configurations.
9 Do this by writing down all partition info (especially their sizes).
10 .It
11 .Em Back up the partitions you are keeping.
12 .bullet)
13 .Pp
15 .Nx
16 has to share the disk with another operating system, you can
17 either take care of partitioning your harddisk before installing
18 .Nx
19 or delay this until the installer requests you to do it.
20 If you decide to do it now, please create space for at least
21 .Pa /
22 (root) and swap partitions.
23 Whatever you decide, take note of the paragraphs below!
24 You need this info to create bootable disks.
25 .Pp
26 .(tag Warning:
27 .It Em Warning:
28 The AHDI partitioning function erases all partitions on your harddisk
29 even if they are not changed!
30 We know this is rather stupid, but don't say we didn't warn you.
31 .tag)
32 .Pp
33 If you want to use an AHDI partitioning scheme and you want to be able to
34 boot directly into
35 .Nx ,
36 there are some constraints on the partition layout.
37 .Pp
38 As you might know, every hard disk has a
39 .Sq root sector
40 that contains information about the size of the hard disk and the partitions
41 on the hard disk.
42 The root sector can only contain the necessary data for four partitions.
43 Nobody thought that this limitation would cause any problems.
44 After all, 640 KByte should be enough.
45 As hard disks grew, it was necessary to define more than four partitions.
46 In order to be more or less compatible with the old format,
47 a new type of partition entry was defined: XGM partitions.
48 .Pp
49 An XGM partition is a
50 .Sq look over there
51 sign: Another root sector can be
52 found at the start of the XGM partition.
53 This root sector contains the remaining real partitions.
54 And this is the big mystery: Partitions defined
55 in the root sector of the hard disk are called
56 .Sq "primary partitions" ,
57 partitions defined in the root sector of an XGM partition are called
58 .Sq "extended partitions" .
59 .Pp
60 The bootblock will only work if the first NBD partition is a primary
61 partition.
62 This is not a limitation of
63 .Nx
64 but a limitation of
65 .Tn TOS Ns / Ns AHDI:
66 You can only boot from primary partitions.
67 .Pp
68 If you are creating your partitions with HDX, you'll have to be very careful
69 to fulfill this rule.
70 HDX has some very strange ideas when it comes to extended partitions.
71 Fortunately, you can edit this stuff: The
72 .Dq "Edit partition scheme of the unit"
73 dialog box has a button labeled
74 .Dq "expert" .
75 This button is inactive unless you have defined more than four partitions.
76 Click on it
77 .Em after
78 you have defined the sizes of the partitions.
79 .Pp
80 A new dialog box appears on the screen.
81 The left side contains two blocks of partitions;
82 the upper block always contains the first four partitions, the
83 lower block contains the last three partitions.
84 If you have defined less than
85 7 partitions, some fields of the lower block will contain the string
86 .Dq "unused" .
87 Some of the partitions will be displayed in reverse video: These are the
88 extended partitions.
89 .Pp
90 The right side contains six possible ranges for the extended partitions.
91 It is not possible to define your own range, you will have to use one of the
92 schemes offered by HDX.
93 To quote from Ghostbusters: Choose and die.
94 The default scheme used by HDX is the first scheme: Extended partitions start
95 with the second partition and end with the second to last partition.
96 If you
97 have defined 7 partitions, partitions #2 to #5 will be extended partitions,
98 while partitions #1, #6 and #7 will be primary partitions.
99 .Pp
100 You can move the extended partition range by clicking on one of the buttons
101 on the right side of the dialog box.
102 Try to find one where your first
104 partition is a primary partition.
105 Golden rules:
106 .(bullet
107 If the disk contains no
108 .Tn GEMDOS
109 partitions, don't use AHDI.
112 handle it alone.
114 If the disk contains one
115 .Tn GEMDOS
116 partition, make it partition #1 and
117 start the extended partition range at partition #3.
118 This allows you
119 to boot from both the
120 .Tn GEMDOS
121 and the
123 partitions.
125 If the disk contains two
126 .Tn GEMDOS
127 partitions, use partitions #1 and #2
129 .Tn GEMDOS ,
130 partition #3 for NetBSD-root.
131 Start the extended partition range with partition #4.
133 If your disks contains three or more
134 .Tn GEMDOS
135 partitions, you are in trouble.
136 Try using partitions #1 and #2 as the first two
137 .Tn GEMDOS
138 partitions.
139 Use partition #3 as the first
141 partition.
142 Start the extended partition range with partition #4.
143 Put the other
145 extended partition range.
146 .bullet)
148 .Ss2 Booting the installer on an existing system
149 If you already have
151 installed, it is easy.
152 Just boot into single user mode on your current system, or use the
153 .Ic shutdown now
154 command to shutdown to single-user mode.
155 Then copy the installer using
156 .Ic dd :
158 .Dl Ic "dd if=sysinst.fs of=/dev/rsd0b"
160 where
161 .Li /dev/rsd0b
162 should be the device path of the swap partition your system
163 is configured to use.
164 Once the file is copied, reboot back to the booter
165 and use the '-b' option to make the kernel prompt for a root device.
166 Now enter the swap device as your root device to start the installer.
168 .Ss2 Booting the installer on new systems.
169 If your system has more than 6MB RAM, you can skip directly to the section
170 about
171 .Ic loadbsd.ttp,
172 since the amount of RAM is enough to load the installer into.
174 For new new installations on small memory systems, things are a bit more
175 complicated.
176 The easiest way is to mark an AHDI partition as id 'SWP'.
177 You can either accomplish this with HDdriver or use the
178 .Ic chg_pid.ttp
179 program supplied on the bootfloppy.
180 To use the fifth partition of your
181 first drive to a swap partition, do the following:
183 .Dl Ic "chg_pid -w 0 4 SWP"
185 As you can see, both the drive and the partition numbers are zero
186 based.
188 When a swap partition has been created, you can transfer the installer using
190 .Ic file2swp.ttp
191 command, which is also on the bootfloppy.
192 This program copies a (gzipped) file
193 to the first AHDI partition with id 'SWP' on the designated disk.
194 To copy sysinst.fs to your first SCSI disk, use:
196 .Dl Ic "file2swp -w -f sysinst.fs s0"
198 Note that
199 .Ic file2swp
200 automatically detects a gzipped file, there is no need for a .gz extension.
201 .Ss2 Using loadbsd.ttp
202 To start the installer, you first need to load a
204 kernel.
205 This can be done in a couple ways, both of which currently require
206 .Tn GEMDOS .
207 You need either the bootfloppy provided in the
208 distribution or you can copy the
209 .Ic loadbsd.ttp
210 program and
211 kernel to a boot floppy disk (1.44 MB needed) or put them on a
212 .Tn TOS
213 partition.
214 Select the loadbsd program and it will ask for parameters, supply:
215 .Sq Ic "-b netbsd"
216 (or whatever name you copied the kernel to).
217 You can, of course, also run it from the shell command-line in
218 .Tn MiNT :
220 .Dl Ic "loadbsd -b a:/netbsd"
222 You should see the screen clear and some information about
223 your system as the kernel configures the hardware.
224 Then you will be prompted for a root device.
225 If you copied the installer to a swap partition, as explained above,
226 you have to enter the swap partition as the boot device.
227 When you used your first SCSI disk, this will be
228 .Ic sd0b.
229 On the first IDE drive it would be
230 .Ic wd0b.
232 If you didn't copy the installer to swap, you need to use the RAMdisk, so
233 remove the
234 .Tn GEMDOS
235 kernel boot floppy from the drive if present and insert the
237 install floppy 1.
238 Now enter the name of the boot device depending on the floppy type you have
239 inserted. Use:
240 .(bullet
241 .Ic md0a
242 for the old installer (1MB filesystem) on 720KB floppies.
244 .Ic md1a
245 for the sysinst installer on 720KB floppies.
247 .Ic md2a
248 for the sysinst installer on 1.44MB floppies.
249 .bullet)
250 The kernel will load the install file system into RAMdisk.
251 While the kernel is loading, it will show a
252 .Sq \&.
253 for each track loaded.
254 After loading 80 tracks, it will ask you to insert the next floppy.
255 At this time, insert the
257 install floppy 2 and press any key.
258 The kernel continues loading another 40 tracks before it continues to boot.