1 <?xml version="1.0" encoding="iso-8859-1"?>
2 <!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V5.0-Based Extension//EN"
3 "http://www.FreeBSD.org/XML/share/xml/freebsd50.dtd" [
4 <!ENTITY % release PUBLIC "-//FreeBSD//ENTITIES Release Specification//EN"
5 "http://www.FreeBSD.org/release/XML/share/xml/release.ent">
7 <!ENTITY local.rel "11.2">
10 <article xmlns="http://docbook.org/ns/docbook"
11 xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
15 <title>&os; &release.current; Installation
19 <orgname>The &os; Project</orgname>
22 <pubdate>$FreeBSD$</pubdate>
26 <holder role="mailto:doc@FreeBSD.org">The &os; Documentation
30 <legalnotice xml:id="trademarks" role="trademarks">
38 <para>This article gives some brief instructions on installing
39 &os; &release.current; and upgrading the systems running
40 earlier releases.</para>
44 <sect1 xml:id="install">
45 <title>Installing &os;</title>
48 xlink:href="&url.books.handbook;/bsdinstall.html">Installing
49 &os;</uri> chapter of the <uri
50 xlink:href="&url.books.handbook;/">&os; Handbook</uri>
51 provides more in-depth information about the installation
52 program itself, including a guided walk-through with
56 <sect1 xml:id="upgrade">
57 <title>Upgrading &os;</title>
59 <para>If you are upgrading from a previous release of &os;, please
61 xlink:href="http://www.FreeBSD.org/releases/&local.rel;R/relnotes.html#upgrade">upgrading
62 section in the Release Notes</uri> for notable
63 incompatibilities carefully.</para>
65 <sect2 xml:id="upgrade-source">
66 <title>Upgrading from Source</title>
68 <para>The procedure for doing a source code based update is
70 xlink:href="&url.books.handbook;/synching.html"></uri> and
72 xlink:href="&url.books.handbook;/makeworld.html"></uri>.</para>
74 <para>For SVN use the <filename>releng/&local.rel;</filename>
75 branch which will be where any upcoming Security Advisories or
76 Errata Notices will be applied.</para>
79 <sect2 xml:id="upgrade-binary">
80 <title>Upgrading Using <quote>&os; Update</quote></title>
82 <para>The &man.freebsd-update.8; utility supports binary
83 upgrades of &arch.i386; and &arch.amd64; systems running
84 earlier FreeBSD releases. Systems running
85 <literal>10.3-RELEASE</literal>,
86 <literal>11.0-RELEASE</literal> can upgrade as follows:</para>
88 <screen>&prompt.root; freebsd-update fetch
89 &prompt.root; freebsd-update install</screen>
91 <para>Now the &man.freebsd-update.8; utility can fetch bits
92 belonging to &release.current;. During this process
93 &man.freebsd-update.8; will ask for help in merging
94 configuration files.</para>
96 <screen>&prompt.root; freebsd-update upgrade -r &local.rel;-RELEASE</screen>
98 <screen>&prompt.root; freebsd-update install</screen>
100 <para>The system must now be rebooted with the newly installed
101 kernel before the non-kernel components are updated.</para>
103 <screen>&prompt.root; shutdown -r now</screen>
105 <para>After rebooting, &man.freebsd-update.8; needs to be run
106 again to install the new userland components:</para>
108 <screen>&prompt.root; freebsd-update install</screen>
110 <para>At this point, users of systems being upgraded from
111 earlier &os; releases will be prompted by
112 &man.freebsd-update.8; to rebuild all third-party applications
113 (e.g., ports installed from the ports tree) due to updates in
114 system libraries.</para>
116 <para>After updating installed third-party applications (and
117 again, only if &man.freebsd-update.8; printed a message
118 indicating that this was necessary), run
119 &man.freebsd-update.8; again so that it can delete the old (no
120 longer used) system libraries:</para>
122 <screen>&prompt.root; freebsd-update install</screen>
124 <para>Finally, reboot into &release.current;</para>
126 <screen>&prompt.root; shutdown -r now</screen>