head	1.1;
access;
symbols
	RELENG_9_1_0_RELEASE:1.1.2.2.2.4
	RELENG_9_1:1.1.2.2.0.2
	RELENG_9_1_BP:1.1.2.2
	RELENG_8:1.1.0.4
	RELENG_9:1.1.0.2;
locks; strict;
comment	@# @;


1.1
date	2012.01.11.20.04.52;	author hrs;	state dead;
branches
	1.1.2.1
	1.1.4.1;
next	;

1.1.2.1
date	2012.01.11.20.04.52;	author hrs;	state Exp;
branches;
next	1.1.2.2;

1.1.2.2
date	2012.01.12.03.52.53;	author hrs;	state Exp;
branches
	1.1.2.2.2.1;
next	1.1.2.3;

1.1.2.3
date	2012.09.18.16.49.57;	author gjb;	state Exp;
branches;
next	1.1.2.4;

1.1.2.4
date	2012.10.02.06.37.46;	author gabor;	state dead;
branches;
next	;

1.1.2.2.2.1
date	2012.08.05.23.54.33;	author kensmith;	state Exp;
branches;
next	1.1.2.2.2.2;

1.1.2.2.2.2
date	2012.09.19.21.44.39;	author gjb;	state Exp;
branches;
next	1.1.2.2.2.3;

1.1.2.2.2.3
date	2012.10.11.15.49.42;	author gabor;	state dead;
branches;
next	1.1.2.2.2.4;

1.1.2.2.2.4
date	2012.11.30.16.19.18;	author svnexp;	state Exp;
branches;
next	;

1.1.4.1
date	2012.04.18.08.15.55;	author hrs;	state dead;
branches;
next	1.1.4.2;

1.1.4.2
date	2012.04.18.08.15.55;	author hrs;	state Exp;
branches;
next	1.1.4.3;

1.1.4.3
date	2012.10.18.22.21.18;	author gjb;	state Exp;
branches;
next	1.1.4.4;

1.1.4.4
date	2012.10.19.03.01.25;	author gjb;	state dead;
branches;
next	;


desc
@@


1.1
log
@file article.sgml was initially added on branch RELENG_9.
@
text
@@


1.1.4.1
log
@file article.sgml was added on branch RELENG_8 on 2012-04-18 08:16:16 +0000
@
text
@@


1.1.4.2
log
@SVN rev 234413 on 2012-04-18 08:15:55Z by hrs

Add installation/upgrade instructions for 8.3R.
@
text
@a0 111
<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook V4.1-Based Extension//EN" [
<!ENTITY % articles.ent PUBLIC "-//FreeBSD//ENTITIES DocBook FreeBSD Articles Entity Set//EN">
%articles.ent;

<!ENTITY % release PUBLIC "-//FreeBSD//ENTITIES Release Specification//EN">
%release;
]>

<article>
  <articleinfo>
    <title>&os; &release.current; Installation Instructions</title>

    <corpauthor>The &os; Project</corpauthor>

    <pubdate>$FreeBSD$</pubdate>

    <copyright>
      <year>2012</year>

      <holder role="mailto:doc@@FreeBSD.org">The &os; Documentation Project</holder>
    </copyright>

    <legalnotice id="trademarks" role="trademarks">
      &tm-attrib.freebsd;
      &tm-attrib.intel;
      &tm-attrib.sparc;
      &tm-attrib.general;
    </legalnotice>
  </articleinfo>

  <abstract>
    <para>This article gives some brief instructions on installing
      &os; &release.current; and upgrading the systems running earlier
      releases.</para>
  </abstract>

  <sect1 id="install">
    <title>Installing &os;</title>

    <para>For instructions on installing FreeBSD, please see Chapter 2
      of The FreeBSD Handbook.  It provides a complete installation
      walk-through for users new to FreeBSD, and can be found online
      at: <ulink
	url="&url.books.handbook;/install.html"></ulink></para>
  </sect1>

  <sect1 id="upgrade">
    <title>Upgrading &os;</title>

    <sect2>
      <title>Upgrading from Source</title>

      <para>The procedure for doing a source code based update is
	described in
	<ulink url="&url.books.handbook;/synching.html"></ulink> and
	<ulink url="&url.books.handbook;//makeworld.html"></ulink>.</para>

      <para>The branch tag to use for updating the source is
	<literal>RELENG_8_3</literal> for CVS.  For SVN use
	<filename>releng/8.3</filename>.</para>
    </sect2>

    <sect2>
      <title>Upgrading Using <quote>&os; Update</quote></title>

      <para>The &man.freebsd-update.8; utility supports binary
	upgrades of &arch.i386; and &arch.amd64; systems running
	earlier FreeBSD releases. Systems running
	<literal>7.[01234]-RELEASE</literal>,
	<literal>8.[012]-RELEASE</literal>,
	<literal>8.3-BETA1</literal>, or
	<literal>8.3-RC[12]</literal> can upgrade as follows:</para>

      <screen>&prompt.root; freebsd-update upgrade -r 8.3-RELEASE</screen>

      <para>During this process, FreeBSD Update may ask the user to
	help by merging some configuration files or by confirming that
	the automatically performed merging was done correctly.</para>

      <screen>&prompt.root; freebsd-update install</screen>

      <para>The system must be rebooted with the newly installed
	kernel before continuing.</para>

      <screen>&prompt.root; shutdown -r now</screen>

      <para>After rebooting, &man.freebsd-update.8; needs to be run
	again to install the new userland components:</para>

      <screen>&prompt.root; freebsd-update install</screen>

      <para>At this point, users of systems being upgraded from
	FreeBSD 7.4-RELEASE or earlier will be prompted by
	freebsd-update to rebuild all third-party applications (e.g.,
	ports installed from the ports tree) due to updates in system
	libraries.</para>

      <para>After updating installed third-party applications (and
	again, only if &man.freebsd-update.8; printed a message
	indicating that this was necessary), run
	&man.freebsd-update.8; again so that it can delete the old (no
	longer used) system libraries:</para>

      <screen>&prompt.root; freebsd-update install</screen>

      <para>Finally, reboot into &release.current;</para>

      <screen>&prompt.root; shutdown -r now</screen>
    </sect2>
  </sect1>
