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