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">
6%release;
7<!ENTITY local.rel "11.1">
8]>
9
10<article xmlns="http://docbook.org/ns/docbook"
11  xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
12  xml:id="top">
13
14  <info>
15    <title>&os; &release.current; Installation
16      Instructions</title>
17
18    <author>
19      <orgname>The &os; Project</orgname>
20    </author>
21
22    <pubdate>$FreeBSD: stable/11/release/doc/en_US.ISO8859-1/installation/article.xml 333727 2018-05-17 15:53:37Z gjb $</pubdate>
23
24    <copyright>
25      <year>2018</year>
26      <holder role="mailto:doc@FreeBSD.org">The &os; Documentation
27	Project</holder>
28    </copyright>
29
30    <legalnotice xml:id="trademarks" role="trademarks">
31      &tm-attrib.freebsd;
32      &tm-attrib.intel;
33      &tm-attrib.sparc;
34      &tm-attrib.general;
35    </legalnotice>
36
37    <abstract>
38      <para>This article gives some brief instructions on installing
39	&os; &release.current; and upgrading the systems running
40	earlier releases.</para>
41    </abstract>
42  </info>
43
44  <sect1 xml:id="install">
45    <title>Installing &os;</title>
46
47    <para>The <uri
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
53      screenshots.</para>
54  </sect1>
55
56  <sect1 xml:id="upgrade">
57    <title>Upgrading &os;</title>
58
59    <para>If you are upgrading from a previous release of &os;, please
60      read <uri
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>
64
65    <sect2 xml:id="upgrade-source">
66      <title>Upgrading from Source</title>
67
68      <para>The procedure for doing a source code based update is
69	described in <uri
70	  xlink:href="&url.books.handbook;/synching.html"></uri> and
71	<uri
72	  xlink:href="&url.books.handbook;/makeworld.html"></uri>.</para>
73
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>
77    </sect2>
78
79    <sect2 xml:id="upgrade-binary">
80      <title>Upgrading Using <quote>&os; Update</quote></title>
81
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>
87
88      <screen>&prompt.root; freebsd-update fetch
89&prompt.root; freebsd-update install</screen>
90
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>
95
96      <screen>&prompt.root; freebsd-update upgrade -r &local.rel;-RELEASE</screen>
97
98      <screen>&prompt.root; freebsd-update install</screen>
99
100      <para>The system must now be rebooted with the newly installed
101	kernel before the non-kernel components are updated.</para>
102
103      <screen>&prompt.root; shutdown -r now</screen>
104
105      <para>After rebooting, &man.freebsd-update.8; needs to be run
106	again to install the new userland components:</para>
107
108      <screen>&prompt.root; freebsd-update install</screen>
109
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>
115
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>
121
122      <screen>&prompt.root; freebsd-update install</screen>
123
124      <para>Finally, reboot into &release.current;</para>
125
126      <screen>&prompt.root; shutdown -r now</screen>
127    </sect2>
128  </sect1>
129</article>
130