aboutsummaryrefslogtreecommitdiff
path: root/website/content/en/releases/14.0R/installation.adoc
blob: d35ef093607b8383cb2efea9956a2a7f09c3364d (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
---
title: "FreeBSD 14.0-RELEASE Installation Instructions"
sidenav: download
---

:releaseCurrent: 14.0-RELEASE
:localRel: 14.0

include::shared/en/urls.adoc[]

= 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 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 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 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 {{< manpage "freebsd-update" "8">}} utility supports binary upgrades of amd64, arm64, and i386 systems running earlier FreeBSD releases.

[.warning]
*Warning*: +
After upgrading, it is not possible to use `freebsd-update rollback` to return to 12.4-RELEASE or 13.2-RELEASE.

Systems running 12.4-RELEASE or 13.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 or reinstall all third-party applications (e.g., ports installed from the ports tree or packages installed by {{< manpage "pkg" "8">}}) 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
----