Date: Fri, 26 Jun 2026 07:59:07 +0000 From: Alexander Ziaee <ziaee@FreeBSD.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org Cc: Lexi Winter <ivy@FreeBSD.org> Subject: git: d9b67188b5 - main - 15.1: Improve upgrade instructions Message-ID: <6a3e314b.19cb5.2830ab1@gitrepo.freebsd.org>
index | next in thread | raw e-mail
The branch main has been updated by ziaee: URL: https://cgit.FreeBSD.org/doc/commit/?id=d9b67188b5ea2be67e355bb57494d5bceb61bd46 commit d9b67188b5ea2be67e355bb57494d5bceb61bd46 Author: Lexi Winter <ivy@FreeBSD.org> AuthorDate: 2026-06-26 07:47:17 +0000 Commit: Alexander Ziaee <ziaee@FreeBSD.org> CommitDate: 2026-06-26 07:52:51 +0000 15.1: Improve upgrade instructions - Upgrading 14.x pkgbase to 15 is not supported - Upgrading pkg to upgrade the base system is not required - Third party kmods must only be upgraded if using them Reported by: markj (efi case varies, bectl is zfs only) Co-authored-by: Alexander Ziaee <ziaee@FreeBSD.org> Differential Revision: https://reviews.freebsd.org/D57606 --- website/content/en/releases/15.1R/upgrading.adoc | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/website/content/en/releases/15.1R/upgrading.adoc b/website/content/en/releases/15.1R/upgrading.adoc index 7588186f71..116d4fb437 100644 --- a/website/content/en/releases/15.1R/upgrading.adoc +++ b/website/content/en/releases/15.1R/upgrading.adoc @@ -118,11 +118,11 @@ Continue to <<upgrade-loader-uefi>> or <<upgrade-loader-bios>> below. == Upgrading with Base System Packages Systems deployed with a packaged base system are upgraded via man:pkg[8]. -Systems running {releasePrevLegacy} or {releasePrev} can be upgraded as follows: +Systems running {releasePrev} can be upgraded as follows: . **Snapshot the Current Installation** + -Take a recursive snapshot of the functioning system named with the current date: +If booting from ZFS, take a recursive snapshot of the functioning system named with the current date: + [source,shell,subs="verbatim,attributes"] ---- @@ -131,11 +131,13 @@ bectl create -r pre-{localRel} + The boot loader offers a menu to boot from this if the upgrade needs to be rolled back. + -. **Upgrade the Package Manager** +. **Upgrade the Installed System** ++ +Before upgrading to a new release, ensure the installed system is up to date: + [source,shell] ---- -pkg upgrade -yr FreeBSD-ports pkg +pkg upgrade -r FreeBSD-base ---- + . **Upgrade the Base System** @@ -151,7 +153,7 @@ Follow those instructions as needed. + . **Upgrade Third‑party Kernel Modules** + -Third party kernel modules must also be upgraded with the base system: +If third party kernel modules are installed, they must also be upgraded with the base system: + [source,shell] ---- @@ -226,7 +228,7 @@ cp /boot/loader.efi /boot/efi/efi/freebsd/loader.efi cp /boot/loader.efi /boot/efi/efi/boot/bootx64.efi ---- + -Note that some installations may not have `freebsd/loader.efi`. +Note that some installations may have reversed case (e.g. `EFI/BOOT/BOOTX64.EFI`) or may not have `freebsd/loader.efi`. + For AArch64 systems, execute the following commands instead: +home | help
Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?6a3e314b.19cb5.2830ab1>