svn commit: r44134 - head/en_US.ISO8859-1/books/handbook/advanced-networking
Dru Lavigne
dru at FreeBSD.org
Wed Mar 5 18:27:37 UTC 2014
Author: dru
Date: Wed Mar 5 18:27:36 2014
New Revision: 44134
URL: http://svnweb.freebsd.org/changeset/doc/44134
Log:
Clarify the procedure for setting up the PXE Environment.
Comment out some sections which probably no longer apply.
Sponsored by: iXsystems
Modified:
head/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.xml
Modified: head/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.xml Wed Mar 5 18:10:32 2014 (r44133)
+++ head/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.xml Wed Mar 5 18:27:36 2014 (r44134)
@@ -3914,8 +3914,7 @@ ifconfig_<literal>lagg0</literal>="laggp
<sect2 xml:id="network-pxe-nfs">
<info>
- <title>Setting Up the &man.chroot.8; Environment for the
- <acronym>NFS</acronym> Root File System</title>
+ <title>Setting Up the <acronym>PXE</acronym> Environment</title>
<authorgroup>
<author>
@@ -3931,29 +3930,30 @@ ifconfig_<literal>lagg0</literal>="laggp
</authorgroup>
</info>
+ <para>The steps shown in this section configure the built-in
+ <acronym>NFS</acronym> and <acronym>TFTP</acronym> servers. The
+ next section demonstrates how to install and configure the
+ <acronym>DHCP</acronym> server. In this example, the
+ directory which will contain the files used by <acronym>PXE</acronym> users is
+ <filename>/b/tftpboot/FreeBSD/install</filename>. It is
+ important that this directory exists and that the same directory
+ name is set in both <filename>/etc/inetd.conf</filename> and
+ <filename>/usr/local/etc/dhcpd.conf</filename>.</para>
+
<procedure>
<step>
- <para>Choose a directory which will have a &os;
- installation which will be <acronym>NFS</acronym>
- mountable. For example, a directory such as
- <filename>/b/tftpboot/FreeBSD/install</filename> can be
- used.</para>
+ <para>Create the root directory which will contain a &os; installation
+ to be <acronym>NFS</acronym> mounted:</para>
<screen>&prompt.root; <userinput>export NFSROOTDIR=/b/tftpboot/FreeBSD/install</userinput>
&prompt.root; <userinput>mkdir -p ${NFSROOTDIR}</userinput></screen>
-
- <para>Place <filename>tftpboot</filename>
- anywhere on the server. Make sure that the location is
- set in both <filename>/etc/inetd.conf</filename> and
- <filename>/usr/local/etc/dhcpd.conf</filename>.</para>
</step>
<step>
<para>Enable the <acronym>NFS</acronym> server by adding this line to
- <filename>/etc/rc.conf</filename></para>
+ <filename>/etc/rc.conf</filename>:</para>
<programlisting>nfs_server_enable="YES"</programlisting>
-
</step>
<step>
@@ -3965,9 +3965,9 @@ ifconfig_<literal>lagg0</literal>="laggp
</step>
<step>
- <para>Restart the <acronym>NFS</acronym> server:</para>
+ <para>Start the <acronym>NFS</acronym> server:</para>
- <screen>&prompt.root; <userinput>service nfsd restart</userinput></screen>
+ <screen>&prompt.root; <userinput>service nfsd start</userinput></screen>
</step>
<step>
@@ -3978,8 +3978,9 @@ ifconfig_<literal>lagg0</literal>="laggp
</step>
<step>
- <para>Add the following line to
- <filename>/etc/inetd.conf</filename>:</para>
+ <para>Uncomment the following line in
+ <filename>/etc/inetd.conf</filename> by making sure it
+ does not start with a <literal>#</literal> symbol:</para>
<programlisting>tftp dgram udp wait root /usr/libexec/tftpd tftpd -l -s /b/tftpboot</programlisting>
@@ -3987,22 +3988,21 @@ ifconfig_<literal>lagg0</literal>="laggp
<para>Some
<acronym>PXE</acronym> versions require the
<acronym>TCP</acronym> version of
- <acronym>TFTP</acronym>. In this case, add a second
- line, replacing <literal>dgram udp</literal> with
+ <acronym>TFTP</acronym>. In this case, uncomment the second
+ <literal>tftp</literal> line which contains
<literal>stream tcp</literal>.</para>
</note>
-
</step>
<step>
- <para>Restart &man.inetd.8;:</para>
+ <para>Start &man.inetd.8;:</para>
- <screen>&prompt.root; <userinput>service inetd restart</userinput></screen>
+ <screen>&prompt.root; <userinput>service inetd start</userinput></screen>
</step>
<step>
- <para>Rebuild the &os; kernel and userland (<xref
- linkend="makeworld"/>):</para>
+ <para>Rebuild the &os; kernel and userland (refer to <xref
+ linkend="makeworld"/> for more detailed instructions):</para>
<screen>&prompt.root; <userinput>cd /usr/src</userinput>
&prompt.root; <userinput>make buildworld</userinput>
@@ -4034,7 +4034,7 @@ Received 264951 bytes in 0.1 seconds</sc
<acronym>NFS</acronym>:</para>
<programlisting># Device Mountpoint FSType Options Dump Pass
-myhost.example.com:/b/tftpboot/FreeBSD/install / nfs ro 0 0</programlisting>
+<replaceable>myhost.example.com</replaceable>:/b/tftpboot/FreeBSD/install / nfs ro 0 0</programlisting>
<para>Replace <replaceable>myhost.example.com</replaceable>
with the hostname or <acronym>IP</acronym> address of the
@@ -4045,18 +4045,16 @@ myhost.example.com:/b/tftpboot/FreeBSD/i
</step>
<step>
- <para>Set the root password in the &man.chroot.8;
- environment:</para>
+ <para>Set the root password in the <acronym>PXE</acronym>
+ environment for client machines which
+ are <acronym>PXE</acronym> booting :</para>
<screen>&prompt.root; <userinput>chroot ${NFSROOTDIR}</userinput>
&prompt.root; <userinput>passwd</userinput></screen>
-
- <para>This sets the root password for client machines which
- are <acronym>PXE</acronym> booting.</para>
</step>
<step>
- <para>Enable &man.ssh.1; root logins for client machines
+ <para>If needed, enable &man.ssh.1; root logins for client machines
which are <acronym>PXE</acronym> booting by editing
<filename>${NFSROOTDIR}/etc/ssh/sshd_config</filename>
and enabling <literal>PermitRootLogin</literal>. This
@@ -4064,22 +4062,36 @@ myhost.example.com:/b/tftpboot/FreeBSD/i
</step>
<step>
- <para>Perform other customizations of the &man.chroot.8;
- environment in ${NFSROOTDIR}. These customizations could
- include things like adding packages with &man.pkg.add.1;,
- editing the password file with &man.vipw.8;, or editing
- &man.amd.conf.5; maps for automounting. For
- example:</para>
-
- <screen>&prompt.root; <userinput>chroot ${NFSROOTDIR}</userinput>
-&prompt.root; <userinput>pkg_add -r bash</userinput></screen>
+ <para>Perform any other needed customizations of the <acronym>PXE</acronym>
+ environment in <filename>${NFSROOTDIR}</filename>. These customizations could
+ include things like installing packages or
+ editing the password file with &man.vipw.8;.</para>
</step>
</procedure>
+
+ <para>When booting from an <acronym>NFS</acronym> root volume,
+ <filename>/etc/rc</filename> detects the
+ <acronym>NFS</acronym> boot and runs
+ <filename>/etc/rc.initdiskless</filename>. In this case,
+ <filename>/etc</filename> and <filename>/var</filename> need
+ to be memory backed file systems so that these directories are
+ writable but the <acronym>NFS</acronym> root directory is
+ read-only:</para>
+
+ <screen>&prompt.root; <userinput>chroot ${NFSROOTDIR}</userinput>
+&prompt.root; <userinput>mkdir -p conf/base</userinput>
+&prompt.root; <userinput>tar -c -v -f conf/base/etc.cpio.gz --format cpio --gzip etc</userinput>
+&prompt.root; <userinput>tar -c -v -f conf/base/var.cpio.gz --format cpio --gzip var</userinput></screen>
+
+ <para>When the system boots, memory file systems for
+ <filename>/etc</filename> and <filename>/var</filename> will
+ be created and mounted and the contents of the
+ <filename>cpio.gz</filename> files will be copied into
+ them.</para>
</sect2>
<sect2 xml:id="network-pxe-setting-up-dhcp">
- <title>Configuring the <application>ISC
- DHCP</application> Server</title>
+ <title>Configuring the <acronym>DHCP</acronym> Server</title>
<indexterm>
<primary>DHCP</primary>
@@ -4180,7 +4192,8 @@ myhost.example.com:/b/tftpboot/FreeBSD/i
The <acronym>NFS</acronym> server will then be the
same as the <acronym>TFTP</acronym> one.</para>
</sect2>
-
+<!--
+Are these sections still needed?
<sect2>
<title>Preparing the Root File System</title>
@@ -4296,32 +4309,7 @@ cd /usr/src/etc; make distribution</prog
&man.devfs.5; to allocate device nodes transparently for
the user.</para>
</sect2>
-
- <sect2>
- <title>Configuring Memory File Systems Used by
- <filename>/etc/rc.initdiskless</filename></title>
-
- <para>When booting from an <acronym>NFS</acronym> root volume,
- <filename>/etc/rc</filename> detects the
- <acronym>NFS</acronym> boot and runs
- <filename>/etc/rc.initdiskless</filename>. Read the comments
- in this script to understand what is going on. In this case,
- <filename>/etc</filename> and <filename>/var</filename> need
- to be memory backed file systems so that these directories are
- writable but the <acronym>NFS</acronym> root directory is
- read-only:</para>
-
- <screen>&prompt.root; <userinput>chroot ${NFSROOTDIR}</userinput>
-&prompt.root; <userinput>mkdir -p conf/base</userinput>
-&prompt.root; <userinput>tar -c -v -f conf/base/etc.cpio.gz --format cpio --gzip etc</userinput>
-&prompt.root; <userinput>tar -c -v -f conf/base/var.cpio.gz --format cpio --gzip var</userinput></screen>
-
- <para>When the system boots, memory file systems for
- <filename>/etc</filename> and <filename>/var</filename> will
- be created and mounted and the contents of the
- <filename>cpio.gz</filename> files will be copied into
- them.</para>
- </sect2>
+ -->
<sect2>
<title>Configuring the <acronym>PXE</acronym> Client and
More information about the svn-doc-all
mailing list