← Back to branch summary

~ubuntu-branches/debian/sid/installation-guide/sid

« back to all changes in this revision

Viewing changes to nl/install-methods/install-tftp.xml

  • Committer: Bazaar Package Importer
  • Author(s): Frans Pop, Frans Pop, Joey Hess, Wouter Verhelst
  • Date: 2007-03-19 15:00:12 UTC
  • Revision ID: james.westby@ubuntu.com-20070319150012-gt27pr4xu0ts4cps
Tags: 20070319
http://bugs.debian.org/344048
http://bugs.debian.org/406515
http://bugs.debian.org/406290
http://bugs.debian.org/408408
http://bugs.debian.org/410317
http://bugs.debian.org/410129
http://bugs.debian.org/411399
http://bugs.debian.org/408340
http://bugs.debian.org/413257
[ Frans Pop ]
* Cleaned up definitions of some entities and removed unused ones.
* Implement infrastructure that allows entities to be translated.
  Thanks to Miroslav Kure for providing the patch. Closes: #344048, #406515.
* Disable Korean PDF/PS formats for builds for the website.
* appendix/files: update information about mouse configuration, based on a
  patch from Peter Samuelson (for which thanks). Closes: #406290.
* boot-installer, appendix/preseed: document preseed/interactive parameter.

[ Joey Hess ]
* Fix package name for installation-reports, and manual unfuzzy of all
  translations. Closes: #408408

