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 "11.3">
   8 ]>
   9
  10 <article xmlns="http://docbook.org/ns/docbook"
  11   xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
  12   xml:id="top">
  13
  14   <info>
  15     <title>&os; &release.current; Installation
  16       Instructions</title>
  17
  18     <author>
  19       <orgname>The &os; Project</orgname>
  20     </author>
  21
  22     <pubdate>$FreeBSD$</pubdate>
  23
  24     <copyright>
  25       <year>2019</year>
  26       <holder role="mailto:doc@FreeBSD.org">The &os; Documentation
  27         Project</holder>
  28     </copyright>
  29
  30     <legalnotice xml:id="trademarks" role="trademarks">
  31       &tm-attrib.freebsd;
  32       &tm-attrib.intel;
  33       &tm-attrib.sparc;
  34       &tm-attrib.general;
  35     </legalnotice>
  36
  37     <abstract>
  38       <para>This article gives some brief instructions on installing
  39         &os; &release.current; and upgrading the systems running
  40         earlier releases.</para>
  41     </abstract>
  42   </info>
  43
  44   <sect1 xml:id="install">
  45     <title>Installing &os;</title>
  46
  47     <para>The <uri
  48         xlink:href="&url.books.handbook;/bsdinstall.html">Installing
  49         &os;</uri> chapter of the <uri
  50         xlink:href="&url.books.handbook;/">&os; Handbook</uri>
  51       provides more in-depth information about the installation
  52       program itself, including a guided walk-through with
  53       screenshots.</para>
  54   </sect1>
  55
  56   <sect1 xml:id="upgrade">
  57     <title>Upgrading &os;</title>
  58
  59     <para>If you are upgrading from a previous release of &os;, please
  60       read <uri
  61       xlink:href="http://www.FreeBSD.org/releases/&local.rel;R/relnotes.html#upgrade">upgrading
  62       section in the Release Notes</uri> for notable
  63       incompatibilities carefully.</para>
  64
  65     <sect2 xml:id="upgrade-source">
  66       <title>Upgrading from Source</title>
  67
  68       <para>The procedure for doing a source code based update is
  69         described in <uri
  70           xlink:href="&url.books.handbook;/synching.html"></uri> and
  71         <uri
  72           xlink:href="&url.books.handbook;/makeworld.html"></uri>.</para>
  73
  74       <para>For SVN use the <filename>releng/&local.rel;</filename>
  75         branch which will be where any upcoming Security Advisories or
  76         Errata Notices will be applied.</para>
  77     </sect2>
  78
  79     <sect2 xml:id="upgrade-binary">
  80       <title>Upgrading Using <quote>&os; Update</quote></title>
  81
  82       <para>The &man.freebsd-update.8; utility supports binary
  83         upgrades of &arch.i386; and &arch.amd64; systems running
  84         earlier FreeBSD releases.  Systems running
  85         <literal>11.2-RELEASE</literal> can upgrade as follows:</para>
  86
  87       <screen>&prompt.root; freebsd-update fetch
  88 &prompt.root; freebsd-update install</screen>
  89
  90       <para>Now the &man.freebsd-update.8; utility can fetch bits
  91         belonging to &release.current;.  During this process
  92         &man.freebsd-update.8; will ask for help in merging
  93         configuration files.</para>
  94
  95       <screen>&prompt.root; freebsd-update upgrade -r &local.rel;-RELEASE</screen>
  96
  97       <screen>&prompt.root; freebsd-update install</screen>
  98
  99       <para>The system must now be rebooted with the newly installed
 100         kernel before the non-kernel components are updated.</para>
 101
 102       <screen>&prompt.root; shutdown -r now</screen>
 103
 104       <para>After rebooting, &man.freebsd-update.8; needs to be run
 105         again to install the new userland components:</para>
 106
 107       <screen>&prompt.root; freebsd-update install</screen>
 108
 109       <para>At this point, users of systems being upgraded from
 110         earlier &os; releases will be prompted by
 111         &man.freebsd-update.8; to rebuild all third-party applications
 112         (e.g., ports installed from the ports tree) due to updates in
 113         system libraries.</para>
 114
 115       <para>After updating installed third-party applications (and
 116         again, only if &man.freebsd-update.8; printed a message
 117         indicating that this was necessary), run
 118         &man.freebsd-update.8; again so that it can delete the old (no
 119         longer used) system libraries:</para>
 120
 121       <screen>&prompt.root; freebsd-update install</screen>
 122
 123       <para>Finally, reboot into &release.current;</para>
 124
 125       <screen>&prompt.root; shutdown -r now</screen>
 126     </sect2>
 127   </sect1>
 128 </article>