svn commit: r54184 - head/en_US.ISO8859-1/books/handbook/jails

[Brad Davis]

Author: brd
Date: Fri May 29 20:14:40 2020
New Revision: 54184
URL: https://svnweb.freebsd.org/changeset/doc/54184

Log:
  Replace the manual fetch method with bsdinstall and break the methods
  into separate sections.
  
  Will follow up with the white space change as a separate commit.
  
  Reviewed by:	bcr
  Differential Revision:	https://reviews.freebsd.org/D25044

Modified:
  head/en_US.ISO8859-1/books/handbook/jails/chapter.xml

Modified: head/en_US.ISO8859-1/books/handbook/jails/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/handbook/jails/chapter.xml	Fri May 29 00:06:42 2020	(r54183)
+++ head/en_US.ISO8859-1/books/handbook/jails/chapter.xml	Fri May 29 20:14:40 2020	(r54184)
@@ -201,6 +201,27 @@
       prebuilt binaries (such as those supplied on an install media)
       or build from source.</para>
 
+    <sect2>
+      <title>Installing a Jail</title>
+
+      <sect3 xml:id="jails-install-internet">
+        <title>To install a Jail from the Internet</title>
+      
+        <para>The &man.bsdinstall.8; tool can be used to fetch and
+          install the binaries needed for a jail.  This will walk through
+          the picking of a mirror, which distributions will be installed
+          into the destination directory, and some basic configuration
+          of the jail:</para>
+    
+        <screen>&prompt.root; <userinput>bsdinstall jail <replaceable>/here/is/the/jail</replaceable></userinput></screen>
+      
+        <para>Once the command is complete, the next step is configuring
+          the host to run the jail.</para>
+      </sect3>
+
+      <sect3 xml:id="jails-install-iso">
+        <title>To install a Jail from an ISO</title>
+
     <para>To install the userland from installation media, first
       create the root directory for the jail.  This can be done by
       setting the <varname>DESTDIR</varname> variable to the proper
@@ -217,14 +238,6 @@
     <screen>&prompt.root; <userinput>mount -t cd9660 /dev/`mdconfig -f cdimage.iso` /mnt</userinput>
 &prompt.root; <userinput>cd /mnt/usr/freebsd-dist/</userinput></screen>
 
-    <para>Alternatively, download the tarballs from a mirror:</para>
-
-    <screen>&prompt.root; <userinput>sh</userinput>
-&prompt.root; <userinput>export DESTRELEASE=<replaceable>12.0-RELEASE</replaceable></userinput>
-&prompt.root; <userinput>export DESTARCH=<replaceable>`uname -m`</replaceable></userinput>
-&prompt.root; <userinput>export SOURCEURL=<replaceable>http://ftp.freebsd.org/pub/</replaceable>FreeBSD/releases/$DESTARCH/$DESTRELEASE/</userinput>
-&prompt.root; <userinput>for set in base ports; do fetch $SOURCEURL/$set.txz ; done</userinput></screen>
-
     <para>Extract the binaries from the tarballs on the install media
       into the declared destination.  Minimally, only the base set
       needs to be extracted, but a complete install can be performed
@@ -237,7 +250,11 @@
     <para>To install everything except the kernel:</para>
 
     <screen>&prompt.root; <userinput>for set in base ports; do tar -xf $set.txz -C $DESTDIR ; done</userinput></screen>
+      </sect3>
 
+      <sect3 xml:id="jails-install-source">
+        <title>To build and install a Jail from source</title>
+
     <para>The &man.jail.8; manual page explains the procedure for
       building a jail:</para>
 
@@ -301,7 +318,12 @@
 	  &man.devfs.8; and &man.devfs.conf.5; manual pages.</para>
       </callout>
     </calloutlist>
+      </sect3>
+    </sect2>
 
+    <sect2>
+      <title>Configuring the Host</title>
+
     <para>Once a jail is installed, it can be started by using the
       &man.jail.8; utility.  The &man.jail.8; utility takes four
       mandatory arguments which are described in the <xref
@@ -372,6 +394,7 @@
 
     <para>More information about this can be found in the &man.jail.8;
       manual page.</para>
+    </sect2>
   </sect1>
 
   <sect1 xml:id="jails-tuning">