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: stable/9/release/doc/en_US.ISO8859-1/installation/article.xml 267588 2014-06-17 18:03:59Z gjb $</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">&url.books.handbook;/synching.html</uri> and 60 <uri xlink:href="&url.books.handbook;/makeworld.html">&url.books.handbook;/makeworld.html</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 7.x or 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.2-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> 156