From nobody Mon May 16 20:22:24 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 CD6B71AD6F07 for ; Mon, 16 May 2022 20:22:25 +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 4L29f92W1Pz50vV; Mon, 16 May 2022 20:22:25 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1652732545; 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=Lj6gz0C4c9vZ3O6f4hh81xNIFsXEqDobO70AqRULcqI=; b=qIGic/45BQ0tgz7fWP72Qb++tZc+68Ku/7SIpK68wfqJak3kxtNFFvJV/Az0KkMp2JyzAp rN8e+kgSa4rPxuF4KHev4KKkRwxFAYJbxgfgvQmygA7ZLVTIObA/+9hJChStMASEiQCapE bBVeCzmbdHBUb/qlPjoTt7oIHmWNo210Vdtbr0FSEh5oUlPJAg1N9sDESV0mces5Zpw45o VUheE4n0mqpZSYseZagkL3IFbVjZqFqu5EgyMaUZeE4TyLsnV2HQdWMt/gEEEeiMnPcLul byBc8/KmZeHsWa92Gg9KJ/Tgu82a1m2EYXaS19lyBriwshLbMQsHwufdA3rgOQ== 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 CF66826BC5; Mon, 16 May 2022 20:22:24 +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 24GKMOwx013079; Mon, 16 May 2022 20:22:24 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 24GKMOxf013078; Mon, 16 May 2022 20:22:24 GMT (envelope-from git) Date: Mon, 16 May 2022 20:22:24 GMT Message-Id: <202205162022.24GKMOxf013078@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Glen Barber Subject: git: c6d8953ecb - main - 13.1: add installation 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: c6d8953ecb53bd76b35bd30ef4a0e8b214bc81d7 Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1652732545; 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=Lj6gz0C4c9vZ3O6f4hh81xNIFsXEqDobO70AqRULcqI=; b=qfimpV/MLGlXJMq6QllmkJCUFR6/+QvEZtHh3FSM/23JfSTujTz1vjH04jVod/eajsyFiV /KnbCuSdPftVuUMIDTA1L22zG+F5HHCq22oMcRbGNXkYks5TdYSuGMOzRTVIF3vrop72DM mYCYD/3p1gW/0HX7nJnb5s+0+4uumWxjKqfS0JiCIbIlm5AU7Nuuy8uwAY2/aCELzJA+Pk fz2nXgZ8XjWo0fMQoPA3/j8ggs/S5OKqjQHkQy4FhiBAVcrDWKZjv54z/2JF93y5kMdv4e qtXFcFQfN+QrDf3Zvz3fMWHJd1BkISbkGghoFyANzlHa/JccnkWVfnMhrC65aA== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1652732545; a=rsa-sha256; cv=none; b=nQmhkBX7k/iiyWv4LhSfzNlSBwXNWnN/gX0RLa+g0Ae59FTWxQjZtZ1/AdVlk7TvGvVf8B 7na6TgH8J+EpqlH7nmwU7mjY03sYZUhAB5gZiSNVVUWlPAGVCOzxrf/JbBXcPUXtfHlIvP En7n4o4ySfaVpWS2sfRkCKWG3aJa8d0A+n7zr2hPlAun9c+VeIijx2j5c+tBS/vx8RwPM1 mT7kE1trFKi2IUZaMg5/MXi0Wm1DA9G1eQkMXCzsbqrafSER3f0WlC6qxTlnoZ0GDc/oAV fenqZluzHzb13IRoE8hVsjqBDLGxNe5F0nLCVDJLdt1Sv6ud/2q+IT/DdVovvg== 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=c6d8953ecb53bd76b35bd30ef4a0e8b214bc81d7 commit c6d8953ecb53bd76b35bd30ef4a0e8b214bc81d7 Author: Glen Barber AuthorDate: 2022-05-16 20:20:10 +0000 Commit: Glen Barber CommitDate: 2022-05-16 20:20:10 +0000 13.1: add installation Sponsored by: Rubicon Communications, LLC ("Netgate") --- .../content/en/releases/13.1R/installation.adoc | 84 ++++++++++++++++++++++ 1 file changed, 84 insertions(+) diff --git a/website/content/en/releases/13.1R/installation.adoc b/website/content/en/releases/13.1R/installation.adoc new file mode 100644 index 0000000000..37f2abcdd7 --- /dev/null +++ b/website/content/en/releases/13.1R/installation.adoc @@ -0,0 +1,84 @@ +--- +title: "FreeBSD 13.1-RELEASE Installation Instructions" +sidenav: download +--- + +:releaseCurrent: 13.1-RELEASE +:localRel: 13.1 + += 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 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 {{< 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,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, {{< 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 +----