Date: Fri, 29 May 2020 20:14:40 +0000 (UTC) From: Brad Davis <brd@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r54184 - head/en_US.ISO8859-1/books/handbook/jails Message-ID: <202005292014.04TKEeDZ028708@repo.freebsd.org>
next in thread | raw e-mail | index | archive | help
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">
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?202005292014.04TKEeDZ028708>