From nobody Tue Dec 07 21:03:13 2021 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 76C4518DD878 for ; Tue, 7 Dec 2021 21:03:15 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4J7t761NPQz3F6D; Tue, 7 Dec 2021 21:03:14 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id B6A23268D9; Tue, 7 Dec 2021 21:03:13 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 1B7L3DJ5075523; Tue, 7 Dec 2021 21:03:13 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 1B7L3D1S075522; Tue, 7 Dec 2021 21:03:13 GMT (envelope-from git) Date: Tue, 7 Dec 2021 21:03:13 GMT Message-Id: <202112072103.1B7L3D1S075522@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Glen Barber Subject: git: c9c99a3f1b - main - 12.3: add installation.adoc List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: gjb X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: c9c99a3f1b59c635f3776df68dea142f5356b784 Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1638910994; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=EnYfNBjIHrLvMIjsiuLqTr8oNe/w0IXX26C/9quJ/7Q=; b=tcxaLUhS21FYOEeNX7RKZZpev3CqjE0vQhwe64yxCO112e/xZgF1q/DVxRwY6UUbhfJJr1 j29eRT4w+iIUtyP+QBWs/O75jh7TaYhJvWFDtlydfHex9Ok0jbeqD3r7/b9A9DlJS0ekyW JqW6gT6AcxHq6a/G6NrNQWsBTmR2V8Kwbu3Da+sraNpj324z+M+82d0mxggxZh9gtpkY/q rPnFU4pnafxu68ZNmW40OzlvbcEHwoFC/rg+wUeERDtQWZvfEWB47alV6/6Y4x2dlJueYu W7i360UA/8Q5MdzLHWsxG+colYJNak1MOeFdghz25btQsl8wgwESjJZqmfqDnA== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1638910994; a=rsa-sha256; cv=none; b=vxUWkh1fQ+uCd4Oi+QzkE1jeYSDkjIeoVnrUzUPHJ61gqop8UMv/4ff0oS8P/coTQDmUgY O8kUOMRTWF/uOeWuO0wSOVFOEHgURC229syPCbnC7mt8gZJ4GAdXSuA8UD36LBU/vybFHO 46BnC8wVoYQB3xcf1kmrIlekWSRApw8B/oskC3bTwu+gxIlVNl+5WL0zYcbh52HubxosNY hcJOQYAMkhicYR8Qvv4MQbQv1UfvqRY6Y8J2B3IAUVAdTvK6csUplrD49c6RJwmwTEbJ0J J49VfuHO2eGdiQHFqqVt9Yj7sYZmwCLbjMTLLph2UQs/eBygK9jRAWck7KtJiA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by gjb: URL: https://cgit.FreeBSD.org/doc/commit/?id=c9c99a3f1b59c635f3776df68dea142f5356b784 commit c9c99a3f1b59c635f3776df68dea142f5356b784 Author: Glen Barber AuthorDate: 2021-12-07 15:27:56 +0000 Commit: Glen Barber 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 + +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 +----