article.xml revision 259806 
1<?xml version="1.0" encoding="iso-8859-1"?>
2<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V5.0-Based Extension//EN"
3        "../../../share/xml/freebsd50.dtd" [
4<!ENTITY % release PUBLIC "-//FreeBSD//ENTITIES Release Specification//EN" "release.ent">
5%release;
6]>
7
8<article xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0">
9  <info><title>&os; &release.current; Installation Instructions</title>
10
11    <author><orgname>The &os; Project</orgname></author>
12
13    <pubdate>$FreeBSD: releng/10.0/release/doc/en_US.ISO8859-1/installation/article.xml 259806 2013-12-24 04:15:48Z gjb $</pubdate>
14
15    <copyright>
16      <year>2013</year>
17      <holder role="mailto:doc@FreeBSD.org">The &os; Documentation Project</holder>
18    </copyright>
19
20    <legalnotice xml:id="trademarks" role="trademarks">
21      &tm-attrib.freebsd;
22      &tm-attrib.intel;
23      &tm-attrib.sparc;
24      &tm-attrib.general;
25    </legalnotice>
26
27  <abstract>
28    <para>This article gives some brief instructions on installing
29      &os; &release.current; and upgrading the systems running earlier
30      releases.</para>
31  </abstract>
32</info>
33
34  <sect1 xml:id="install">
35    <title>Installing &os;</title>
36
37    <para>The <uri
38	xlink:href="&url.books.handbook;/bsdinstall.html">Installing
39	  &os;</uri>
40      chapter of the <uri
41	xlink:href="&url.books.handbook;/">&os;
42	Handbook</uri> provides more in-depth information about the
43      installation program itself, including a guided walk-through with
44      screenshots.</para>
45  </sect1>
46
47  <sect1 xml:id="upgrade">
48    <title>Upgrading &os;</title>
49
50    <para>If you are upgrading from a previous release of &os;, please
51      read <uri
52      xlink:href="http://www.FreeBSD.org/releases/10.0R/relnotes.html#upgrade">upgrading
53      section in the Release Notes</uri> for notable
54      incompatibilities carefully.</para>
55
56    <sect2>
57      <title>Upgrading from Source</title>
58
59      <para>The procedure for doing a source code based update is
60	described in
61	<uri xlink:href="&url.books.handbook;/synching.html"></uri> and
62	<uri xlink:href="&url.books.handbook;/makeworld.html"></uri>.</para>
63
64      <para>For SVN use the <filename>releng/10.0</filename> branch
65	which will be where any upcoming Security Advisories or Errata
66	Notices will be applied.</para>
67    </sect2>
68
69    <sect2>
70      <title>Upgrading Using <quote>&os; Update</quote></title>
71
72      <para>The &man.freebsd-update.8; utility supports binary
73	upgrades of &arch.i386; and &arch.amd64; systems running
74	earlier FreeBSD releases. Systems running
75	<literal>7.[34]-RELEASE</literal>,
76	<literal>8.[1234]-RELEASE</literal>,
77	<literal>9.[012]-RELEASE</literal>,
78	<literal>10.0-RC[123]</literal> can upgrade as follows:</para>
79
80      <screen>&prompt.root; freebsd-update fetch
81&prompt.root; freebsd-update install</screen>
82
83      <para>Now the &man.freebsd-update.8; utility can fetch bits
84	belonging to &release.current;.  During this process
85	&man.freebsd-update.8; will ask for help in merging
86	configuration files.</para>
87
88      <screen>&prompt.root; freebsd-update upgrade -r 10.0-RELEASE</screen>
89
90      <para>Due to changes in the way that &os; is packaged on the
91	release media, two complications may arise in this process if
92	upgrading from FreeBSD 8.x or 9.x:</para>
93
94      <orderedlist>
95	<listitem>
96	  <para>The &os;, which previously could appear in either
97	    <filename>/boot/kernel</filename> or
98	    <filename>/boot/GENERIC</filename>, now only appears as
99	    <filename>/boot/kernel</filename>.  As a result, any
100	    kernel appearing in <filename>/boot/GENERIC</filename>
101	    will be deleted.  Please carefully read the output printed
102	    by &man.freebsd-update.8; and confirm that an updated
103	    kernel will be placed into
104	    <filename>/boot/kernel</filename> before proceeding beyond
105	    this point.</para>
106	</listitem>
107
108	<listitem>
109	  <para>The &os; source tree in <filename>/usr/src</filename>
110	    (if present) will be deleted.  (Normally the
111	    &man.freebsd-update.8; utility will update a source tree,
112	    but in this case the changes in release packaging result
113	    in the &man.freebsd-update.8; utility not recognizing that
114	    the source tree from the old release and the source tree
115	    from the new release correspond to the same part of
116	    &os;.)</para>
117	</listitem>
118      </orderedlist>
119
120      <screen>&prompt.root; freebsd-update install</screen>
121
122      <para>The system must now be rebooted with the newly installed
123	kernel before the non-kernel components are updated.</para>
124
125      <screen>&prompt.root; shutdown -r now</screen>
126
127      <para>After rebooting, &man.freebsd-update.8; needs to be run
128	again to install the new userland components:</para>
129
130      <screen>&prompt.root; freebsd-update install</screen>
131
132      <para>At this point, users of systems being upgraded from &os;
133	9.2-RELEASE or earlier will be prompted by
134	&man.freebsd-update.8; to rebuild all third-party applications
135	(e.g., ports installed from the ports tree) due to updates in
136	system libraries.</para>
137
138      <para>After updating installed third-party applications (and
139	again, only if &man.freebsd-update.8; printed a message
140	indicating that this was necessary), run
141	&man.freebsd-update.8; again so that it can delete the old (no
142	longer used) system libraries:</para>
143
144      <screen>&prompt.root; freebsd-update install</screen>
145
146      <para>Finally, reboot into &release.current;</para>
147
148      <screen>&prompt.root; shutdown -r now</screen>
149    </sect2>
150  </sect1>
151</article>
152