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 -- ubuntu-server mailing list [email protected] https://lists.ubuntu.com/mailman/listinfo/ubuntu-server More info: https://wiki.ubuntu.com/ServerTeam
