← Back to branch summary

~qbalazs/installation-guide/lp1030336

« back to all changes in this revision

Viewing changes to en/howto/installation-howto.xml

  • Committer: joeyh
  • Date: 2005-10-07 19:51:38 UTC
  • Revision ID: vcs-imports@canonical.com-20051007195138-c3d57b2617a79a4f
move manual to top-level directory, split out of debian-installer package

Show diffs side-by-side

added added

removed removed

Lines of Context:
en/howto/installation-howto.xml
 
1
<!-- retain these comments for translator revision tracking -->
 
2
<!-- $Id: installation-howto.xml 31137 2005-10-03 20:38:50Z fjp $ -->
 
3
 
 
4
<appendix id="installation-howto">
 
5
<title>Installation Howto</title>
 
6
 
 
7
<para>
 
8
 
 
9
This document describes how to install &debian; &releasename; for
 
10
the &arch-title; (<quote>&architecture;</quote>) with the
 
11
new &d-i;. It is a quick walkthrough of the installation process
 
12
which should contain all the information you will need for most installs.
 
13
When more information can be useful, we will link to more detailed
 
14
explanations in the <link linkend="debian_installation_guide">&debian;
 
15
Installation Guide</link>.
 
16
 
 
17
</para>
 
18
 
 
19
 <sect1 id="howto-preliminaries">
 
20
 <title>Preliminaries</title>
 
21
<para>
 
22
 
 
23
<phrase condition="unofficial-build">
 
24
The debian-installer is still in a beta state.
 
25
</phrase>
 
26
If you encounter bugs during your install, please refer to
 
27
<xref linkend="submit-bug" /> for instructions
 
28
on how to report them. If you have questions which cannot be
 
29
answered by this document, please direct them to the debian-boot
 
30
mailing list (&email-debian-boot-list;) or ask on IRC (#debian-boot
 
31
on the freenode network).
 
32
 
 
33
</para>
 
34
 </sect1>
 
35
 
 
36
 <sect1 id="howto-getting-images">
 
37
 <title>Booting the installer</title>
 
38
<para>
 
39
 
 
40
<phrase condition="unofficial-build">
 
41
For some quick links to CD images, check out the <ulink url="&url-d-i;">
 
42
&d-i; home page</ulink>.
 
43
</phrase>
 
44
The debian-cd team provides builds of CD images using &d-i; on the
 
45
<ulink url="&url-debian-cd;">Debian CD page</ulink>.
 
46
For more information on where to get CDs, see <xref linkend="official-cdrom" />.
 
47
 
 
48
</para><para>
 
49
 
 
50
Some installation methods require other images than CD images.
 
51
<phrase condition="unofficial-build">
 
52
The <ulink url="&url-d-i;">&d-i; home page</ulink> has links to
 
53
other images.
 
54
</phrase>
 
55
<xref linkend="where-files" /> explains how to find images on Debian
 
56
mirrors.
 
57
 
 
58
</para><para>
 
59
 
 
60
The subsections below will give the details about which images you should
 
61
get for each possible means of installation.
 
62
 
 
63
</para>
 
64
 
 
65
  <sect2 id="howto-getting-images-cdrom">
 
66
  <title>CDROM</title>
 
67
 
 
68
<para>
 
69
 
 
70
There are two different netinst CD images which can be used to install
 
71
&releasename; with the &d-i;. These images are intended to boot from CD
 
72
and install additional packages over a network, hence the name 'netinst'.
 
73
The difference between the two images is that on the full netinst image
 
74
the base packages are included, whereas you have to download these from
 
75
the web if you are using the business card image. If you'd rather, you can
 
76
get a full size CD image which will not need the network to install. You
 
77
only need the first CD of the set.
 
78
 
 
79
</para><para>
 
80
 
 
81
Download whichever type you prefer and burn it to a CD.
 
82
<phrase arch="i386">To boot the CD, you may need to change your BIOS
 
