Index: en_US.ISO8859-1/books/handbook/jails/chapter.xml =================================================================== --- en_US.ISO8859-1/books/handbook/jails/chapter.xml +++ en_US.ISO8859-1/books/handbook/jails/chapter.xml @@ -1313,14 +1313,34 @@ 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