Date: Mon, 5 Mar 2018 15:50:47 +0000 (UTC) From: Rodrigo Osorio <rodrigo@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r51461 - head/en_US.ISO8859-1/books/handbook/advanced-networking Message-ID: <201803051550.w25FolFh039888@repo.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: rodrigo (ports committer) Date: Mon Mar 5 15:50:47 2018 New Revision: 51461 URL: https://svnweb.freebsd.org/changeset/doc/51461 Log: update/correct the Handbook Diskless operations chapter - Add the -maproot=root to the NFS export configuration - Mention base archive from the ftp server as an alternative way to install the base system - Fix the <command> usage - Add details about how to use md_size files to increase the default mfs size for /var and /etc PR: 213175 Submitted by: Natacha Porte <natbsd@instinctive.eu> Reviewed by: sevan bcr ian Approved by: ian sevan Sponsored by: The FreeBSD Foundation Differential Revision: https://reviews.freebsd.org/D14336 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 Sun Mar 4 18:34:15 2018 (r51460) +++ head/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.xml Mon Mar 5 15:50:47 2018 (r51461) @@ -3898,7 +3898,7 @@ ifconfig_<literal>lagg<replaceable>0</replaceable></li <acronym>NFS</acronym> by adding the following to <filename>/etc/exports</filename>:</para> - <programlisting>/b -ro -alldirs</programlisting> + <programlisting>/b -ro -alldirs -maproot=root</programlisting> </step> <step> @@ -3937,25 +3937,19 @@ ifconfig_<literal>lagg<replaceable>0</replaceable></li </step> <step> - <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> -&prompt.root; <userinput>make buildkernel</userinput></screen> + <para>Install the base system into + <filename>${NFSROOTDIR}</filename>, either by + decompressing the official archives or by rebuilding + the &os; kernel and userland (refer to + <xref linkend="makeworld"/> for more detailed + instructions, but do not forget to add + <option>DESTDIR=<replaceable>${NFSROOTDIR}</replaceable></option> + when running the + <command>make installkernel</command> and + <command>make installworld</command> commands.</para> </step> <step> - <para>Install &os; into the directory mounted over - <acronym>NFS</acronym>:</para> - - <screen>&prompt.root; <userinput>make installworld DESTDIR=${NFSROOTDIR}</userinput> -&prompt.root; <userinput>make installkernel DESTDIR=${NFSROOTDIR}</userinput> -&prompt.root; <userinput>make distribution DESTDIR=${NFSROOTDIR}</userinput></screen> - </step> - - <step> <para>Test that the <acronym>TFTP</acronym> server works and can download the boot loader which will be obtained via <acronym>PXE</acronym>:</para> @@ -4026,7 +4020,16 @@ Received 264951 bytes in 0.1 seconds</screen> <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> + them. By default, these file systems have a maximum capacity + of 5 megabytes. If your archives do not fit, which is + usually the case for <filename>/var</filename> when binary + packages have been installed, request a larger size by putting + the number of 512 byte sectors needed (e.g., 5 megabytes + is 10240 sectors) in + <filename>${NFSROOTDIR}/conf/base/etc/md_size</filename> and + <filename>${NFSROOTDIR}/conf/base/var/md_size</filename> + files for <filename>/etc</filename> and + <filename>/var</filename> file systems respectively.</para> </sect2> <sect2 xml:id="network-pxe-setting-up-dhcp">
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201803051550.w25FolFh039888>