Add the installation.html page, copied from 10.1R and modified to

reflect 10.2-RELEASE, since this file does not exist in the releng/10.2
documentation.

Submitted by:	Tim Bishop
Approved by:	re (implicit)
Sponsored by:	The FreeBSD Foundation
This commit is contained in:
Glen Barber 2015-08-16 12:17:13 +00:00
parent 5592e71f24
commit 1ee030f693
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=47244

View file

@ -0,0 +1,73 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" /><title>FreeBSD 10.2-RELEASE Installation Instructions</title><link rel="stylesheet" type="text/css" href="docbook.css" /><link rev="made" href="doc@FreeBSD.org" /><meta name="generator" content="DocBook XSL Stylesheets V1.78.1" /><meta name="description" content="This article gives some brief instructions on installing FreeBSD 10.2-RELEASE and upgrading the systems running earlier releases." /></head><body><div class="article"><div xmlns="" class="titlepage"><div><div><h1 xmlns="http://www.w3.org/1999/xhtml" class="title"><a id="idp61507280"></a>FreeBSD 10.2-RELEASE Installation Instructions</h1></div><div><div xmlns="http://www.w3.org/1999/xhtml" class="author"><h3 class="author"><span class="orgname">The FreeBSD Project</span></h3></div></div><div><p xmlns="http://www.w3.org/1999/xhtml" class="copyright">Copyright © 2014 The FreeBSD Documentation Project</p></div><div><div xmlns="http://www.w3.org/1999/xhtml" class="legalnotice"><a id="trademarks"></a><p xmlns="http://www.w3.org/TR/xhtml1/transitional">FreeBSD is a registered trademark of
the FreeBSD Foundation. </p><p xmlns="http://www.w3.org/TR/xhtml1/transitional">Intel, Celeron, EtherExpress, i386,
i486, Itanium, Pentium, and Xeon are trademarks or registered
trademarks of Intel Corporation or its subsidiaries in the United
States and other countries. </p><p xmlns="http://www.w3.org/TR/xhtml1/transitional">SPARC, SPARC64, and
UltraSPARC are trademarks of SPARC International, Inc in the United
States and other countries. SPARC International, Inc owns all of the
SPARC trademarks and under licensing agreements allows the proper use
of these trademarks by its members. </p><p xmlns="http://www.w3.org/TR/xhtml1/transitional">Many of the designations used by
manufacturers and sellers to distinguish their products are claimed
as trademarks. Where those designations appear in this document,
and the FreeBSD Project was aware of the trademark claim, the
designations have been followed by the <span xmlns="http://www.w3.org/1999/xhtml" class="quote">&#8220;<span class="quote">&#8482;</span>&#8221;</span> or the
<span xmlns="http://www.w3.org/1999/xhtml" class="quote">&#8220;<span class="quote">®</span>&#8221;</span> symbol. </p></div></div><div><div xmlns="http://www.w3.org/1999/xhtml" class="abstract"><div class="abstract-title">Abstract</div><p xmlns="http://www.w3.org/TR/xhtml1/transitional">This article gives some brief instructions on installing
FreeBSD 10.2-RELEASE and upgrading the systems running earlier
releases. </p></div></div></div><hr /></div><div class="toc"><div class="toc-title">Table of Contents</div><dl class="toc"><dt><span class="sect1"><a href="#install">1. Installing FreeBSD</a></span></dt><dt><span class="sect1"><a href="#upgrade">2. Upgrading FreeBSD</a></span></dt></dl></div><div class="sect1"><div xmlns="" class="titlepage"><div><div><h2 xmlns="http://www.w3.org/1999/xhtml" class="title" style="clear: both"><a id="install"></a>1. Installing FreeBSD</h2></div></div></div><p xmlns="http://www.w3.org/TR/xhtml1/transitional">The <code xmlns="http://www.w3.org/1999/xhtml" class="uri"><a class="uri" href="../../../../doc/en_US.ISO8859-1/books/handbook/bsdinstall.html" target="_top">Installing
FreeBSD</a></code>
chapter of the <code xmlns="http://www.w3.org/1999/xhtml" class="uri"><a class="uri" href="../../../../doc/en_US.ISO8859-1/books/handbook/" target="_top">FreeBSD
Handbook</a></code> provides more in-depth information about the
installation program itself, including a guided walk-through with
screenshots. </p></div><div class="sect1"><div xmlns="" class="titlepage"><div><div><h2 xmlns="http://www.w3.org/1999/xhtml" class="title" style="clear: both"><a id="upgrade"></a>2. Upgrading FreeBSD</h2></div></div></div><p xmlns="http://www.w3.org/TR/xhtml1/transitional">If you are upgrading from a previous release of FreeBSD, please
read <code xmlns="http://www.w3.org/1999/xhtml" class="uri"><a class="uri" href="http://www.FreeBSD.org/releases/10.2R/relnotes.html#upgrade" target="_top">upgrading
section in the Release Notes</a></code> for notable
incompatibilities carefully. </p><div class="sect2"><div xmlns="" class="titlepage"><div><div><h3 xmlns="http://www.w3.org/1999/xhtml" class="title"><a id="idp61907152"></a>2.1. Upgrading from Source</h3></div></div></div><p xmlns="http://www.w3.org/TR/xhtml1/transitional">The procedure for doing a source code based update is
described in
<code xmlns="http://www.w3.org/1999/xhtml" class="uri"><a class="uri" href="../../../../doc/en_US.ISO8859-1/books/handbook/synching.html" target="_top">Synchronizing Source</a></code> and
<code xmlns="http://www.w3.org/1999/xhtml" class="uri"><a class="uri" href="../../../../doc/en_US.ISO8859-1/books/handbook/makeworld.html" target="_top">Rebuilding world</a></code>. </p><p xmlns="http://www.w3.org/TR/xhtml1/transitional">For SVN use the <code xmlns="http://www.w3.org/1999/xhtml" class="filename">releng/10.2</code> branch
which will be where any upcoming Security Advisories or Errata
Notices will be applied. </p></div><div class="sect2"><div xmlns="" class="titlepage"><div><div><h3 xmlns="http://www.w3.org/1999/xhtml" class="title"><a id="idp61923024"></a>2.2. Upgrading Using <span class="quote">&#8220;<span class="quote">FreeBSD Update</span>&#8221;</span></h3></div></div></div><p xmlns="http://www.w3.org/TR/xhtml1/transitional">The <a xmlns="http://www.w3.org/1999/xhtml" class="citerefentry" href="http://www.FreeBSD.org/cgi/man.cgi?query=freebsd-update&amp;sektion=8"><span class="citerefentry"><span class="refentrytitle">freebsd-update</span>(8)</span></a> utility supports binary
upgrades of i386 and amd64 systems running
earlier FreeBSD releases. Systems running
<code xmlns="http://www.w3.org/1999/xhtml" class="literal">9.3-RELEASE</code>,
<code xmlns="http://www.w3.org/1999/xhtml" class="literal">10.1-RELEASE</code>,
<code xmlns="http://www.w3.org/1999/xhtml" class="literal">10.2-RC[1234]</code> can upgrade as follows: </p><pre class="screen"><code class="prompt">#</code> freebsd-update fetch
<code class="prompt">#</code> freebsd-update install</pre><p xmlns="http://www.w3.org/TR/xhtml1/transitional">Now the <a xmlns="http://www.w3.org/1999/xhtml" class="citerefentry" href="http://www.FreeBSD.org/cgi/man.cgi?query=freebsd-update&amp;sektion=8"><span class="citerefentry"><span class="refentrytitle">freebsd-update</span>(8)</span></a> utility can fetch bits
belonging to 10.2-RELEASE. During this process
<a xmlns="http://www.w3.org/1999/xhtml" class="citerefentry" href="http://www.FreeBSD.org/cgi/man.cgi?query=freebsd-update&amp;sektion=8"><span class="citerefentry"><span class="refentrytitle">freebsd-update</span>(8)</span></a> will ask for help in merging
configuration files. </p><pre class="screen"><code class="prompt">#</code> freebsd-update upgrade -r 10.2-RELEASE</pre><p xmlns="http://www.w3.org/TR/xhtml1/transitional">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 8.x or 9.x: </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p xmlns="http://www.w3.org/TR/xhtml1/transitional">The FreeBSD, which previously could appear in either
<code xmlns="http://www.w3.org/1999/xhtml" class="filename">/boot/kernel</code> or
<code xmlns="http://www.w3.org/1999/xhtml" class="filename">/boot/GENERIC</code>, now only appears as
<code xmlns="http://www.w3.org/1999/xhtml" class="filename">/boot/kernel</code>. As a result, any
kernel appearing in <code xmlns="http://www.w3.org/1999/xhtml" class="filename">/boot/GENERIC</code>
will be deleted. Please carefully read the output printed
by <a xmlns="http://www.w3.org/1999/xhtml" class="citerefentry" href="http://www.FreeBSD.org/cgi/man.cgi?query=freebsd-update&amp;sektion=8"><span class="citerefentry"><span class="refentrytitle">freebsd-update</span>(8)</span></a> and confirm that an updated
kernel will be placed into
<code xmlns="http://www.w3.org/1999/xhtml" class="filename">/boot/kernel</code> before proceeding beyond
this point. </p></li><li class="listitem"><p xmlns="http://www.w3.org/TR/xhtml1/transitional">The FreeBSD source tree in <code xmlns="http://www.w3.org/1999/xhtml" class="filename">/usr/src</code>
(if present) will be deleted. (Normally the
<a xmlns="http://www.w3.org/1999/xhtml" class="citerefentry" href="http://www.FreeBSD.org/cgi/man.cgi?query=freebsd-update&amp;sektion=8"><span class="citerefentry"><span class="refentrytitle">freebsd-update</span>(8)</span></a> utility will update a source tree,
but in this case the changes in release packaging result
in the <a xmlns="http://www.w3.org/1999/xhtml" class="citerefentry" href="http://www.FreeBSD.org/cgi/man.cgi?query=freebsd-update&amp;sektion=8"><span class="citerefentry"><span class="refentrytitle">freebsd-update</span>(8)</span></a> 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.) </p></li></ol></div><pre class="screen"><code class="prompt">#</code> freebsd-update install</pre><p xmlns="http://www.w3.org/TR/xhtml1/transitional">The system must now be rebooted with the newly installed
kernel before the non-kernel components are updated. </p><pre class="screen"><code class="prompt">#</code> shutdown -r now</pre><p xmlns="http://www.w3.org/TR/xhtml1/transitional">After rebooting, <a xmlns="http://www.w3.org/1999/xhtml" class="citerefentry" href="http://www.FreeBSD.org/cgi/man.cgi?query=freebsd-update&amp;sektion=8"><span class="citerefentry"><span class="refentrytitle">freebsd-update</span>(8)</span></a> needs to be run
again to install the new userland components: </p><pre class="screen"><code class="prompt">#</code> freebsd-update install</pre><p xmlns="http://www.w3.org/TR/xhtml1/transitional">At this point, users of systems being upgraded from FreeBSD
9.3-RELEASE or earlier will be prompted by
<a xmlns="http://www.w3.org/1999/xhtml" class="citerefentry" href="http://www.FreeBSD.org/cgi/man.cgi?query=freebsd-update&amp;sektion=8"><span class="citerefentry"><span class="refentrytitle">freebsd-update</span>(8)</span></a> to rebuild all third-party applications
(e.g., ports installed from the ports tree) due to updates in
system libraries. </p><p xmlns="http://www.w3.org/TR/xhtml1/transitional">After updating installed third-party applications (and
again, only if <a xmlns="http://www.w3.org/1999/xhtml" class="citerefentry" href="http://www.FreeBSD.org/cgi/man.cgi?query=freebsd-update&amp;sektion=8"><span class="citerefentry"><span class="refentrytitle">freebsd-update</span>(8)</span></a> printed a message
indicating that this was necessary), run
<a xmlns="http://www.w3.org/1999/xhtml" class="citerefentry" href="http://www.FreeBSD.org/cgi/man.cgi?query=freebsd-update&amp;sektion=8"><span class="citerefentry"><span class="refentrytitle">freebsd-update</span>(8)</span></a> again so that it can delete the old (no
longer used) system libraries: </p><pre class="screen"><code class="prompt">#</code> freebsd-update install</pre><p xmlns="http://www.w3.org/TR/xhtml1/transitional">Finally, reboot into 10.2-RELEASE </p><pre class="screen"><code class="prompt">#</code> shutdown -r now</pre></div></div></div><p xmlns="http://www.w3.org/TR/xhtml1/transitional" align="center"><small>This file, and other release-related documents,
can be downloaded from <a href="http://www.FreeBSD.org/releases/">http://www.FreeBSD.org/releases/</a>.</small></p><p xmlns="http://www.w3.org/TR/xhtml1/transitional" align="center"><small>For questions about FreeBSD, read the
<a href="http://www.FreeBSD.org/docs.html">documentation</a> before
contacting &lt;<a href="mailto:questions@FreeBSD.org">questions@FreeBSD.org</a>&gt;.</small></p><p xmlns="http://www.w3.org/TR/xhtml1/transitional" align="center"><small>All users of FreeBSD release should
subscribe to the &lt;<a href="mailto:stable@FreeBSD.org">stable@FreeBSD.org</a>&gt;
mailing list.</small></p><p xmlns="http://www.w3.org/TR/xhtml1/transitional" align="center"><small>For questions about this documentation,
e-mail &lt;<a href="mailto:doc@FreeBSD.org">doc@FreeBSD.org</a>&gt;.</small></p></body></html>