From owner-svn-doc-all@FreeBSD.ORG Wed Mar 5 18:57:16 2014 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 576D6251; Wed, 5 Mar 2014 18:57:16 +0000 (UTC) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 37899E8A; Wed, 5 Mar 2014 18:57:16 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.8/8.14.8) with ESMTP id s25IvGDS048985; Wed, 5 Mar 2014 18:57:16 GMT (envelope-from dru@svn.freebsd.org) Received: (from dru@localhost) by svn.freebsd.org (8.14.8/8.14.8/Submit) id s25IvGeB048984; Wed, 5 Mar 2014 18:57:16 GMT (envelope-from dru@svn.freebsd.org) Message-Id: <201403051857.s25IvGeB048984@svn.freebsd.org> From: Dru Lavigne Date: Wed, 5 Mar 2014 18:57:16 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r44135 - head/en_US.ISO8859-1/books/handbook/advanced-networking X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 05 Mar 2014 18:57:16 -0000 Author: dru Date: Wed Mar 5 18:57:15 2014 New Revision: 44135 URL: http://svnweb.freebsd.org/changeset/doc/44135 Log: Editorial pass through Configuring DHCP section. 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:27:36 2014 (r44134) +++ head/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.xml Wed Mar 5 18:57:15 2014 (r44135) @@ -4098,36 +4098,23 @@ Received 264951 bytes in 0.1 secondsdiskless operation - PXE requires a TFTP - and a DHCP server to be set up. The + The DHCP server does not need to be the same - machine as the TFTP server, but it needs + machine as the TFTP and NFS server, but it needs to be accessible in the network. - The ISC DHCP server can - answer both BOOTP and - DHCP requests. - - ISC DHCP is not part of the - base system. Install the + DHCP is not part of the &os; + base system but can be installed using the net/isc-dhcp42-server port or - package, following the instructions documented at . Make sure that - /etc/rc.conf and - /usr/local/etc/dhcpd.conf are - correctly configured.. + package. - Once ISC DHCP is installed, - edit its configuration file, + Once installed, + edit the configuration file, /usr/local/etc/dhcpd.conf. Configure the next-server, filename, and - option root-path settings to specify - the TFTP server IP - address, the path to /boot/pxeboot - in TFTP, and the path to the - NFS root file system. Here is a sample - dhcpd.conf setup: + root-path settings as seen in this + example: subnet 192.168.0.0 netmask 255.255.255.0 { range 192.168.0.2 192.168.0.3 ; @@ -4138,14 +4125,13 @@ Received 264951 bytes in 0.1 seconds192.168.0.1 ; - # path of boot loader obtained - # via tftp - filename "FreeBSD/install/boot/pxeboot" ; + # path of boot loader obtained via tftp + filename "FreeBSD/install/boot/pxeboot" ; # pxeboot boot loader will try to NFS mount this directory for root FS - option root-path "192.168.0.1:/b/tftpboot/FreeBSD/install/" ; + option root-path "192.168.0.1:/b/tftpboot/FreeBSD/install/" ; } @@ -4160,37 +4146,29 @@ Received 264951 bytes in 0.1 secondshost declarations. --> - The next-server directive - designates the TFTP or - NFS server to use for loading - &man.loader.8; or the kernel file. The default is to - use the same host as the DHCP + The next-server directive is used + to specify the IP address of the + TFTP server. The filename directive defines - the file that PXE will load for the - next execution step. It must be specified according - to the transfer method used. - PXE uses TFTP, - which is why a relative filename is used here. Also, - PXE loads - pxeboot, not the kernel. There are - other interesting possibilities, like loading - pxeboot from a &os; CD-ROM - /boot directory. - Since &man.pxeboot.8; can load a - GENERIC kernel, it is possible to - use PXE to boot from a remote - CD-ROM. + the path to /boot/pxeboot. A + relative filename is used, meaning that + /b/tftpboot is not included in the + path. The root-path option defines - the path to the root file system, in usual - NFS notation. When using - PXE, it is possible to leave off the - host's IP address as long as the - BOOTP kernel option is not enabled. - The NFS server will then be the - same as the TFTP one. + the path to the NFS root file system. + + Once the edits are saved, enable + NFS at boot time by adding the + following line to /etc/rc.conf: + + dhcpd_enable="YES" + + Then, start the DHCP service: + + &prompt.root; service isc-dhcpd start