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
This commit is contained in:
Gordon Bergling 2020-07-17 21:26:19 +00:00
parent 55080708d5
commit 120405ef52
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=54360

View file

@ -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>