Hello,
>
> Agreed - It should be documented in the Server guide. Usually there is
> also a note in the Release Notes (it was the case for Gusty).
>
>
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.
--
Party On,
Adam
=== 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>
+ <sect2 id="do-release-upgrade" status="review">
+ <title>do-release-upgrade</title>
+ <para>
+ The recommended way to upgrade a Server Edition installation is to use the <application>do-release-upgrade</application> utility.
+ Part of the <emphasis>update-manager-core</emphasis> package, it does not have any graphical dependencies and
+ is installed by default.
+ </para>
+ <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>
+ <para>
+ To upgrade to a newer release, from a terminal prompt enter:
+ </para>
+<screen>
+<command>do-release-upgrade</command>
+</screen>
+ <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>
+ </sect2>
+ </sect1>
</chapter>
--
ubuntu-server mailing list
[email protected]
https://lists.ubuntu.com/mailman/listinfo/ubuntu-server
More info: https://wiki.ubuntu.com/ServerTeam
