From nobody Mon Dec 05 19:32:09 2022 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 4NQtwT5jW8z4jHsB for ; Mon, 5 Dec 2022 19:32:09 +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 4NQtwT4tgDz3LGR; Mon, 5 Dec 2022 19:32:09 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1670268729; 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=t8d2IPlpI1z9BjQuyMam0uGnkyOjPw7zUdglpIXb7q0=; b=KkNdfniRUaK3T0X4z7T+Yc32N1m7+iiX2QcHCrjb5vDVW+vh4E1b64VcQa886aKLli4DZo ZvCVRyqJInjtENdDWlqhflpnJoxFX7HlixFmvQ1xD4t1mcwC895GksxpgPcZfNJL0m16ih tVVZ6a1X/PmaKGEprwx4+9P6GV/hODQQ72TDKPir988TmLtkW0x+o9UfHCjH6LITaNuvuj 83t+3Rc42dXByID/lq/ipoCuhERZElYG87UymSCHvDv4zZrIvEUE4j2Luyj4HRhuymNvg7 W3sKIK0Vo+yhdnWUArrS0sxx9APe4S83lRYPE1QWhO24w+CfeIKgsERoVgORiA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1670268729; 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=t8d2IPlpI1z9BjQuyMam0uGnkyOjPw7zUdglpIXb7q0=; b=PsOBKh4+bHwxByjELK0jYZR6jqRD5Ta3/gJrymCT7zefTlBJr21ofvEh7t0qg3Ai9rFS6H 4/PFEmluGY9Q83JrTgvoD4TQFDtUjqkfX8wLwwj12GwKGeJlEEjblxxi+IrqipKQ35O2YG LP0WU5w28ytGOlnwwyU6c8YLkedBEGxlSw38cYPqGgcNxYx4HSomLbQ7ujP59AnHalyz06 Xh/kbofP0vo7nXTEsT7/jNivDChRjLPxanfGNMRGLHcPN6VNI47Vi4zw+w4MIW8PUjQAba bqrqsYhYSIUDh0ifile5K0eo+PYh7OOqa01bumULsgAfUUeYWX4SKArXBETncA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1670268729; a=rsa-sha256; cv=none; b=JGFe7Q+ErwHmgY45UefvtDgrhkL2IvEZHN5QyyAR8+Qxb6LICYfcFkEGeRVFxGUfmP1e9p wYjPo3puQqgQ+8hEU8a9aTk+yeh40NEnsZqS5LOU5+evramEe5EjYdQ/+dOHDiwJk+Wlga SmM6M0Mw2o2/w+Un5pWfjlL/QOUVDy1Q8EeJjKjYUSMod95zP0tEK5UJnlTbzyBYqZStJI Gl3L74mTeNB7dg9dxaICMQAUVXQ4bPeMHDkG7+ISAjWpFmOedjg/zXTPWTv9euZtJNFdKy shDPZCBg0fJZHJCYjA3bdEjyYqOE7wAYde5MBx+GkREMoh0kkyW9pkI0u27EQw== 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 4NQtwT3Vvsz18JK; Mon, 5 Dec 2022 19:32:09 +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 2B5JW9Sk096319; Mon, 5 Dec 2022 19:32:09 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 2B5JW9MI096318; Mon, 5 Dec 2022 19:32:09 GMT (envelope-from git) Date: Mon, 5 Dec 2022 19:32:09 GMT Message-Id: <202212051932.2B5JW9MI096318@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Glen Barber Subject: git: a672477848 - main - release: add installation page 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: a672477848e8209223bd7e496cefddc8a4c8ed0e Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by gjb: URL: https://cgit.FreeBSD.org/doc/commit/?id=a672477848e8209223bd7e496cefddc8a4c8ed0e commit a672477848e8209223bd7e496cefddc8a4c8ed0e Author: Glen Barber AuthorDate: 2022-12-05 18:42:25 +0000 Commit: Glen Barber CommitDate: 2022-12-05 18:42:25 +0000 release: add installation page Sponsored by: Rubicon Communications, LLC ("Netgate") --- .../content/en/releases/12.4R/installation.adoc | 84 ++++++++++++++++++++++ 1 file changed, 84 insertions(+) diff --git a/website/content/en/releases/12.4R/installation.adoc b/website/content/en/releases/12.4R/installation.adoc new file mode 100644 index 0000000000..7a195a8980 --- /dev/null +++ b/website/content/en/releases/12.4R/installation.adoc @@ -0,0 +1,84 @@ +--- +title: "FreeBSD 12.4-RELEASE Installation Instructions" +sidenav: download +--- + +:releaseCurrent: 12.4-RELEASE +:localRel: 12.4 + += 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 12.3-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.4-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 +----