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