diff --git a/website/content/en/releases/15.0R/relnotes.adoc b/website/content/en/releases/15.0R/relnotes.adoc --- a/website/content/en/releases/15.0R/relnotes.adoc +++ b/website/content/en/releases/15.0R/relnotes.adoc @@ -71,21 +71,26 @@ [IMPORTANT] ==== -For users of PRERELEASE, ALPHA, and BETA builds of FreeBSD 15.0, due to late-breaking changes in FreeBSD.org infrastructure, it is not possible to upgrade directly using the man:pkg[8] utility. +Upgrading previous system versions to {localrel} is not yet supported! +Back up _all_ filesystems! ==== -Packaged base system installations require either manually copying the required files from a source tree checkout of the `15.0-RELEASE` tag, or alternatively, force-install the `FreeBSD-pkg-bootstrap` package from the official release base system packages. +Packaged system installations currently require either manually copying configuration from the target source, or re-initializing the package manager using the target repository. -The recommended, and most secure approach, is using the source tree checkout of any of head, stable/15, or releng/15.0 branches after 2025-11-27 22:00 UTC. +The recommended, and most secure approach, is to copy the files from the `releng/15.0` source branch after 2025-11-27 22:00 UTC: +[source,shell] .... # cp /usr/src/usr.sbin/pkg/FreeBSD.conf.quarterly-release \ /etc/pkg/FreeBSD.conf # cp -R /usr/src/share/keys/pkgbase-15 /usr/share/keys/pkgbase-15 .... -Users who do not have up to date sources installed may use a less secure, but simpler approach, validating the checksums after installation. As these are architecture-independent files, the checksums will match on all platforms. The FreeBSD-base package repository will need to be enabled before upgrading via man:pkg[8]: +For the alternative approach, force install the `FreeBSD-pkg-bootstrap` package. +After installation, validate the architecture-independent checksums, which will match on all platforms. +Then, enable the system software repository: +[source,shell] .... # pkg add -f https://pkg.freebsd.org/FreeBSD:15:$(uname -p)/base_release_0/FreeBSD-pkg-bootstrap-15.0.pkg # sha256 -r /etc/pkg/FreeBSD.conf /usr/share/keys/pkg/trusted/pkg.freebsd.org.2013102301 \ @@ -98,6 +103,13 @@ # echo "FreeBSD-base: { enabled: yes }" > /usr/local/etc/pkg/repos/FreeBSD.conf .... +After the repository has been configured using either of these methods, upgrade the system software with the static package manager, specifying the target system version `15`, and the target filesystem mounted at `/mnt/upgrade`: + +[source,shell] +.... +# env ABI=FreeBSD:15:amd64 pkg-static upgrade -r FreeBSD-base +.... + [[upgrade-mk]] === Upgrading from Source