The Wayback Machine - https://web.archive.org/web/20100718080905/http://en.opensuse.org:80/SDB:System_upgrade
Home Wiki > SDB:System upgrade
Sign up | Login

SDB:System upgrade

tagline: From openSUSE

Documentation > Package management:
Package repositories - Additional package repositories - KDE repositories - GNOME repositories - LXDE repositories - Add package repositories
This guide shows how to use Zypper to do a live distribution upgrade of openSUSE. Doing a live-upgrade has many advantages but at the same time a major disadvantage.

Among the advantages are:

  • You only download the packages that need to be upgraded, thus using a lot less bandwidth.
  • During the upgrade you can still use your workstation; the only downtime will be the reboot after the upgrade.
  • You don’t have to waste a DVD, nor do you need a DVD writer.
  • It’s cool.

The disadvantages:

  • If for any reason the upgrade is interrupted (i.e: power outages, network disconnect) and the process can't continue, you could be left with a broken system (that depends on where the process stopped of course).
  • If you have multiple systems to upgrade, you use bandwidth each time, so it might be more interesting to download a DVD.
Version:
11.2+
Starting with openSUSE 11.2, a live upgrade from the prior version is officially supported. This allows to perform a complete operating system update in place, without reloading everything from scratch.


Contents

Summary

This page explains how to run a tool or a series of command line steps to upgrade your system to the latest version of openSUSE.

Supported scenarios

Be aware that in principle, this update process is considered “best effort” only. This means that due to some third-party packages and the myriad of possible configurations, it is possible for some combinations to cause failure upon upgrade.

It is very important that all important data is backed up prior to beginning the upgrade process.

The following scenarios are the two options available:

  1. Command line – using Zypper.
  2. Graphical tool – using YaST.

Prepare your installation

The supported starting point is the last openSUSE release with all current updates applied. The following steps show you how to update your openSUSE distribution to the current packages before upgrading to the next version.

Command line

1. Check if the update repository already exists and is enabled.

 zypper repos --uri
Check if http://download.opensuse.org/update/11.2/ (replace 11.2 with your version) exists in one of the URI column values, and Yes in column Enabled, like the example below,
 #  | Alias           | Name            | Enabled | Refresh | URI
 ---+-----------------+-----------------+---------+---------+---------------------------------------
 1  | repo-update     | repo-update     | Yes     | Yes     | http://download.opensuse.org/update/11.2/
If column Enabled says No, enable it by issuing this command,
 zypper modifyrepo --enable repo-update
where ‘repo-update’ is the name of the update repository.
If it exists and has been enabled, continue to step 3.

2. Add update-repository.

 zypper addrepo --check --name 'openSUSE-11.2-Update' http://download.opensuse.org/update/11.2/ repo-update
Replace 11.2 with your version

3. Update system to the latest packages.

 zypper refresh
 zypper update

For more information, read Zypper Usage.

Graphical tool

See YaST Online Update.

Running the Upgrade

The following steps will show you how to upgrade your openSUSE distribution to the next released version (eg. 11.2 -> 11.3).

Command line

Using for example the update from 11.2 -> 11.3 here:

  • Disable all existing pre-openSUSE 11.3 repositories,
 zypper modifyrepo --all --disable
  • Add the new openSUSE 11.3 repositories,
 zypper addrepo --name "openSUSE-11.3 OSS" http://download.opensuse.org/distribution/11.3/repo/oss/ repo-11.3-oss
 zypper addrepo --name "openSUSE-11.3 Non-OSS" http://download.opensuse.org/distribution/11.3/repo/non-oss/ repo-11.3-non-oss
 zypper addrepo --name "openSUSE-11.3 Updates" http://download.opensuse.org/update/11.3/ repo-11.3-update
The last argument sets an alias (a shorthand), you can also choose another alias for the new repositories in the above command.
  • Search for updated openSUSE 11.3 compatible third-party repositories that you used before and add them.
Warning: Use with caution. Using third-party repositories could increase the chances that the upgrade will not complete correctly.
 zypper addrepo --name <name> <url> <alias>      # or:
 zypper ar <url.repo>                            # if you have URL of a .repo file


  • Now execute the full distribution updgrade.
 zypper ref
 zypper dup
With the above command zypper will download the required packages when it installs them. To download all packages in advance, use:
 zypper dup --download "in-advance"

If you did the above dist upgrade before the official release date (eg. 15.07.2010 for 11.3), you may have installed a Release Candidate (RC) or milestone version and will need to repeat the final zypper dup step now to receive the final release.

In addition, zypper dup can be run from time to time to ensure you have the latest available packages from the various repositories that you have enabled. YOU (Yast Online Update) only addresses security updates from the official repositories.

Graphical tool

There is a YaST module called Wagon to run the distribution upgrade with a graphical user interface (GUI).

Keep in mind that the Wagon update is less tested than the command line method described above.

Here is a quick walkthrough the 11.2->11.3 upgrade with Wagon:

  • ensure you have yast2-wagon installed
  • make sure you have only 11.3 repositories enabled
  • start "YaST2 wagon" or use the YaST control center
  • follow the dialogs
  • reboot

Sub-features