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