diff --git a/website/archetypes/release/installation.adoc b/website/archetypes/release/installation.adoc index aa8fbf487c..c89fb58eeb 100644 --- a/website/archetypes/release/installation.adoc +++ b/website/archetypes/release/installation.adoc @@ -1,90 +1,88 @@ --- title: "FreeBSD X.0-RELEASE Installation Instructions" sidenav: download --- :releaseCurrent: X.0-RELEASE :localRel: X.0 include::shared/en/urls.adoc[] = FreeBSD {localRel}-RELEASE Installation Instructions -FreeBSD {releaseCurrent} Installation Instructions - == Abstract This article gives some brief instructions on installing FreeBSD {releaseCurrent} and upgrading the systems running earlier releases. == Table of Contents * <> * <> [[install]] == Installing FreeBSD The link:{handbook}bsdinstall/[Installing FreeBSD] chapter of the FreeBSD Handbook provides more in-depth information about the installation program itself, including a guided walk-through with screenshots. [[upgrade]] == Upgrading FreeBSD If you are upgrading from a previous release of FreeBSD, please read the upgrading section in the link:../relnotes[Release Notes] for notable incompatibilities carefully. [[upgrade-source]] == Upgrading from Source The procedure for doing a source code based update is described in link:{handbook}cutting-edge/#makeworld[Updating FreeBSD from Source]. For Git use the releng/{localRel} branch which will be where any upcoming Security Advisories or Errata Notices will be applied. [[upgrade-binary]] == Upgrading Using "FreeBSD Update" The man:freebsd-update[8] utility supports binary upgrades of amd64, arm64, and i386 systems running earlier FreeBSD releases. Systems running 11.4-RELEASE or 12.2-RELEASE can upgrade as follows: [.screen] ---- # freebsd-update fetch # freebsd-update install ---- Now the man:freebsd-update[8] utility can fetch bits belonging to {releaseCurrent}. During this process man:freebsd-update[8] will ask for help in merging configuration files. [.screen,subs="verbatim,attributes"] ---- # freebsd-update upgrade -r {localRel}-RELEASE # freebsd-update install ---- The system must now be rebooted with the newly installed kernel before the non-kernel components are updated. [.screen] ---- # shutdown -r now ---- After rebooting, man:freebsd-update[8] needs to be run again to install the new userland components: [.screen] ---- # freebsd-update install ---- At this point, users of systems being upgraded from earlier FreeBSD releases will be prompted by man:freebsd-update[8] to rebuild or reinstall all third-party applications (e.g., ports installed from the ports tree or packages installed by man:pkg[8]) due to updates in system libraries. After updating installed third-party applications (and again, only if man:freebsd-update[8] printed a message indicating that this was necessary), run man:freebsd-update[8] again so that it can delete the old (no longer used) system libraries: [.screen] ---- # freebsd-update install ---- Finally, reboot into {releaseCurrent} [.screen] ---- # shutdown -r now ----