1318475Sgjb<?xml version="1.0" encoding="iso-8859-1"?> 2318475Sgjb<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V5.0-Based Extension//EN" 3318475Sgjb "http://www.FreeBSD.org/XML/share/xml/freebsd50.dtd" [ 4318475Sgjb<!ENTITY % release PUBLIC "-//FreeBSD//ENTITIES Release Specification//EN" 5318475Sgjb "http://www.FreeBSD.org/release/XML/share/xml/release.ent"> 6318475Sgjb%release; 7318475Sgjb<!ENTITY local.rel "11.1"> 8318475Sgjb]> 9318475Sgjb 10318475Sgjb<article xmlns="http://docbook.org/ns/docbook" 11318475Sgjb xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" 12318475Sgjb xml:id="top"> 13318475Sgjb 14318475Sgjb <info> 15318475Sgjb <title>&os; &release.current; Installation 16318475Sgjb Instructions</title> 17318475Sgjb 18318475Sgjb <author> 19318475Sgjb <orgname>The &os; Project</orgname> 20318475Sgjb </author> 21318475Sgjb 22318475Sgjb <pubdate>$FreeBSD: stable/11/release/doc/en_US.ISO8859-1/installation/article.xml 333727 2018-05-17 15:53:37Z gjb $</pubdate> 23318475Sgjb 24318475Sgjb <copyright> 25333727Sgjb <year>2018</year> 26318475Sgjb <holder role="mailto:doc@FreeBSD.org">The &os; Documentation 27318475Sgjb Project</holder> 28318475Sgjb </copyright> 29318475Sgjb 30318475Sgjb <legalnotice xml:id="trademarks" role="trademarks"> 31318475Sgjb &tm-attrib.freebsd; 32318475Sgjb &tm-attrib.intel; 33318475Sgjb &tm-attrib.sparc; 34318475Sgjb &tm-attrib.general; 35318475Sgjb </legalnotice> 36318475Sgjb 37318475Sgjb <abstract> 38318475Sgjb <para>This article gives some brief instructions on installing 39318475Sgjb &os; &release.current; and upgrading the systems running 40318475Sgjb earlier releases.</para> 41318475Sgjb </abstract> 42318475Sgjb </info> 43318475Sgjb 44318475Sgjb <sect1 xml:id="install"> 45318475Sgjb <title>Installing &os;</title> 46318475Sgjb 47318475Sgjb <para>The <uri 48318475Sgjb xlink:href="&url.books.handbook;/bsdinstall.html">Installing 49318475Sgjb &os;</uri> chapter of the <uri 50318475Sgjb xlink:href="&url.books.handbook;/">&os; Handbook</uri> 51318475Sgjb provides more in-depth information about the installation 52318475Sgjb program itself, including a guided walk-through with 53318475Sgjb screenshots.</para> 54318475Sgjb </sect1> 55318475Sgjb 56318475Sgjb <sect1 xml:id="upgrade"> 57318475Sgjb <title>Upgrading &os;</title> 58318475Sgjb 59318475Sgjb <para>If you are upgrading from a previous release of &os;, please 60318475Sgjb read <uri 61318475Sgjb xlink:href="http://www.FreeBSD.org/releases/&local.rel;R/relnotes.html#upgrade">upgrading 62318475Sgjb section in the Release Notes</uri> for notable 63318475Sgjb incompatibilities carefully.</para> 64318475Sgjb 65318475Sgjb <sect2 xml:id="upgrade-source"> 66318475Sgjb <title>Upgrading from Source</title> 67318475Sgjb 68318475Sgjb <para>The procedure for doing a source code based update is 69318475Sgjb described in <uri 70318475Sgjb xlink:href="&url.books.handbook;/synching.html"></uri> and 71318475Sgjb <uri 72318475Sgjb xlink:href="&url.books.handbook;/makeworld.html"></uri>.</para> 73318475Sgjb 74318475Sgjb <para>For SVN use the <filename>releng/&local.rel;</filename> 75318475Sgjb branch which will be where any upcoming Security Advisories or 76318475Sgjb Errata Notices will be applied.</para> 77318475Sgjb </sect2> 78318475Sgjb 79318475Sgjb <sect2 xml:id="upgrade-binary"> 80318475Sgjb <title>Upgrading Using <quote>&os; Update</quote></title> 81318475Sgjb 82318475Sgjb <para>The &man.freebsd-update.8; utility supports binary 83318475Sgjb upgrades of &arch.i386; and &arch.amd64; systems running 84318475Sgjb earlier FreeBSD releases. Systems running 85318475Sgjb <literal>10.3-RELEASE</literal>, 86318475Sgjb <literal>11.0-RELEASE</literal> can upgrade as follows:</para> 87318475Sgjb 88318475Sgjb <screen>&prompt.root; freebsd-update fetch 89318475Sgjb&prompt.root; freebsd-update install</screen> 90318475Sgjb 91318475Sgjb <para>Now the &man.freebsd-update.8; utility can fetch bits 92318475Sgjb belonging to &release.current;. During this process 93318475Sgjb &man.freebsd-update.8; will ask for help in merging 94318475Sgjb configuration files.</para> 95318475Sgjb 96318475Sgjb <screen>&prompt.root; freebsd-update upgrade -r &local.rel;-RELEASE</screen> 97318475Sgjb 98318475Sgjb <screen>&prompt.root; freebsd-update install</screen> 99318475Sgjb 100318475Sgjb <para>The system must now be rebooted with the newly installed 101318475Sgjb kernel before the non-kernel components are updated.</para> 102318475Sgjb 103318475Sgjb <screen>&prompt.root; shutdown -r now</screen> 104318475Sgjb 105318475Sgjb <para>After rebooting, &man.freebsd-update.8; needs to be run 106318475Sgjb again to install the new userland components:</para> 107318475Sgjb 108318475Sgjb <screen>&prompt.root; freebsd-update install</screen> 109318475Sgjb 110318475Sgjb <para>At this point, users of systems being upgraded from 111318475Sgjb earlier &os; releases will be prompted by 112318475Sgjb &man.freebsd-update.8; to rebuild all third-party applications 113318475Sgjb (e.g., ports installed from the ports tree) due to updates in 114318475Sgjb system libraries.</para> 115318475Sgjb 116318475Sgjb <para>After updating installed third-party applications (and 117318475Sgjb again, only if &man.freebsd-update.8; printed a message 118318475Sgjb indicating that this was necessary), run 119318475Sgjb &man.freebsd-update.8; again so that it can delete the old (no 120318475Sgjb longer used) system libraries:</para> 121318475Sgjb 122318475Sgjb <screen>&prompt.root; freebsd-update install</screen> 123318475Sgjb 124318475Sgjb <para>Finally, reboot into &release.current;</para> 125318475Sgjb 126318475Sgjb <screen>&prompt.root; shutdown -r now</screen> 127318475Sgjb </sect2> 128318475Sgjb </sect1> 129318475Sgjb</article> 130