release/doc/en_US.ISO8859-1/installation/article.xml

   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$</pubdate>
  14
  15     <copyright>
  16       <year>2013</year>
  17       <holderrole="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>