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

   1 <?xml version="1.0" encoding="iso-8859-1" standalone="no"?>
   2 <!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V4.2-Based Extension//EN" [
   3 <!ENTITY % entities PUBLIC "-//FreeBSD//ENTITIES DocBook FreeBSD Entity Set//EN">
   4 %entities;
   5
   6 <!ENTITY % release PUBLIC "-//FreeBSD//ENTITIES Release Specification//EN">
   7 %release;
   8
   9 <!-- Text constants which probably don't need to be changed.-->
  10
  11 <!ENTITY % include.historic "IGNORE">
  12 <!ENTITY % no.include.historic "IGNORE">
  13 ]>
  14
  15 <article>
  16   <articleinfo>
  17     <title>&os; &release.current; Installation Instructions</title>
  18
  19     <corpauthor>The &os; Project</corpauthor>
  20
  21     <pubdate>$FreeBSD$</pubdate>
  22
  23     <copyright>
  24       <year>2012</year>
  25
  26       <holder role="mailto:doc@FreeBSD.org">The &os; Documentation Project</holder>
  27     </copyright>
  28
  29     <legalnotice id="trademarks" role="trademarks">
  30       &tm-attrib.freebsd;
  31       &tm-attrib.intel;
  32       &tm-attrib.sparc;
  33       &tm-attrib.general;
  34     </legalnotice>
  35   </articleinfo>
  36
  37   <abstract>
  38     <para>This article gives some brief instructions on installing
  39       &os; &release.current; and upgrading the systems running earlier
  40       releases.</para>
  41   </abstract>
  42
  43   <sect1 id="install">
  44     <title>Installing &os;</title>
  45
  46     <para>For instructions on installing FreeBSD, please see Chapter 2
  47       of The FreeBSD Handbook.  It provides a complete installation
  48       walk-through for users new to FreeBSD, and can be found online
  49       at: <ulink
  50         url="&url.books.handbook;/install.html"></ulink></para>
  51   </sect1>
  52
  53   <sect1 id="upgrade">
  54     <title>Upgrading &os;</title>
  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         <ulink url="&url.books.handbook;/synching.html"></ulink> and
  62         <ulink url="&url.books.handbook;//makeworld.html"></ulink>.</para>
  63
  64       <para>The branch tag to use for updating the source is
  65         <literal>RELENG_8_3</literal> for CVS.  For SVN use
  66         <filename>releng/8.3</filename>.</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.[01234]-RELEASE</literal>,
  76         <literal>8.[012]-RELEASE</literal>,
  77         <literal>8.3-BETA1</literal>, or
  78         <literal>8.3-RC[12]</literal> can upgrade as follows:</para>
  79
  80       <screen>&prompt.root; freebsd-update upgrade -r 8.3-RELEASE</screen>
  81
  82       <para>During this process, FreeBSD Update may ask the user to
  83         help by merging some configuration files or by confirming that
  84         the automatically performed merging was done correctly.</para>
  85
  86       <screen>&prompt.root; freebsd-update install</screen>
  87
  88       <para>The system must be rebooted with the newly installed
  89         kernel before continuing.</para>
  90
  91       <screen>&prompt.root; shutdown -r now</screen>
  92
  93       <para>After rebooting, &man.freebsd-update.8; needs to be run
  94         again to install the new userland components:</para>
  95
  96       <screen>&prompt.root; freebsd-update install</screen>
  97
  98       <para>At this point, users of systems being upgraded from
  99         FreeBSD 7.4-RELEASE or earlier will be prompted by
 100         freebsd-update to rebuild all third-party applications (e.g.,
 101         ports installed from the ports tree) due to updates in system
 102         libraries.</para>
 103
 104       <para>After updating installed third-party applications (and
 105         again, only if &man.freebsd-update.8; printed a message
 106         indicating that this was necessary), run
 107         &man.freebsd-update.8; again so that it can delete the old (no
 108         longer used) system libraries:</para>
 109
 110       <screen>&prompt.root; freebsd-update install</screen>
 111
 112       <para>Finally, reboot into &release.current;</para>
 113
 114       <screen>&prompt.root; shutdown -r now</screen>
 115     </sect2>
 116   </sect1>
 117 </article>