From owner-svn-doc-all@FreeBSD.ORG Mon Jun 11 07:03:43 2012 Return-Path: <owner-svn-doc-all@FreeBSD.ORG> Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 69143106564A; Mon, 11 Jun 2012 07:03:43 +0000 (UTC) (envelope-from rodrigc@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:4f8:fff6::2c]) by mx1.freebsd.org (Postfix) with ESMTP id 52B0D8FC12; Mon, 11 Jun 2012 07:03:43 +0000 (UTC) Received: from svn.freebsd.org (localhost [127.0.0.1]) by svn.freebsd.org (8.14.4/8.14.4) with ESMTP id q5B73hOA049009; Mon, 11 Jun 2012 07:03:43 GMT (envelope-from rodrigc@svn.freebsd.org) Received: (from rodrigc@localhost) by svn.freebsd.org (8.14.4/8.14.4/Submit) id q5B73hTr049006; Mon, 11 Jun 2012 07:03:43 GMT (envelope-from rodrigc@svn.freebsd.org) Message-Id: <201206110703.q5B73hTr049006@svn.freebsd.org> From: Craig Rodrigues <rodrigc@FreeBSD.org> Date: Mon, 11 Jun 2012 07:03:43 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Cc: Subject: svn commit: r39022 - in head: en_US.ISO8859-1/books/handbook en_US.ISO8859-1/books/handbook/advanced-networking share/images/books/handbook/advanced-networking X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" <svn-doc-all.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/svn-doc-all>, <mailto:svn-doc-all-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/svn-doc-all> List-Post: <mailto:svn-doc-all@freebsd.org> List-Help: <mailto:svn-doc-all-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/svn-doc-all>, <mailto:svn-doc-all-request@freebsd.org?subject=subscribe> X-List-Received-Date: Mon, 11 Jun 2012 07:03:43 -0000 Author: rodrigc (src committer) Date: Mon Jun 11 07:03:42 2012 New Revision: 39022 URL: http://svn.freebsd.org/changeset/doc/39022 Log: Enhance text which explains how to debug networking problems when setting up PXE. Reviewed by: gjb Added: head/share/images/books/handbook/advanced-networking/pxe-nfs.png (contents, props changed) Modified: head/en_US.ISO8859-1/books/handbook/Makefile head/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.sgml Modified: head/en_US.ISO8859-1/books/handbook/Makefile ============================================================================== --- head/en_US.ISO8859-1/books/handbook/Makefile Sun Jun 10 21:50:47 2012 (r39021) +++ head/en_US.ISO8859-1/books/handbook/Makefile Mon Jun 11 07:03:42 2012 (r39022) @@ -49,6 +49,7 @@ IMAGES_EN = advanced-networking/isdn-bus IMAGES_EN+= advanced-networking/isdn-twisted-pair.eps IMAGES_EN+= advanced-networking/natd.eps IMAGES_EN+= advanced-networking/net-routing.pic +IMAGES_EN+= advanced-networking/pxe-nfs.png IMAGES_EN+= advanced-networking/static-routes.pic IMAGES_EN+= bsdinstall/bsdinstall-adduser1.png IMAGES_EN+= bsdinstall/bsdinstall-adduser2.png Modified: head/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.sgml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.sgml Sun Jun 10 21:50:47 2012 (r39021) +++ head/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.sgml Mon Jun 11 07:03:42 2012 (r39022) @@ -4590,7 +4590,7 @@ myhost.example.com:/b/tftpboot/FreeBSD/i them.</para> </sect2> - <sect2> + <sect2 id="network-pxe-setting-up-dhcp"> <title>Setting up the DHCP Server</title> <para>PXE requires a <acronym>TFTP</acronym> server and a @@ -4659,11 +4659,64 @@ subnet 192.168.0.0 netmask 255.255.255.0 </step> <step> - <para>Use the - <filename role="package">net/wireshark</filename> port to - debug the <acronym>DHCP</acronym> and - <acronym>TFTP</acronym> network traffic to look for any - problems.</para> + <para>Use the <filename role="package">net/wireshark</filename> + port to debug the network traffic involved during the + <acronym>PXE</acronym> booting process, which is + illustrated in the diagram below. + In <xref linkend="network-pxe-setting-up-dhcp">, an + example configuration is shown where the + <acronym>DHCP</acronym>, <acronym>TFTP</acronym>, and + <acronym>NFS</acronym> servers are actually on the same + machine. However, these severs can be on separate + machines.</para> + + <figure> + <title>PXE Booting process with NFS root mount</title> + <mediaobjectco> + <imageobjectco> + <areaspec units="calspair"> + <area id="co-pxenfs1" coords="2873,8133 3313,7266"> + <area id="co-pxenfs2" coords="3519,6333 3885,5500"> + <area id="co-pxenfs3" coords="4780,5866 5102,5200"> + <area id="co-pxenfs4" coords="4794,4333 5102,3600"> + <area id="co-pxenfs5" coords="3108,2666 3519,1800"> + </areaspec> + <imageobject> + <imagedata fileref="advanced-networking/pxe-nfs"> + </imageobject> + <calloutlist> + <callout arearefs="co-pxenfs1"> + <para>Client broadcasts DHCPDISCOVER.</para> + </callout> + <callout arearefs="co-pxenfs2"> + <para>DHCP server responds with IP address, + <literal>next-server</literal>, + <literal>filename</literal>, and + <literal>root-path</literal>.</para> + </callout> + <callout arearefs="co-pxenfs3"> + <para>Client sends <acronym>TFTP</acronym> + request to <literal>next-server</literal> + asking to retrieve + <literal>filename</literal>.</para> + </callout> + <callout arearefs="co-pxenfs4"> + <para>TFTP server responds and sends + <literal>filename</literal> to client.</para> + </callout> + <callout arearefs="co-pxenfs5"> + <para>Client executes + <literal>filename</literal> which is + &man.pxeboot.8;. &man.pxeboot.8; loads the + kernel. When the kernel executes, the root + filesystem specified by + <literal>root-path</literal> is mounted over + <acronym>NFS</acronym>.</para> + </callout> + </calloutlist> + </imageobjectco> + </mediaobjectco> + </figure> </step> <step> Added: head/share/images/books/handbook/advanced-networking/pxe-nfs.png ============================================================================== Binary file. No diff available.