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.3R/relnotes.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">Synchronizing Source</uri> and
  60         <uri xlink:href="&url.books.handbook;/makeworld.html">Rebuilding World</uri>.</para>
  61
  62       <para>For SVN use the <filename>releng/9.3</filename> branch
  63         which will be where any upcoming Security Advisories or Errata
  64         Notices will be applied.</para>
  65     </sect2>
  66
  67     <sect2>
  68       <title>Upgrading Using <quote>&os; Update</quote></title>
  69
  70       <para>The &man.freebsd-update.8; utility supports binary
  71         upgrades of &arch.i386; and &arch.amd64; systems running
  72         earlier FreeBSD releases. Systems running
  73         <literal>8.4-RELEASE</literal>,
  74         <literal>9.[12]-RELEASE</literal>,
  75         <literal>9.3-BETA*</literal>, or
  76         <literal>9.3-RC*</literal> can upgrade as follows:</para>
  77
  78       <para>First, ensure that your current system is up to date; a
  79         change was recently made to &man.freebsd-update.8; (Errata
  80         Notice <link xlink:href="http://security.FreeBSD.org/advisories/FreeBSD-EN-12:01.freebsd-update.asc">FreeBSD-EN-12:01.freebsd-update</link>)
  81         which is needed in order to upgrade to &os;
  82         &release.current;.</para>
  83
  84       <screen>&prompt.root; freebsd-update fetch
  85 &prompt.root; freebsd-update install</screen>
  86
  87       <para>Now the &man.freebsd-update.8; utility can fetch bits
  88         belonging to &release.current;.  During this process
  89         &man.freebsd-update.8; will ask for help in merging
  90         configuration files.</para>
  91
  92       <screen>&prompt.root; freebsd-update upgrade -r 9.3-RELEASE</screen>
  93
  94       <para>Due to changes in the way that &os; is packaged on the
  95         release media, two complications may arise in this process if
  96         upgrading from FreeBSD 8.x:</para>
  97
  98       <orderedlist>
  99         <listitem>
 100           <para>The &os;, which previously could appear in either
 101             <filename>/boot/kernel</filename> or
 102             <filename>/boot/GENERIC</filename>, now only appears as
 103             <filename>/boot/kernel</filename>.  As a result, any
 104             kernel appearing in <filename>/boot/GENERIC</filename>
 105             will be deleted.  Please carefully read the output printed
 106             by &man.freebsd-update.8; and confirm that an updated
 107             kernel will be placed into
 108             <filename>/boot/kernel</filename> before proceeding beyond
 109             this point.</para>
 110         </listitem>
 111
 112         <listitem>
 113           <para>The &os; source tree in <filename>/usr/src</filename>
 114             (if present) will be deleted.  (Normally the
 115             &man.freebsd-update.8; utility will update a source tree,
 116             but in this case the changes in release packaging result
 117             in the &man.freebsd-update.8; utility not recognizing that
 118             the source tree from the old release and the source tree
 119             from the new release correspond to the same part of
 120             &os;.)</para>
 121         </listitem>
 122       </orderedlist>
 123
 124       <screen>&prompt.root; freebsd-update install</screen>
 125
 126       <para>The system must now be rebooted with the newly installed
 127         kernel before the non-kernel components are updated.</para>
 128
 129       <screen>&prompt.root; shutdown -r now</screen>
 130
 131       <para>After rebooting, &man.freebsd-update.8; needs to be run
 132         again to install the new userland components:</para>
 133
 134       <screen>&prompt.root; freebsd-update install</screen>
 135
 136       <para>At this point, users of systems being upgraded from &os;
 137         8.4-RELEASE or earlier will be prompted by
 138         &man.freebsd-update.8; to rebuild all third-party applications
 139         (e.g., ports installed from the ports tree) due to updates in
 140         system libraries.</para>
 141
 142       <para>After updating installed third-party applications (and
 143         again, only if &man.freebsd-update.8; printed a message
 144         indicating that this was necessary), run
 145         &man.freebsd-update.8; again so that it can delete the old (no
 146         longer used) system libraries:</para>
 147
 148       <screen>&prompt.root; freebsd-update install</screen>
 149
 150       <para>Finally, reboot into &release.current;</para>
 151
 152       <screen>&prompt.root; shutdown -r now</screen>
 153     </sect2>
 154   </sect1>
 155 </article>