From owner-svn-doc-all@freebsd.org Fri May 29 20:14:41 2020 Return-Path: Delivered-To: svn-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 2D8B92F0741; Fri, 29 May 2020 20:14:41 +0000 (UTC) (envelope-from brd@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "Let's Encrypt Authority X3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 49YbQ90ShVz4LYY; Fri, 29 May 2020 20:14:41 +0000 (UTC) (envelope-from brd@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 0B2711D067; Fri, 29 May 2020 20:14:41 +0000 (UTC) (envelope-from brd@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id 04TKEe0L028709; Fri, 29 May 2020 20:14:40 GMT (envelope-from brd@FreeBSD.org) Received: (from brd@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id 04TKEeDZ028708; Fri, 29 May 2020 20:14:40 GMT (envelope-from brd@FreeBSD.org) Message-Id: <202005292014.04TKEeDZ028708@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: brd set sender to brd@FreeBSD.org using -f From: Brad Davis Date: Fri, 29 May 2020 20:14:40 +0000 (UTC) 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 X-SVN-Group: doc-head X-SVN-Commit-Author: brd X-SVN-Commit-Paths: head/en_US.ISO8859-1/books/handbook/jails X-SVN-Commit-Revision: 54184 X-SVN-Commit-Repository: doc 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.33 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: Fri, 29 May 2020 20:14:41 -0000 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. + + Installing a Jail + + + To install a Jail from the Internet + + 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: + + &prompt.root; bsdinstall jail /here/is/the/jail + + Once the command is complete, the next step is configuring + the host to run the jail. + + + + To install a Jail from an ISO + To install the userland from installation media, first create the root directory for the jail. This can be done by setting the DESTDIR variable to the proper @@ -217,14 +238,6 @@ &prompt.root; mount -t cd9660 /dev/`mdconfig -f cdimage.iso` /mnt &prompt.root; cd /mnt/usr/freebsd-dist/ - Alternatively, download the tarballs from a mirror: - - &prompt.root; sh -&prompt.root; export DESTRELEASE=12.0-RELEASE -&prompt.root; export DESTARCH=`uname -m` -&prompt.root; export SOURCEURL=http://ftp.freebsd.org/pub/FreeBSD/releases/$DESTARCH/$DESTRELEASE/ -&prompt.root; for set in base ports; do fetch $SOURCEURL/$set.txz ; done - 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 @@ To install everything except the kernel: &prompt.root; for set in base ports; do tar -xf $set.txz -C $DESTDIR ; done + + + To build and install a Jail from source + The &man.jail.8; manual page explains the procedure for building a jail: @@ -301,7 +318,12 @@ &man.devfs.8; and &man.devfs.conf.5; manual pages. + + + + Configuring the Host + 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 More information about this can be found in the &man.jail.8; manual page. +