</article>
@


1.1.4.3
log
@SVN rev 241709 on 2012-10-18 22:21:18Z by gjb

Convert installation article to XML stanards.

This is a direct commit to stable/8.
@
text
@d1 3
a3 4
<?xml version="1.0" encoding="iso-8859-1" standalone="no"?>
<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V4.2-Based Extension//EN" [
<!ENTITY % entities PUBLIC "-//FreeBSD//ENTITIES DocBook FreeBSD Entity Set//EN">
%entities;
a6 5

<!-- Text constants which probably don't need to be changed.-->

<!ENTITY % include.historic "IGNORE">
<!ENTITY % no.include.historic "IGNORE">
@


1.1.4.4
log
@SVN rev 241718 on 2012-10-19 03:01:25Z by gjb

- Rename .sgml files to .xml to track the recent doc changes.
- Fix Makefiles and entities where necessary to get build to
  complete without errors.

*** NOTE: This is _NOT_ an MFC, but direct commit to stable/8. ***

Hat:		doceng
@
text
@d21 1
a21 1
    <pubdate>$FreeBSD: src/release/doc/en_US.ISO8859-1/installation/article.sgml,v 1.1.4.3 2012/10/18 22:21:18 gjb Exp $</pubdate>
@


1.1.2.1
log
@SVN rev 229979 on 2012-01-11 20:04:52Z by hrs

Add a document for brief installation instructions.

Submitted by:	kensmith
@
text
@a0 162
<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook V4.1-Based Extension//EN" [
<!ENTITY % articles.ent PUBLIC "-//FreeBSD//ENTITIES DocBook FreeBSD Articles Entity Set//EN">
%articles.ent;

<!ENTITY % release PUBLIC "-//FreeBSD//ENTITIES Release Specification//EN">
%release;
]>

