git: c9c99a3f1b - main - 12.3: add installation.adoc

The branch main has been updated by gjb:

URL: https://cgit.FreeBSD.org/doc/commit/?id=c9c99a3f1b59c635f3776df68dea142f5356b784

commit c9c99a3f1b59c635f3776df68dea142f5356b784
Author:     Glen Barber <[email protected]>
AuthorDate: 2021-12-07 15:27:56 +0000
Commit:     Glen Barber <[email protected]>
CommitDate: 2021-12-07 15:27:56 +0000

    12.3: add installation.adoc
    
    Sponsored by:   Rubicon Communications, LLC ("Netgate")
---
 .../content/en/releases/12.3R/installation.adoc    | 84 ++++++++++++++++++++++
 1 file changed, 84 insertions(+)

diff --git a/website/content/en/releases/12.3R/installation.adoc b/website/content/en/releases/12.3R/installation.adoc
new file mode 100644
index 0000000000..c409e052b8
--- /dev/null
+++ b/website/content/en/releases/12.3R/installation.adoc
@@ -0,0 +1,84 @@
+---
+title: "FreeBSD 12.3-RELEASE Installation Instructions"
+sidenav: download
+---
+
+:releaseCurrent: 12.3-RELEASE
+:localRel: 12.3
+
+= FreeBSD {localRel}-RELEASE 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>>
+* <<upgrade,Upgrading FreeBSD>>
+
+[[install]]
+== Installing FreeBSD
+
+The 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 upgrading section in the Release Notes for notable incompatibilities carefully.
+
+[[upgrade-source]]
+== Upgrading from Source
+
+The procedure for doing a source code based update is described in Updating FreeBSD from Source.
+
+For SVN 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 {{< manpage "freebsd-update" "8">}} utility supports binary upgrades of i386 and amd64 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 {{< manpage "freebsd-update" "8">}} utility can fetch bits belonging to {releaseCurrent}. During this process {{< manpage "freebsd-update" "8">}} will ask for help in merging configuration files.
+
+[.screen]
+----
+# freebsd-update upgrade -r 12.3-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, {{< manpage "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 {{< manpage "freebsd-update" "8">}} to rebuild all third-party applications (e.g., ports installed from the ports tree) due to updates in system libraries.
+
+After updating installed third-party applications (and again, only if {{< manpage "freebsd-update" "8">}} printed a message indicating that this was necessary), run {{< manpage "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
+----