From 120405ef5252ef8f0619899e839eca4faf6f1a34 Mon Sep 17 00:00:00 2001
From: Gordon Bergling <gbe@FreeBSD.org>
Date: Fri, 17 Jul 2020 21:26:19 +0000
Subject: Handbook: Jails, add upgrade instructions.

PR:		247927
Submitted by:	Chris Jordan <cwjordandt at gmail dot com>
Reviewed by:	debdrup, bcr (mentor)
Approved by:	bcr (mentor)
Differential Revision:	https://reviews.freebsd.org/D25668
---
 en_US.ISO8859-1/books/handbook/jails/chapter.xml | 25 ++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

(limited to 'en_US.ISO8859-1/books/handbook')

diff --git a/en_US.ISO8859-1/books/handbook/jails/chapter.xml b/en_US.ISO8859-1/books/handbook/jails/chapter.xml
index d9b4ca80be..8696521234 100644
--- a/en_US.ISO8859-1/books/handbook/jails/chapter.xml
+++ b/en_US.ISO8859-1/books/handbook/jails/chapter.xml
@@ -535,8 +535,33 @@
 	to maintain jails instead.  Use <option>-b</option> to specify
 	the path of the jail to be updated.</para>
 
+      <para>To update the jail to the latest patch release of the
+	version of &os; it is already running, then execute the
+	following commands on the host:</para>
+
       <screen>&prompt.root; <userinput>freebsd-update -b <replaceable>/here/is/the/jail</replaceable> fetch</userinput>
 &prompt.root; <userinput>freebsd-update -b <replaceable>/here/is/the/jail</replaceable> install</userinput></screen>
+
+      <para>To upgrade the jail to a new major or minor version,
+	first upgrade the host system as described in
+	<xref linkend="freebsdupdate-upgrade" />. Once the host has been
+	upgraded and rebooted, the jail can then be upgraded.
+	For example to upgrade from 12.0-RELEASE to 12.1-RELEASE,
+	on the host run:</para>
+
+      <screen>&prompt.root; <userinput>freebsd-update -b <replaceable>/here/is/the/jail</replaceable> --currently-running <replaceable>12.0-RELEASE</replaceable> -r <replaceable>12.1-RELEASE</replaceable> upgrade</userinput>
+&prompt.root; <userinput>freebsd-update -b <replaceable>/here/is/the/jail</replaceable> install</userinput>
+&prompt.root; <userinput>service jail restart <replaceable>myjail</replaceable></userinput>
+&prompt.root; <userinput>freebsd-update -b <replaceable>/here/is/the/jail</replaceable> install</userinput></screen>
+
+      <para>Then, if it was a major version upgrade, reinstall all
+	installed packages and restart the jail again.  This is
+	required because the ABI version changes when upgrading
+	between major versions of &os;. From the host:</para>
+
+      <screen>&prompt.root; <userinput>pkg -j <replaceable>myjail</replaceable> upgrade -f</userinput>
+&prompt.root; <userinput>service jail restart <replaceable>myjail</replaceable></userinput></screen>
+
     </sect2>
   </sect1>
 
-- 
cgit v1.2.3