83
configuration, as explained in <xref linkend="bios-setup" />.</phrase>
 
84
<phrase arch="powerpc">
 
85
To boot a PowerMac from CD, press the <keycap>c</keycap> key while booting. See
 
86
<xref linkend="boot-cd" /> for other ways to boot from CD.
 
87
</phrase>
 
88
 
 
89
</para>
 
90
  </sect2>
 
91
 
 
92
  <sect2 condition="supports-floppy-boot" id="howto-getting-images-floppy">
 
93
  <title>Floppy</title>
 
94
<para>
 
95
 
 
96
If you can't boot from CD, you can download floppy images to install
 
97
Debian. You need the <filename>floppy/boot.img</filename>, the
 
98
<filename>floppy/root.img</filename> and possibly one of the driver disks.
 
99
 
 
100
</para><para>
 
101
 
 
102
The boot floppy is the one with <filename>boot.img</filename> on it.
 
103
This floppy, when booted, will prompt you to insert a second floppy &mdash;
 
104
use the one with <filename>root.img</filename> on it.
 
105
 
 
106
</para><para>
 
107
 
 
108
If you're planning to install over the network, you will usually need
 
109
the <filename>floppy/net-drivers.img</filename>, which contains additional
 
110
drivers for many ethernet cards, and support for PCMCIA.
 
111
 
 
112
</para><para>
 
113
 
 
114
If you have a CD, but cannot boot from it, then boot from floppies and use
 
115
<filename>floppy/cd-drivers.img</filename> on a driver disk to complete the
 
116
install using the CD.
 
117
 
 
118
</para><para>
 
119
 
 
120
Floppy disks are one of the least reliable media around, so be prepared for
 
121
lots of bad disks (see <xref linkend="unreliable-floppies" />). Each
 
122
<filename>.img</filename> file you downloaded goes on a single floppy;
 
123
you can use the dd command to write it to /dev/fd0 or some other means
 
124
(see <xref linkend="create-floppy" /> for details).
 
125
Since you'll have more than one floppy, it's a good idea to label them.
 
126
 
 
127
</para>
 
128
  </sect2>
 
129
 
 
130
  <sect2 condition="bootable-usb" id="howto-getting-images-usb">
 
131
  <title>USB memory stick</title>
 
132
<para>
 
133
 
 
134
It's also possible to install from removable USB storage devices. For
 
135
example a USB keychain can make a handy Debian install medium that you
 
136
can take with you anywhere.
 
137
 
 
138
</para><para>
 
139
 
 
140
The easiest way to prepare your USB memory stick is to download
 
141
<filename>hd-media/boot.img.gz</filename>, and use gunzip to extract the 128 MB
 
142
image from that file. Write this image directly to your memory stick, which
 
143
must be at least 128 mb in size. Of course this will destroy anything already
 
144
on the memory stick. Then mount the memory stick, which will now have a FAT
 
145
filesystem on it. Next, download a Debian netinst CD image, and copy that file
 
146
to the memory stick; any filename is ok as long as it ends in
 
147
<literal>.iso</literal>.
 
148
 
 
149
</para><para>
 
150
 
 
151
There are other, more flexible ways to set up a memory stick to use the
 
152
debian-installer, and it's possible to get it to work with smaller memory
 
153
sticks. For details, see <xref linkend="boot-usb-files" />.
 
154
 
 
155
</para><para arch="i386">
 
156
 
 
157
Some BIOSes can boot USB storage directly, and some cannot. You may need to
 
158
configure your BIOS to boot from a <quote>removable drive</quote> or even a
 
159
<quote>USB-ZIP</quote> to get it to boot from the USB device. If it
 
160
doesn't, you can boot from one floppy and use the USB stick for the rest of
 
161
the install. For helpful hints and details, see <xref linkend="usb-boot" />.
 
162
 
 
163
</para><para arch="powerpc">
 
