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
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
|
<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V5.0-Based Extension//EN"
"../../../share/xml/freebsd50.dtd" [
<!ENTITY % release PUBLIC "-//FreeBSD//ENTITIES Release Specification//EN" "release.ent">
%release;
<!ENTITY local.rel "10.3">
]>
<article xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
xml:id="top">
<info><title>&os; &release.current; Installation Instructions</title>
<author><orgname>The &os; Project</orgname></author>
<pubdate>$FreeBSD$</pubdate>
<copyright>
<year>2016</year>
<holder role="mailto:doc@FreeBSD.org">The &os; Documentation Project</holder>
</copyright>
<legalnotice xml:id="trademarks" role="trademarks">
&tm-attrib.freebsd;
&tm-attrib.intel;
&tm-attrib.sparc;
&tm-attrib.general;
</legalnotice>
<abstract>
<para>This article gives some brief instructions on installing
&os; &release.current; and upgrading the systems running earlier
releases.</para>
</abstract>
</info>
<sect1 xml:id="install">
<title>Installing &os;</title>
<para>The <uri
xlink:href="&url.books.handbook;/bsdinstall.html">Installing
&os;</uri>
chapter of the <uri
xlink:href="&url.books.handbook;/">&os;
Handbook</uri> provides more in-depth information about the
installation program itself, including a guided walk-through with
screenshots.</para>
</sect1>
<sect1 xml:id="upgrade">
<title>Upgrading &os;</title>
<para>If you are upgrading from a previous release of &os;, please
read <uri
xlink:href="http://www.FreeBSD.org/releases/&local.rel;R/relnotes.html#upgrade">upgrading
section in the Release Notes</uri> for notable
incompatibilities carefully.</para>
<sect2 xml:id="upgrade-source">
<title>Upgrading from Source</title>
<para>The procedure for doing a source code based update is
described in
<uri xlink:href="&url.books.handbook;/synching.html"></uri> and
<uri xlink:href="&url.books.handbook;/makeworld.html"></uri>.</para>
<para>For SVN use the <filename>releng/&local.rel;</filename> branch
which will be where any upcoming Security Advisories or Errata
Notices will be applied.</para>
</sect2>
<sect2 xml:id="upgrade-binary">
<title>Upgrading Using <quote>&os; Update</quote></title>
<para>The &man.freebsd-update.8; utility supports binary
upgrades of &arch.i386; and &arch.amd64; systems running
earlier FreeBSD releases. Systems running
<literal>9.3-RELEASE</literal>,
<literal>10.3-RC[12]</literal> can upgrade as follows:</para>
<screen>&prompt.root; freebsd-update fetch
&prompt.root; freebsd-update install</screen>
<para>Now the &man.freebsd-update.8; utility can fetch bits
belonging to &release.current;. During this process
&man.freebsd-update.8; will ask for help in merging
configuration files.</para>
<screen>&prompt.root; freebsd-update upgrade -r &local.rel;-RELEASE</screen>
<para>Due to changes in the way that &os; is packaged on the
release media, two complications may arise in this process if
upgrading from FreeBSD 9.3:</para>
<orderedlist>
<listitem>
<para>The &os;, which previously could appear in either
<filename>/boot/kernel</filename> or
<filename>/boot/GENERIC</filename>, now only appears as
<filename>/boot/kernel</filename>. As a result, any
kernel appearing in <filename>/boot/GENERIC</filename>
will be deleted. Please carefully read the output printed
by &man.freebsd-update.8; and confirm that an updated
kernel will be placed into
<filename>/boot/kernel</filename> before proceeding beyond
this point.</para>
</listitem>
<listitem>
<para>The &os; source tree in <filename>/usr/src</filename>
(if present) will be deleted. (Normally the
&man.freebsd-update.8; utility will update a source tree,
but in this case the changes in release packaging result
in the &man.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
&os;.)</para>
</listitem>
</orderedlist>
<screen>&prompt.root; freebsd-update install</screen>
<para>The system must now be rebooted with the newly installed
kernel before the non-kernel components are updated.</para>
<screen>&prompt.root; shutdown -r now</screen>
<para>After rebooting, &man.freebsd-update.8; needs to be run
again to install the new userland components:</para>
<screen>&prompt.root; freebsd-update install</screen>
<para>At this point, users of systems being upgraded from &os;
9.3-RELEASE or earlier will be prompted by
&man.freebsd-update.8; to rebuild all third-party applications
(e.g., ports installed from the ports tree) due to updates in
system libraries.</para>
<para>After updating installed third-party applications (and
again, only if &man.freebsd-update.8; printed a message
indicating that this was necessary), run
&man.freebsd-update.8; again so that it can delete the old (no
longer used) system libraries:</para>
<screen>&prompt.root; freebsd-update install</screen>
<para>Finally, reboot into &release.current;</para>
<screen>&prompt.root; shutdown -r now</screen>
</sect2>
</sect1>
</article>
|