[ Frans Pop ]
* welcome:
  - make links to FSF and GNU more consistent (closes: #410317)
  - we do not necessarily share the ideals of the FSF (closes: #410129)
  Thanks to Francesco Poli for suggesting these changes.
* using-d-i: guided partitioning now creates swap inside LVM.
  Thanks to Francesco Poli. Closes: #411399.
* Document installs over PPPoE. Based on a text proposed by Eddy Petrisor.
  Closes: #408340.
* installation-howto: update for the integration of base-config into D-I.
* appendix/preseed:
  - as exim no longer asks any questions during installations, there is no
    real need to document it anymore
  - add link to Philip Hand's website as it contains many creative examples
  - document how to select the ftp protocol during mirror selection
  - document how to install from CD/DVD only (and not use a network mirror)
* Update base/standard system and task sizes.

[ Joey Hess ]
* Document debian-installer/allow_unauthenticated.

[ Wouter Verhelst ]
* Update mac68k installation after notes from Finn Thain, upstream mac68k
  kernel hacker.

[ Frans Pop ]
* Replace entity in example-preseed.txt file. Thanks to Geert Stappers for
  spotting the error. Closes: #413257.

Show diffs side-by-side

added added

removed removed

Lines of Context:
nl/install-methods/install-tftp.xml
1
1
<!-- retain these comments for translator revision tracking -->
2
 
<!-- original version: 31138 untranslated -->
 
2
<!-- original version: 44002 untranslated -->
3
3
 
4
4
 <sect1 condition="supports-tftp" id="install-tftp">
5
5
 <title>Preparing Files for TFTP Net Booting</title>
13
13
 
14
14
</para><para>
15
15
 
16
 
You need to setup a TFTP server, and for many machines, a BOOTP server
17
 
<phrase condition="supports-rarp">, or RARP server</phrase>
18
 
<phrase condition="supports-dhcp">, or DHCP server</phrase>.
 
16
You need to setup a TFTP server, and for many machines a DHCP 
 
17
server<phrase condition="supports-rarp">, or RARP
 
18
server</phrase><phrase condition="supports-bootp">, or BOOTP
 
19
server</phrase>.
19
20
 
20
21
</para><para>
21
22
 
22
23
<phrase condition="supports-rarp">The Reverse Address Resolution Protocol (RARP) is
23
24
one way to tell your client what IP address to use for itself. Another
24
 
way is to use the BOOTP protocol. </phrase>
 
25
way is to use the BOOTP protocol.</phrase>
25
26
 
26
27
<phrase condition="supports-bootp">BOOTP is an IP protocol that
27
28
informs a computer of its IP address and where on the network to obtain
28
 
a boot image. </phrase>
29
 
 
30
 
<phrase arch="m68k"> Yet another alternative exists on VMEbus
31
 
systems: the IP address can be manually configured in boot ROM. </phrase>
32
 
 
33
 
<phrase condition="supports-dhcp">The DHCP (Dynamic Host Configuration
34
 
Protocol) is a more flexible, backwards-compatible extension of BOOTP.
35
 
Some systems can only be configured via DHCP. </phrase>
 
29
a boot image.</phrase>
 
30
 
 
31
<phrase arch="m68k">Yet another alternative exists on VMEbus
 
32
systems: the IP address can be manually configured in boot ROM.</phrase>
 
33
 
 
34
The DHCP (Dynamic Host Configuration Protocol) is a more flexible,
 
35
backwards-compatible extension of BOOTP.
 
36
Some systems can only be configured via DHCP.
36
37
 
37
38
</para><para arch="powerpc">
38
39
 
70
71
this section, we shall provide commands for SunOS 4.x, SunOS 5.x
71
72
(a.k.a. Solaris), and GNU/Linux.
72
73
 
73
 
<note arch="i386"><para>
 
74
<note arch="x86"><para>
74
75
 
75
76
To use the Pre-boot Execution Environment (PXE) method of TFTP
76
77
booting, you will need a TFTP server with <userinput>tsize</userinput>
101
102
Debian packages will in general set this up correctly by default when they
102
103
are installed.
103
104
 
104
 
</para><para>
105
 
 
106
 
Look in that file and remember the directory which is used as the
107
 
argument of <command>in.tftpd</command>; you'll need that below.  The
108
 
<userinput>-l</userinput> argument enables some versions of
 
105
</para>
 
106
<note><para>
 
107
 
 
108
Historically, TFTP servers used <filename>/tftpboot</filename> as directory
 
109
to serve images from. However, &debian; packages may use other directories
 
110
to comply with the <ulink url="&url-fhs-home;">Filesystem Hierarchy
 
111
Standard</ulink>. For example, <classname>tftpd-hpa</classname> by default
 
112
uses <filename>/var/lib/tftpboot</filename>. You may have to adjust the
 
113
configuration examples in this section accordingly.
 
114
 
 
115
</para></note>
 
116
<para>
 
117
 
 
118
Look in <filename>/etc/inetd.conf</filename> and remember the directory which
 
119
is used as the argument of <command>in.tftpd</command><footnote>
 
120
 
 
121
<para>
 
122
The <userinput>-l</userinput> argument enables some versions of
109
123
<command>in.tftpd</command> to log all requests to the system logs;
110
 
this is useful for diagnosing boot errors.  If you've had to change
111
 
<filename>/etc/inetd.conf</filename>, you'll have to notify the
112
 
running <command>inetd</command> process that the file has changed.
113
 
On a Debian machine, run <userinput>/etc/init.d/inetd
114
 
reload</userinput>; on other machines,
115
 
find out the process ID for <command>inetd</command>, and run
 
124
this is useful for diagnosing boot errors.
 
125
</para>
 
126
 
 
127
</footnote>; you'll need that below.
 
128
If you've had to change <filename>/etc/inetd.conf</filename>, you'll have to
 
129
notify the running <command>inetd</command> process that the file has changed.
 
130
On a Debian machine, run <userinput>/etc/init.d/inetd reload</userinput>; on
 
131
other machines, find out the process ID for <command>inetd</command>, and run
116
132
<userinput>kill -HUP <replaceable>inetd-pid</replaceable></userinput>.
117
133
 
118
134
</para><para arch="mips">
125
141
# echo 1 &gt; /proc/sys/net/ipv4/ip_no_pmtu_disc
126
142
</screen></informalexample>
127
143
 
128
 
to turn off Path MTU discovery, otherwise the Indy's PROM can't
 
144
to turn off Path MTU discovery, otherwise the SGI's PROM can't
129
145
download the kernel. Furthermore, make sure TFTP packets are sent from
130
146
a source port no greater than 32767, or the download will stall after
131
147
the first packet.  Again, it's Linux 2.4.X tripping this bug in the
146
162
 
147
163
Next, place the TFTP boot image you need, as found in
148
164
<xref linkend="where-files"/>, in the <command>tftpd</command>
149
 
boot image directory.  Generally, this directory will be
150
 
<filename>/tftpboot</filename>.  You'll have to make a link from that
 
165
boot image directory.  You may have to make a link from that
151
166
file to the file which <command>tftpd</command> will use for booting a
152
167
particular client.  Unfortunately, the file name is determined by the
153
168
TFTP client, and there are no strong standards.
161
176
<filename>yaboot-netboot.conf</filename>.  Just rename this to
162
177
<filename>yaboot.conf</filename> in the TFTP directory.
163
178
 
164
 
</para><para arch="i386">
 
179
</para><para arch="x86">
165
180
 
166
181
For PXE booting, everything you should need is set up in the
167
182
<filename>netboot/netboot.tar.gz</filename> tarball. Simply extract this
168
183
tarball into the <command>tftpd</command> boot image directory. Make sure
169
 
your dhcp server is configured to pass <filename>/pxelinux.0</filename>
 
184
your dhcp server is configured to pass <filename>pxelinux.0</filename>
170
185
to <command>tftpd</command> as the filename to boot.
171
186
 
172
187
</para><para arch="ia64">
186
201
 
187
202
For DECstations, there are tftpimage files for each subarchitecture,
188
203
which contain both kernel and installer in one file. The naming
189
 
convention is <replaceable>subarchitecture</replaceable>/netboot-boot.img.
 
204
convention is
 
205
<filename><replaceable>subarchitecture</replaceable>/netboot-boot.img</filename>.
190
206
Copy the tftpimage file you would like to use to
191
207
<userinput>/tftpboot/tftpboot.img</userinput> if you work with the
192
208
example BOOTP/DHCP setups described above.
262
278
   <title>SPARC TFTP Booting</title>
263
279
<para>
264
280
 
265
 
SPARC architectures for instance use the subarchitecture names, such
266
 
as <quote>SUN4M</quote> or <quote>SUN4C</quote>; in some cases, the
267
 
architecture is left blank, so the file the client looks for is just
268
 
<filename>client-ip-in-hex</filename>.  Thus, if your system
269
 
subarchitecture is a SUN4C, and its IP is 192.168.1.3, the filename
270
 
would be <filename>C0A80103.SUN4C</filename>. An easy way to determine
271
 
this is to enter the following command in a shell (assuming the
272
 
machine's intended IP is 10.0.0.4).
 
281
Some SPARC architectures add the subarchitecture names, such as
 
282
<quote>SUN4M</quote> or <quote>SUN4C</quote>, to the filename. Thus,
 
283
if your system's subarchitecture is a SUN4C, and its IP is 192.168.1.3,
 
284
the filename would be <filename>C0A80103.SUN4C</filename>. However,
 
285
there are also subarchitectures where the file the client looks for is
 
286
just <filename>client-ip-in-hex</filename>. An easy way to determine the
 
287
hexadecimal code for the IP address is to enter the following command
 
288
in a shell (assuming the machine's intended IP is 10.0.0.4).
273
289
 
274
290
<informalexample><screen>
275
291
$ printf '%.2x%.2x%.2x%.2x\n' 10 0 0 4
276
292
</screen></informalexample>
277
293
 
278
 
This will spit out the IP in hexadecimal; to get to the correct
279
 
filename, you will need to change all letters to uppercase and
280
 
if necessary append the subarchitecture name.
 
294
To get to the correct filename, you will need to change all letters to
 
295
uppercase and if necessary append the subarchitecture name.
 
296
 
 
297
</para><para>
 
298
 
 
299
If you've done all this correctly, giving the command <userinput>boot
 
300
net</userinput> from the OpenPROM should load the image. If the image
 
301
cannot be found, try checking the logs on your tftp server to see which
 
302
image name is being requested.
281
303
 
282
304
</para><para>
283
305
 
308
330
   </sect3>
309
331
 
310
332
   <sect3 arch="mips">
311
 
   <title>SGI Indys TFTP Booting</title>
 
333
   <title>SGI TFTP Booting</title>
312
334
<para>
313
335
 
314
 
On SGI Indys you can rely on the <command>bootpd</command> to supply
 
336
On SGI machines you can rely on the <command>bootpd</command> to supply
315
337
the name of the TFTP file. It is given either as the
316
338
<userinput>bf=</userinput> in <filename>/etc/bootptab</filename> or as
317
339
the <userinput>filename=</userinput> option in
321
343
   </sect3>
322
344
 
323
345
   <sect3 arch="mips">
324
 
   <title>Broadcom BCM91250A TFTP Booting</title>
 
346
   <title>Broadcom BCM91250A and BCM91480B TFTP Booting</title>
325
347
<para>
326
348
 
327
349
You don't have to configure DHCP in a special way because you'll pass the
328
 
full path of the file to the loaded to CFE.
 
350
full path of the file to be loaded to CFE.
329
351
 
330
352
</para>
331
353
   </sect3>