summaryrefslogtreecommitdiff
path: root/en
diff options
context:
space:
mode:
authorFrans Pop <elendil@planet.nl>2006-12-26 19:46:26 +0000
committerFrans Pop <elendil@planet.nl>2006-12-26 19:46:26 +0000
commit35aa54a022ca3fac5b1c91993e5bdaef2ad7ea57 (patch)
treec4035051ef1619ff3843f41bdfe03a51300bc4f6 /en
parent51959569398f7226ac8d19c9d534d21953bb144a (diff)
downloadinstallation-guide-35aa54a022ca3fac5b1c91993e5bdaef2ad7ea57.zip
- All architectures that support TFTP booting also support DCHP, so remove the "supports-dhcp" condition
- According to the text, Alpha supports BOOTP - Use dhcp3-server for examples rather than dhcp (version 2) - tftpd-hpa does not use /tftpboot by default; allow for this in examples
Diffstat (limited to 'en')
-rw-r--r--en/install-methods/install-tftp.xml61
-rw-r--r--en/install-methods/tftp/bootp.xml10
-rw-r--r--en/install-methods/tftp/dhcp.xml19
-rw-r--r--en/preparing/needed-info.xml2
4 files changed, 52 insertions, 40 deletions
diff --git a/en/install-methods/install-tftp.xml b/en/install-methods/install-tftp.xml
index 39c528be2..6376874e4 100644
--- a/en/install-methods/install-tftp.xml
+++ b/en/install-methods/install-tftp.xml
@@ -13,26 +13,27 @@ and the machine configured to support booting of your specific machine.
</para><para>
-You need to setup a TFTP server, and for many machines, a BOOTP server
-<phrase condition="supports-rarp">, or RARP server</phrase>
-<phrase condition="supports-dhcp">, or DHCP server</phrase>.
+You need to setup a TFTP server, and for many machines a DHCP
+server<phrase condition="supports-rarp">, or RARP
+server</phrase><phrase condition="supports-bootp">, or BOOTP
+server</phrase>.
</para><para>
<phrase condition="supports-rarp">The Reverse Address Resolution Protocol (RARP) is
one way to tell your client what IP address to use for itself. Another
-way is to use the BOOTP protocol. </phrase>
+way is to use the BOOTP protocol.</phrase>
<phrase condition="supports-bootp">BOOTP is an IP protocol that
informs a computer of its IP address and where on the network to obtain
-a boot image. </phrase>
+a boot image.</phrase>
-<phrase arch="m68k"> Yet another alternative exists on VMEbus
-systems: the IP address can be manually configured in boot ROM. </phrase>
+<phrase arch="m68k">Yet another alternative exists on VMEbus
+systems: the IP address can be manually configured in boot ROM.</phrase>
-<phrase condition="supports-dhcp">The DHCP (Dynamic Host Configuration
-Protocol) is a more flexible, backwards-compatible extension of BOOTP.
-Some systems can only be configured via DHCP. </phrase>
+The DHCP (Dynamic Host Configuration Protocol) is a more flexible,
+backwards-compatible extension of BOOTP.
+Some systems can only be configured via DHCP.
</para><para arch="powerpc">
@@ -101,18 +102,33 @@ tftp dgram udp wait nobody /usr/sbin/tcpd in.tftpd /tftpboot
Debian packages will in general set this up correctly by default when they
are installed.
-</para><para>
+</para>
+<note><para>
+
+Historically TFTP servers used <filename>/tftpboot</filename> as directory
+to serve images from. However, &debian; packages may use other directories
+to comply with the <ulink url="&url-fhs-home;">Filesystem Hierarchy
+Standard</ulink>. For example, <classname>tftpd-hpa</classname> by default
+uses <filename>/var/lib/tftpboot</filename>. You may have to adjust the
+configuration examples in this section accordingly.
+
+</para></note>
+<para>
+
+Look in <filename>/etc/inetd.conf</filename> and remember the directory which
+is used as the argument of <command>in.tftpd</command><footnote>
-Look in that file and remember the directory which is used as the
-argument of <command>in.tftpd</command>; you'll need that below. The
-<userinput>-l</userinput> argument enables some versions of
+<para>
+The <userinput>-l</userinput> argument enables some versions of
<command>in.tftpd</command> to log all requests to the system logs;
-this is useful for diagnosing boot errors. If you've had to change
-<filename>/etc/inetd.conf</filename>, you'll have to notify the
-running <command>inetd</command> process that the file has changed.
-On a Debian machine, run <userinput>/etc/init.d/inetd
-reload</userinput>; on other machines,
-find out the process ID for <command>inetd</command>, and run
+this is useful for diagnosing boot errors.
+</para>
+
+</footnote>; you'll need that below.
+If you've had to change <filename>/etc/inetd.conf</filename>, you'll have to
+notify the running <command>inetd</command> process that the file has changed.
+On a Debian machine, run <userinput>/etc/init.d/inetd reload</userinput>; on
+other machines, find out the process ID for <command>inetd</command>, and run
<userinput>kill -HUP <replaceable>inetd-pid</replaceable></userinput>.
</para><para arch="mips">
@@ -146,8 +162,7 @@ to adjust the range of source ports the Linux TFTP server uses.
Next, place the TFTP boot image you need, as found in
<xref linkend="where-files"/>, in the <command>tftpd</command>
-boot image directory. Generally, this directory will be
-<filename>/tftpboot</filename>. You'll have to make a link from that
+boot image directory. You may have to make a link from that
file to the file which <command>tftpd</command> will use for booting a
particular client. Unfortunately, the file name is determined by the
TFTP client, and there are no strong standards.
@@ -166,7 +181,7 @@ images via TFTP itself. For net booting, use the
For PXE booting, everything you should need is set up in the
<filename>netboot/netboot.tar.gz</filename> tarball. Simply extract this
tarball into the <command>tftpd</command> boot image directory. Make sure
-your dhcp server is configured to pass <filename>/pxelinux.0</filename>
+your dhcp server is configured to pass <filename>pxelinux.0</filename>
to <command>tftpd</command> as the filename to boot.
</para><para arch="ia64">
diff --git a/en/install-methods/tftp/bootp.xml b/en/install-methods/tftp/bootp.xml
index cda0f9c66..f0b0eab42 100644
--- a/en/install-methods/tftp/bootp.xml
+++ b/en/install-methods/tftp/bootp.xml
@@ -3,14 +3,14 @@
<sect2 condition="supports-bootp" id="tftp-bootp">
- <title>Setting up BOOTP server</title>
+ <title>Setting up a BOOTP server</title>
<para>
There are two BOOTP servers available for GNU/Linux. The first is CMU
<command>bootpd</command>. The other is actually a DHCP server: ISC
<command>dhcpd</command>. In &debian; these are contained in the
-<classname>bootp</classname> and <classname>dhcp</classname> packages
-respectively.
+<classname>bootp</classname> and <classname>dhcp3-server</classname>
+packages respectively.
</para><para>
@@ -61,11 +61,11 @@ By contrast, setting up BOOTP with ISC <command>dhcpd</command> is
really easy, because it treats BOOTP clients as a moderately special
case of DHCP clients. Some architectures require a complex
configuration for booting clients via BOOTP. If yours is one of
-those, read the section <xref linkend="dhcpd"/>. Otherwise, you
+those, read the section <xref linkend="dhcpd"/>. In that case, you
will probably be able to get away with simply adding the
<userinput>allow bootp</userinput> directive to the configuration
block for the subnet containing the client, and restart
-<command>dhcpd</command> with <userinput>/etc/init.d/dhcpd
+<command>dhcpd</command> with <userinput>/etc/init.d/dhcpd3-server
restart</userinput>.
</para>
diff --git a/en/install-methods/tftp/dhcp.xml b/en/install-methods/tftp/dhcp.xml
index fb9c624ea..39327ae23 100644
--- a/en/install-methods/tftp/dhcp.xml
+++ b/en/install-methods/tftp/dhcp.xml
@@ -1,14 +1,14 @@
<!-- retain these comments for translator revision tracking -->
<!-- $Id$ -->
- <sect2 condition="supports-dhcp" id="dhcpd">
+ <sect2 id="dhcpd">
<title>Setting up a DHCP server</title>
<para>
One free software DHCP server is ISC <command>dhcpd</command>.
-In &debian;, this is available in the <classname>dhcp</classname> package.
-Here is a sample configuration file for it (usually
-<filename>/etc/dhcpd.conf</filename>):
+For &debian;, the <classname>dhcp3-server</classname> package is
+recommended. Here is a sample configuration file for it (see
+<filename>/etc/dhcp3/dhcpd.conf</filename>):
<informalexample><screen>
option domain-name "example.com";
@@ -32,9 +32,6 @@ host clientname {
}
</screen></informalexample>
-Note: the new (and preferred) <classname>dhcp3</classname> package uses
-<filename>/etc/dhcp3/dhcpd.conf</filename>.
-
</para><para>
In this example, there is one server
@@ -48,7 +45,7 @@ file which will be retrieved via TFTP.
</para><para>
After you have edited the <command>dhcpd</command> configuration file,
-restart it with <userinput>/etc/init.d/dhcpd restart</userinput>.
+restart it with <userinput>/etc/init.d/dhcpd3-server restart</userinput>.
</para>
@@ -79,11 +76,11 @@ subnet 192.168.1.0 netmask 255.255.255.0 {
}
group {
- next-server 192.168.1.3;
- host tftpclient {
+ next-server 192.168.1.3;
+ host tftpclient {
# tftp client hardware address
hardware ethernet 00:10:DC:27:6C:15;
- filename "/tftpboot/pxelinux.0";
+ filename "pxelinux.0";
}
}
</screen></informalexample>
diff --git a/en/preparing/needed-info.xml b/en/preparing/needed-info.xml
index 8f68abd37..4a7b21e3c 100644
--- a/en/preparing/needed-info.xml
+++ b/en/preparing/needed-info.xml
@@ -390,7 +390,7 @@ Service) server.
</para></listitem>
</itemizedlist>
-</para><para condition="supports-dhcp">
+</para><para>
On the other hand, if your administrator tells you that a DHCP server
is available and is recommended, then you don't need this information