<article>
  <articleinfo>
    <title>&os; &release.current; Installation Instructions</title>

    <corpauthor>The &os; Project</corpauthor>

    <pubdate>$FreeBSD$</pubdate>

    <copyright>
      <year>2012</year>

      <holder role="mailto:doc@@FreeBSD.org">The &os; Documentation Project</holder>
    </copyright>

    <legalnotice id="trademarks" role="trademarks">
      &tm-attrib.freebsd;
      &tm-attrib.intel;
      &tm-attrib.sparc;
      &tm-attrib.general;
    </legalnotice>
  </articleinfo>

  <abstract>
    <para>This article gives some brief instructions on installing
      &os; &release.current; and upgrading the systems running earlier
      releases.</para>
  </abstract>

  <sect1 id="install">
    <title>Installing &os;</title>

    <para>The <ulink
	url="&url.books.handbook;/bsdinstall.html"><quote>Installing
	  &os;</quote></ulink>
      chapter of the <ulink
	url="&url.books.handbook;/">&os;
	Handbook</ulink> provides more in-depth information about the
      installation program itself, including a guided walk-through with
      screenshots.</para>
  </sect1>

  <sect1 id="upgrade">
    <title>Upgrading &os;</title>

    <para>If you are upgrading from a previous release of &os;, please
      read <ulink
      url="http://www.FreeBSD.org/releases/9.0R/relnotes-detailed.html#upgrade">upgrading
      section in the Release Notes</ulink> for notable
      incompatibilities carefully.</para>

    <sect2>
      <title>Upgrading from Source</title>

      <para>The procedure for doing a source code based update is
	described in
	<ulink url="&url.books.handbook;/synching.html"></ulink> and
	<ulink url="&url.books.handbook;//makeworld.html"></ulink>.</para>

      <para>For SVN use the <filename>releng/9.0</filename> branch
	which will be where any upcoming Security Advisories or Errata
	Notices will be applied.  The branch tag to use for updating
	the source is <literal>RELENG_9_0</literal> for CVS.</para>
    </sect2>

    <sect2>
      <title>Upgrading Using <quote>&os; Update</quote></title>

      <para>The &man.freebsd-update.8; utility supports binary
	upgrades of &arch.i386; and &arch.amd64; systems running
	earlier FreeBSD releases. Systems running
	<literal>7.[34]-RELEASE</literal>,
	<literal>8.[12]-RELEASE</literal>,
	<literal>9.0-BETA[123]</literal>, or
	<literal>9.0-RC[123]</literal> can upgrade as follows:</para>

      <para>First, ensure that your current system is up to date; a
	change was recently made to &man.freebsd-update.8; (Errata
	Notice <ulink
	  url="http://security.FreeBSD.org/advisories/FreeBSD-EN-12:01.freebsd-update.asc">FreeBSD-EN-12:01.freebsd-update</ulink>)
	which is needed in order to upgrade to &os;
	&release.current;.</para>

      <screen>&prompt.root; freebsd-update fetch
&prompt.root; freebsd-update install</screen>

      <para>Now the &man.freebsd-update.8; utility can fetch bits
	belonging to &release.current;.  During this process
	&man.freebsd-update.8; will ask for help in merging
	configuration files.</para>

      <screen>&prompt.root; freebsd-update upgrade -r 9.0-RELEASE</screen>

      <para>Due to changes in the way that &os; is packaged on the
	release media, two complications may arise in this process if
	upgrading from FreeBSD 7.x or 8.x:</para>

      <orderedlist>
	<listitem>
	  <para>The &os;, which previously could appear in either
	    <filename>/boot/kernel</filename> or
	    <filename>/boot/GENERIC</filename>, now only appears as
	    <filename>/boot/kernel</filename>.  As a result, any
	    kernel appearing in <filename>/boot/GENERIC</filename>
	    will be deleted.  Please carefully read the output printed
	    by &man.freebsd-update.8; and confirm that an updated
	    kernel will be placed into
	    <filename>/boot/kernel</filename> before proceeding beyond
	    this point.</para>
	</listitem>

	<listitem>
	  <para>The &os; source tree in <filename>/usr/src</filename>
	    (if present) will be deleted.  (Normally the
	    &man.freebsd-update.8; utility will update a source tree,
	    but in this case the changes in release packaging result
	    in the &man.freebsd-update.8; utility not recognizing that
	    the source tree from the old release and the source tree
	    from the new release correspond to the same part of
	    &os;.)</para>
	</listitem>
      </orderedlist>

      <screen>&prompt.root; freebsd-update install</screen>

      <para>The system must now be rebooted with the newly installed
	kernel before the non-kernel components are updated.</para>

      <screen>&prompt.root; shutdown -r now</screen>

      <para>After rebooting, &man.freebsd-update.8; needs to be run
	again to install the new userland components:</para>

      <screen>&prompt.root; freebsd-update install</screen>

      <para>At this point, users of systems being upgraded from &os;
	8.2-RELEASE or earlier will be prompted by
	&man.freebsd-update.8; to rebuild all third-party applications
	(e.g., ports installed from the ports tree) due to updates in
	system libraries.</para>

      <para>After updating installed third-party applications (and
	again, only if &man.freebsd-update.8; printed a message
	indicating that this was necessary), run
	&man.freebsd-update.8; again so that it can delete the old (no
	longer used) system libraries:</para>

      <screen>&prompt.root; freebsd-update install</screen>

      <para>Finally, reboot into &release.current;</para>

      <screen>&prompt.root; shutdown -r now</screen>
    </sect2>
  </sect1>
</article>
@


1.1.2.2
log
@SVN rev 230001 on 2012-01-12 03:52:53Z by hrs

Use upper case in an anchor id.
@
text
@d55 1
a55 1
      url="http://www.FreeBSD.org/releases/9.0R/relnotes-detailed.html#UPGRADE">upgrading
@


1.1.2.3
log
@SVN rev 240663 on 2012-09-18 16:49:57Z by gjb

Convert installation article to XML stanards.
This commit should be the final fix for the 9-STABLE release build.

