Date: Wed, 5 Mar 2014 18:27:36 +0000 (UTC) From: Dru Lavigne <dru@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r44134 - head/en_US.ISO8859-1/books/handbook/advanced-networking Message-ID: <201403051827.s25IRaPT036537@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201403051827.s25IRaPT036537>