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.1"> 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: stable/11/release/doc/en_US.ISO8859-1/installation/article.xml 333727 2018-05-17 15:53:37Z gjb $</pubdate> 23 24 <copyright> 25 <year>2018</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>10.3-RELEASE</literal>, 86 <literal>11.0-RELEASE</literal> can upgrade as follows:</para> 87 88 <screen>&prompt.root; freebsd-update fetch 89&prompt.root; freebsd-update install</screen> 90 91 <para>Now the &man.freebsd-update.8; utility can fetch bits 92 belonging to &release.current;. During this process 93 &man.freebsd-update.8; will ask for help in merging 94 configuration files.</para> 95 96 <screen>&prompt.root; freebsd-update upgrade -r &local.rel;-RELEASE</screen> 97 98 <screen>&prompt.root; freebsd-update install</screen> 99 100 <para>The system must now be rebooted with the newly installed 101 kernel before the non-kernel components are updated.</para> 102 103 <screen>&prompt.root; shutdown -r now</screen> 104 105 <para>After rebooting, &man.freebsd-update.8; needs to be run 106 again to install the new userland components:</para> 107 108 <screen>&prompt.root; freebsd-update install</screen> 109 110 <para>At this point, users of systems being upgraded from 111 earlier &os; releases will be prompted by 112 &man.freebsd-update.8; to rebuild all third-party applications 113 (e.g., ports installed from the ports tree) due to updates in 114 system libraries.</para> 115 116 <para>After updating installed third-party applications (and 117 again, only if &man.freebsd-update.8; printed a message 118 indicating that this was necessary), run 119 &man.freebsd-update.8; again so that it can delete the old (no 120 longer used) system libraries:</para> 121 122 <screen>&prompt.root; freebsd-update install</screen> 123 124 <para>Finally, reboot into &release.current;</para> 125 126 <screen>&prompt.root; shutdown -r now</screen> 127 </sect2> 128 </sect1> 129</article> 130