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>2012</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>For instructions on installing FreeBSD, please see Chapter 2
  39       of The FreeBSD Handbook.  It provides a complete installation
  40       walk-through for users new to FreeBSD, and can be found online
  41       at: <link
  42         xlink:href="&url.books.handbook;/install.html"></link></para>
  43   </sect1>
  44
  45   <sect1 xml:id="upgrade">
  46     <title>Upgrading &os;</title>
  47
  48     <sect2>
  49       <title>Upgrading from Source</title>
  50
  51       <para>The procedure for doing a source code based update is
  52         described in
  53         <uri xlink:href="&url.books.handbook;/synching.html">&url.books.handbook;/synching.html</uri> and
  54         <uri xlink:href="&url.books.handbook;/makeworld.html">&url.books.handbook;/makeworld.html</uri>.</para>
  55
  56       <para>The branch tag to use for updating the source is
  57         <literal>RELENG_8_3</literal> for CVS.  For SVN use
  58         <filename>releng/8.3</filename>.</para>
  59     </sect2>
  60
  61     <sect2>
  62       <title>Upgrading Using <quote>&os; Update</quote></title>
  63
  64       <para>The &man.freebsd-update.8; utility supports binary
  65         upgrades of &arch.i386; and &arch.amd64; systems running
  66         earlier FreeBSD releases. Systems running
  67         <literal>7.[01234]-RELEASE</literal>,
  68         <literal>8.[012]-RELEASE</literal>,
  69         <literal>8.3-BETA1</literal>, or
  70         <literal>8.3-RC[12]</literal> can upgrade as follows:</para>
  71
  72       <screen>&prompt.root; freebsd-update upgrade -r 8.3-RELEASE</screen>
  73
  74       <para>During this process, FreeBSD Update may ask the user to
  75         help by merging some configuration files or by confirming that
  76         the automatically performed merging was done correctly.</para>
  77
  78       <screen>&prompt.root; freebsd-update install</screen>
  79
  80       <para>The system must now be rebooted with the newly installed
  81         kernel before the non-kernel components are updated.</para>
  82
  83       <screen>&prompt.root; shutdown -r now</screen>
  84
  85       <para>After rebooting, &man.freebsd-update.8; needs to be run
  86         again to install the new userland components:</para>
  87
  88       <screen>&prompt.root; freebsd-update install</screen>
  89
  90       <para>At this point, users of systems being upgraded from
  91         FreeBSD 7.4-RELEASE or earlier will be prompted by
  92         freebsd-update to rebuild all third-party applications (e.g.,
  93         ports installed from the ports tree) due to updates in system
  94         libraries.</para>
  95
  96       <para>After updating installed third-party applications (and
  97         again, only if &man.freebsd-update.8; printed a message
  98         indicating that this was necessary), run
  99         &man.freebsd-update.8; again so that it can delete the old (no
 100         longer used) system libraries:</para>
 101
 102       <screen>&prompt.root; freebsd-update install</screen>
 103
 104       <para>Finally, reboot into &release.current;</para>
 105
 106       <screen>&prompt.root; shutdown -r now</screen>
 107     </sect2>
 108   </sect1>
 109 </article>