164
 
 
165
Booting Macintosh systems from USB storage devices involves manual use
 
166
of Open Firmware. For directions, see <xref linkend="usb-boot" />.
 
167
 
 
168
</para>
 
169
  </sect2>
 
170
 
 
171
  <sect2 id="howto-getting-images-netboot">
 
172
  <title>Booting from network</title>
 
173
<para>
 
174
 
 
175
It's also possible to boot &d-i; completely from the net. The
 
176
various methods to netboot depend on your architecture and netboot setup.
 
177
The files in <filename>netboot/</filename> can be used to netboot &d-i;.
 
178
 
 
179
</para><para arch="i386">
 
180
 
 
181
The easiest thing to set up is probably PXE netbooting. Untar the
 
182
file <filename>netboot/pxeboot.tar.gz</filename> into
 
183
<filename>/var/lib/tftpboot</filename> or
 
184
wherever is appropriate for your tftp server. Set up your DHCP server to pass
 
185
filename <filename>/pxelinux.0</filename> to clients, and with luck
 
186
everything will just work.
 
187
For detailed instructions, see <xref linkend="install-tftp" />.
 
188
 
 
189
</para>
 
190
  </sect2>
 
191
 
 
192
  <sect2 id="howto-getting-images-hard-disk">
 
193
  <title>Booting from hard disk</title>
 
194
<para>
 
195
 
 
196
It's possible to boot the installer using no removable media, but just an
 
197
existing hard disk, which can have a different OS on it. Download
 
198
<filename>hd-media/initrd.gz</filename>, <filename>hd-media/vmlinuz</filename>,
 
199
and a Debian CD image to the top-level directory of the hard disk. Make sure
 
200
that the CD image has a filename ending in <literal>.iso</literal>. Now
 
201
it's just a matter of booting linux with the initrd.
 
202
<phrase arch="i386">
 
203
<xref linkend="boot-initrd" /> explains one way to do it.
 
204
</phrase>
 
205
 
 
206
</para>
 
207
  </sect2>
 
208
 </sect1>
 
209
 
 
210
 <sect1 id="howto-installation">
 
211
<title>Installation</title>
 
212
<para>
 
213
 
 
214
Once the installer starts, you will be greeted with an initial screen. Press
 
215
&enterkey; to boot, or read the instructions for other boot
 
216
methods and parameters (see <xref linkend="boot-parms" />).
 
217
<phrase arch="i386">
 
218
<phrase condition="sarge">
 
219
If you want a 2.6 kernel, type <userinput>linux26</userinput> at the
 
220
<prompt>boot:</prompt> prompt.
 
221
</phrase>
 
222
<phrase condition="etch">
 
223
If you want a 2.4 kernel, type <userinput>install24</userinput> at the
 
224
<prompt>boot:</prompt> prompt.
 
225
</phrase>
 
226
<footnote><para>
 
227
 
 
228
<phrase condition="sarge">
 
229
The 2.6 kernel is available for most boot methods, but not when booting from
 
230
a floppy.
 
231
</phrase>
 
232
<phrase condition="etch">
 
233
The 2.6 kernel is the default for most boot methods, but is not available
 
234
when booting from a floppy.
 
235
</phrase>
 
236
 
 
237
</para></footnote>
 
238
</phrase>
 
239
 
 
240
</para><para>
 
241
 
 
242
After a while you will be asked to select your language. Use the arrow keys
 
243
to pick a language and press &enterkey; to continue. Next you'll be asked to
 
244
select your country, with the choices including countries where your
 
245
language is spoken. If it's not on the short list, a list of all the
 
246
countries in the world is available.
 
247
 
 
248
</para><para>
 
249
 
 
250
You may be asked to confirm your keyboard layout. Choose the default unless
 
251
you know better.
 
252
 
 
253
</para><para>
 
254
 
 
255
Now sit back while debian-installer detects some of your hardware, and
 
256
loads the rest of itself from CD, floppy, USB, etc.
 
