docs for dapper upgrade?

[Mathias Gug]

Hi Adam,

On Mon, Feb 04, 2008 at 11:12:18AM -0500, Adam Sommer wrote:
> Attached is a diff adding an "Upgrading" section under the Installation
> section.  Basically it gives an overview of the do-release-upgrade command
> and why to use it.  If it looks good to everyone I'll go ahead and commit
> it.
  
> === modified file 'generic/server/C/installation.xml'
> --- generic/server/C/installation.xml	2007-12-12 17:17:38 +0000
> +++ generic/server/C/installation.xml	2008-02-04 16:03:38 +0000
> @@ -312,4 +312,42 @@
>  </screen>
>        </sect2>
>      </sect1>
> +    <sect1 id="installing-upgrading" status="review">
> +      <title>Upgrading</title>
> +      <para>
> +      There are several ways to upgrade from one Ubuntu release to another.  This section gives an overview of the supported upgrade method.
> +      </para>

I'd mention that although dist-upgrade is available, it shouldn't be
used. We've seen some request on #ubuntu-server about fixing a
dist-upgrade failure. The basic answer is to use do-release-upgrade
instead of dist-upgrade.

People coming from a debian background are used to dist-upgrade.

> +	<para>
> +        Using <application>do-release-upgrade</application> is recommended is because it has the ability to handle one time
> +	configuration changes to the system.  For example, the <application>evms</application> package needed to be removed when 
> +	upgrading from Ubuntu 7.06 to Ubuntu 7.10.  If the package was not removed during the upgrade the system could be left in
> +	a non-bootable state.
> +	</para>

I wouldn't explain why do-release-upgrade is better.

> +	<para>
> +	It is also possible to use <application>do-release-upgrade</application> to upgrade to a development version of 
> +	Ubuntu.  To accomplish this use the <emphasis>-d</emphasis> switch:
> +	</para>
> +<screen>
> +<command>do-release-upgrade -d</command>
> +</screen>
> +	<warning>
> +	  <para>
> +	  Upgrading to a development release is <emphasis>not</emphasis> recommended for production environments.
> +	  </para>
> +	</warning>

I like the mention about upgrading to the development version of Ubuntu.

-- 
Mathias Gug
Ubuntu Developer  http://www.ubuntu.com