From owner-svn-doc-head@FreeBSD.ORG Fri May 29 20:16:41 2015 Return-Path: Delivered-To: svn-doc-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 715928A5; Fri, 29 May 2015 20:16:41 +0000 (UTC) (envelope-from allanjude@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 532C014E6; Fri, 29 May 2015 20:16:41 +0000 (UTC) (envelope-from allanjude@FreeBSD.org) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.9/8.14.9) with ESMTP id t4TKGfYe070447; Fri, 29 May 2015 20:16:41 GMT (envelope-from allanjude@FreeBSD.org) Received: (from allanjude@localhost) by svn.freebsd.org (8.14.9/8.14.9/Submit) id t4TKGfLL070446; Fri, 29 May 2015 20:16:41 GMT (envelope-from allanjude@FreeBSD.org) Message-Id: <201505292016.t4TKGfLL070446@svn.freebsd.org> X-Authentication-Warning: svn.freebsd.org: allanjude set sender to allanjude@FreeBSD.org using -f From: Allan Jude Date: Fri, 29 May 2015 20:16:41 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r46733 - head/en_US.ISO8859-1/books/handbook/jails X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.20 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 29 May 2015 20:16:41 -0000 Author: allanjude Date: Fri May 29 20:16:40 2015 New Revision: 46733 URL: https://svnweb.freebsd.org/changeset/doc/46733 Log: Fix incorrect instructions in ezjail upgrading section of the handbook There is no ezjail-update -r Explain how to upgrade between versions that different from the host version PR: 197804 Differential Revision: https://reviews.freebsd.org/D2114 Approved by: wblock (mentor) Sponsored by: ScaleEngine Inc. 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 20:02:35 2015 (r46732) +++ head/en_US.ISO8859-1/books/handbook/jails/chapter.xml Fri May 29 20:16:40 2015 (r46733) @@ -1294,14 +1294,34 @@ Retype New Password: updates have the same limitations as if &man.freebsd-update.8; were being run directly. The most important one is that only -RELEASE versions of &os; are - available with this method. To update the basejail to the - latest patched release of the version of &os; on the host - computer, use: + available with this method. + + Update the basejail to the latest patched release of + the version of &os; on the host. For example, updating from + RELEASE-p1 to RELEASE-p2. + + &prompt.root; ezjail-admin update -u + + To upgrade the basejail to a new version, first + upgrade the host system as described in . Once the host has + been upgraded and rebooted, the basejail can then be + upgraded. &man.freebsd-update.8; has no way of determining + which version is currently installed in the basejail, so the + original version must be specified. Use &man.file.1; to + determine the original version in the basejail: + + &prompt.root; file /usr/jails/basejail/bin/sh +/usr/jails/basejail/bin/sh: ELF 64-bit LSB executable, x86-64, version 1 (FreeBSD), dynamically linked (uses shared libs), for FreeBSD 9.3, stripped + + Now use this information to perform the upgrade from + 9.3-RELEASE to the current version of + the host system: - &prompt.root; ezjail-admin update -r + &prompt.root; ezjail-admin update -U -s 9.3-RELEASE - After updating the basejail, &man.mergemaster.8; can be - run to update each jail's configuration files. + After updating the basejail, &man.mergemaster.8; must + be run to update each jail's configuration files. How to use &man.mergemaster.8; depends on the purpose and trustworthiness of a jail. If a jail's services or