This is a direct commit to stable/9.
@
text
@d1 3
a3 4
<?xml version="1.0" encoding="iso-8859-1" standalone="no"?>
<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V4.2-Based Extension//EN" [
<!ENTITY % entities PUBLIC "-//FreeBSD//ENTITIES DocBook FreeBSD Entity Set//EN">
%entities;
a6 5

<!-- Text constants which probably don't need to be changed.-->

<!ENTITY % include.historic "IGNORE">
<!ENTITY % no.include.historic "IGNORE">
@


1.1.2.4
log
@SVN rev 241122 on 2012-10-02 06:37:46Z by gabor

MFC r241096:
  - Rename .sgml files to .xml to track the recent doc changes
@
text
@d21 1
a21 1
    <pubdate>$FreeBSD: src/release/doc/en_US.ISO8859-1/installation/article.sgml,v 1.1.2.3 2012/09/18 16:49:57 gjb Exp $</pubdate>
@


1.1.2.2.2.1
log
@SVN rev 239080 on 2012-08-05 23:54:33Z by kensmith

Copy stable/9 to releng/9.1 as part of the 9.1-RELEASE release process.

Approved by:	re (implicit)
@
text
@@


1.1.2.2.2.2
log
@SVN rev 240710 on 2012-09-19 21:44:39Z by gjb

- Fix release notes build on releng/9.1 [1]
- MFC r240508, r240516, r240519 (gabor):
  o Update releng/9.1/release/doc files post-XML conversion.
  o This commit fixes most of the 9-STABLE release build problems.
- Close colspec tags to conform to XML standards. [1]
- Convert installation article to XML stanards. [1]

[1] - These are direct commits to releng/9.1

Approved by:	re (hrs)
@
text
@d1 3
a3 4
<?xml version="1.0" encoding="iso-8859-1" standalone="no"?>
<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V4.2-Based Extension//EN" [
<!ENTITY % entities PUBLIC "-//FreeBSD//ENTITIES DocBook FreeBSD Entity Set//EN">
%entities;
a6 5

<!-- Text constants which probably don't need to be changed.-->

<!ENTITY % include.historic "IGNORE">
<!ENTITY % no.include.historic "IGNORE">
@


1.1.2.2.2.3
log
@SVN rev 241445 on 2012-10-11 15:49:42Z by gabor

MFC r241096:
  - Rename files to track the XML migration in the doc tree and make the
    release notes build again

Approved by:	re (hrs)
@
text
@d21 1
a21 1
    <pubdate>$FreeBSD: src/release/doc/en_US.ISO8859-1/installation/article.sgml,v 1.1.2.2.2.2 2012/09/19 21:44:39 gjb Exp $</pubdate>
@


1.1.2.2.2.4
log
@## SVN ##
## SVN ## Exported commit - http://svnweb.freebsd.org/changeset/base/243705
## SVN ## CVS IS DEPRECATED: http://wiki.freebsd.org/CvsIsDeprecated
## SVN ##
## SVN ## ------------------------------------------------------------------------
## SVN ## r243705 | hrs | 2012-11-30 16:15:35 +0000 (Fri, 30 Nov 2012) | 18 lines
## SVN ##
## SVN ## - Bump versions and revert XML migration of the release documents in
## SVN ##   releng/9.1 branch.  The doc tree release/9.1.0 for this release still uses
## SVN ##   SGML toolchain[1].
## SVN ##
## SVN ## - Add SVNROOT{BASE,SRC,DOC,PORTS} for subversion repository URLs and
## SVN ##   BRANCH{SRC,DOC,PORTS} for the branches to generate-release.sh, and
## SVN ##   remove -p, -r, -d options.  The revision to be built should be specified
## SVN ##   in the URL.
## SVN ##
## SVN ## - Add {WORLD,KERNEL}_FLAGS to generate-release.sh.  These were supported in
## SVN ##   the old release build framework.
## SVN ##
## SVN ## - Disable to use binary package for docproj port during a release build.
## SVN ##   This package should be built successfully.
## SVN ##
## SVN ## Pointy hat to:	hrs [1]
## SVN ## Approved by:	re (implicitly)
## SVN ##
## SVN ## ------------------------------------------------------------------------
## SVN ##
@
text
@d1 4
a4 3
<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook V4.1-Based Extension//EN" [
<!ENTITY % articles.ent PUBLIC "-//FreeBSD//ENTITIES DocBook FreeBSD Articles Entity Set//EN">
%articles.ent;
d8 5
d21 1
a21 1
    <pubdate>$FreeBSD: releng/9.1/release/doc/en_US.ISO8859-1/installation/article.sgml 243705 2012-11-30 16:15:35Z hrs $</pubdate>
@