Date: Fri, 17 Jul 2020 21:26:19 +0000 (UTC) From: Gordon Bergling <gbe@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r54360 - head/en_US.ISO8859-1/books/handbook/jails Message-ID: <202007172126.06HLQJrj001271@repo.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: gbe Date: Fri Jul 17 21:26:19 2020 New Revision: 54360 URL: https://svnweb.freebsd.org/changeset/doc/54360 Log: 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 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 Jul 17 20:49:36 2020 (r54359) +++ head/en_US.ISO8859-1/books/handbook/jails/chapter.xml Fri Jul 17 21:26:19 2020 (r54360) @@ -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>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?202007172126.06HLQJrj001271>