aboutsummaryrefslogtreecommitdiff
path: root/website/content/en/releases/10.4R/installation.adoc
blob: 47dd2c2fd3cf3e33fd5b802802fba233d0d49370 (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
93
---
title: "FreeBSD 10.4-RELEASE Installation Instructions"
sidenav: download
---

= FreeBSD 10.4-RELEASE Installation Instructions

== Abstract

This article gives some brief instructions on installing FreeBSD 10.4-RELEASE and upgrading the systems running earlier releases.

== Table of Contents

* <<install,Installing FreeBSD>>
* <<upgrade,Upgrading FreeBSD>>
** <<upgrade-source,Upgrading from Source>>
** <<upgrade-binary,Upgrading Using "FreeBSD Update">>

[[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]]
== upgrade-source

The procedure for doing a source code based update is described in `Synchronizing Source` and `Rebuilding world`.

For SVN use the `releng/10.4` branch which will be where any upcoming Security Advisories or Errata Notices will be applied.

[[upgrade-binary]]
== Upgrading Using "FreeBSD Update"

The https://www.FreeBSD.org/cgi/man.cgi?query=freebsd-update&sektion=8&manpath=freebsd-release-ports[freebsd-update(8)] utility supports binary upgrades of i386 and amd64 systems running earlier FreeBSD releases. Systems running `10.3-RELEASE`, `10.4-RC[12]` can upgrade as follows:

[.screen]
----
# freebsd-update fetch
# freebsd-update install
----

Now the http://www.FreeBSD.org/cgi/man.cgi?query=freebsd-update&sektion=8[freebsd-update(8)] utility can fetch bits belonging to 10.4-RELEASE. During this process http://www.FreeBSD.org/cgi/man.cgi?query=freebsd-update&sektion=8[freebsd-update(8)] will ask for help in merging configuration files.

[.screen]
----
# freebsd-update upgrade -r 10.4-RELEASE
----

Due to changes in the way that FreeBSD is packaged on the release media, two complications may arise in this process if upgrading from FreeBSD 9.3:

[arabic]
. The FreeBSD, which previously could appear in either `/boot/kernel` or `/boot/GENERIC`, now only appears as `/boot/kernel`. As a result, any kernel appearing in `/boot/GENERIC` will be deleted. Please carefully read the output printed by http://www.FreeBSD.org/cgi/man.cgi?query=freebsd-update&sektion=8[freebsd-update(8)] and confirm that an updated kernel will be placed into `/boot/kernel` before proceeding beyond this point.
. The FreeBSD source tree in `/usr/src` (if present) will be deleted. (Normally the http://www.FreeBSD.org/cgi/man.cgi?query=freebsd-update&sektion=8[freebsd-update(8)] utility will update a source tree, but in this case the changes in release packaging result in the http://www.FreeBSD.org/cgi/man.cgi?query=freebsd-update&sektion=8[freebsd-update(8)] utility not recognizing that the source tree from the old release and the source tree from the new release correspond to the same part of FreeBSD.)

[.screen]
----
# 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, http://www.FreeBSD.org/cgi/man.cgi?query=freebsd-update&sektion=8[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 FreeBSD 9.3-RELEASE or earlier will be prompted by http://www.FreeBSD.org/cgi/man.cgi?query=freebsd-update&sektion=8[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 http://www.FreeBSD.org/cgi/man.cgi?query=freebsd-update&sektion=8[freebsd-update(8)] printed a message indicating that this was necessary), run http://www.FreeBSD.org/cgi/man.cgi?query=freebsd-update&sektion=8[freebsd-update(8)] again so that it can delete the old (no longer used) system libraries:

[.screen]
----
# freebsd-update install
----

Finally, reboot into 10.4-RELEASE

[.screen]
----
# shutdown -r now
----