aboutsummaryrefslogtreecommitdiff
path: root/en_US.ISO8859-1/books/handbook
diff options
context:
space:
mode:
authorGordon Bergling <gbe@FreeBSD.org>2020-07-17 21:26:19 +0000
committerGordon Bergling <gbe@FreeBSD.org>2020-07-17 21:26:19 +0000
commit120405ef5252ef8f0619899e839eca4faf6f1a34 (patch)
treefd82d7ca6625c082d87d14592c7e7f10a046652d /en_US.ISO8859-1/books/handbook
parent55080708d5d2e2c5a4a5acdd98632ef1ba005565 (diff)
downloaddoc-120405ef5252ef8f0619899e839eca4faf6f1a34.tar.gz
doc-120405ef5252ef8f0619899e839eca4faf6f1a34.zip
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
Notes
Notes: svn path=/head/; revision=54360
Diffstat (limited to 'en_US.ISO8859-1/books/handbook')
-rw-r--r--en_US.ISO8859-1/books/handbook/jails/chapter.xml25
1 files changed, 25 insertions, 0 deletions
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>