257
 
 
258
</para><para>
 
259
 
 
260
Next the installer will try to detect your network hardware and set up
 
261
networking by DHCP. If you are not on a network or do not have DHCP, you
 
262
will be given the opportunity to configure the network manually.
 
263
 
 
264
</para><para>
 
265
 
 
266
Now it is time to partition your disks. First you will be given the
 
267
opportunity to automatically partition either an entire drive, or free
 
268
space on a drive. This is recommended for new users or anyone in a hurry,
 
269
but if you do not want to autopartition, choose manual from the menu.
 
270
 
 
271
</para><para arch="i386">
 
272
 
 
273
If you have an existing DOS or Windows partition that you want to preserve,
 
274
be very careful with automatic partitioning. If you choose manual partitioning,
 
275
you can use the installer to resize existing FAT or NTFS partitions to create
 
276
room for the Debian install: simply select the partition and specify its new size.
 
277
 
 
278
</para><para>
 
279
 
 
280
On the next screen you will see your partition table, how the partitions
 
281
will be formatted, and where they will be mounted. Select a partition to
 
282
modify or delete it. If you did automatic partitioning, you should just be
 
283
able to choose <guimenuitem>Finished partitioning</guimenuitem> from the
 
284
menu to use what it set up. Remember to assign at least one partition for
 
285
swap space and to mount a partition on <filename>/</filename>.
 
286
<xref linkend="partitioning" /> has more information about partitioning.
 
287
 
 
288
</para><para>
 
289
 
 
290
Now &d-i; formats your partitions and starts to install the base system,
 
291
which can take a while. That is followed by installing a kernel.
 
292
 
 
293
</para><para>
 
294
 
 
295
The last step is to install a boot loader. If the installer detects
 
296
other operating systems on your computer, it will add them to the boot menu
 
297
and let you know.
 
298
<phrase arch="i386">By default GRUB will be installed to the master boot
 
299
record of the first harddrive, which is generally a good choice. You'll be
 
300
given the opportunity to override that choice and install it elsewhere.
 
301
</phrase>
 
302
 
 
303
</para><para>
 
304
 
 
305
&d-i; will now tell you that the installation has
 
306
finished. Remove the cdrom or other boot media and hit &enterkey;
 
307
to reboot your machine. It should boot up into the next stage of the install
 
308
process, which is explained in <xref linkend="boot-new" />.
 
309
 
 
310
</para><para>
 
311
 
 
312
If you need more information on the install process, see
 
313
<xref linkend="d-i-intro" />.
 
314
 
 
315
</para>
 
316
 </sect1>
 
317
 
 
318
 <sect1 id="howto-installation-report">
 
319
 <title>Send us an installation report</title>
 
320
<para>
 
321
 
 
322
If you successfully managed an installation with &d-i;,
 
323
please take time to provide us with a report. There is a template
 
324
named <filename>install-report.template</filename> in the
 
325
<filename>/root</filename> directory of a freshly
 
326
installed system. Please fill it out and file it as a bug against the
 
327
package <classname>installation-reports</classname>, as explained in
 
328
<xref linkend="submit-bug" />.
 
329
 
 
330
</para><para>
 
331
 
 
332
If you did not reach base-config or ran into other trouble, you
 
333
probably found a bug in debian-installer. To improve the installer it
 
334
is necessary that we know about them, so please take the time to
 
335
report them. You can use an installation report to report problems;
 
336
if the install completely fails, see <xref linkend="problem-report" />.
 
337
 
 
338
</para>
 
339
 </sect1>
 
340
 
 
341
 <sect1 id="howto-installation-finally">
 
342
 <title>And finally..</title>
 
343
<para>
 
344
 
 
345
We hope that your Debian installation is pleasant and that you find Debian
 
346
useful. You might want to read <xref linkend="post-install" />.
 
347
 
 
348
</para>
 
349
 </sect1>
 
350
</appendix>