Before you begin

Make sure that you read the list of annoying bugs for the new version you are going to install. Some of them could affect the update process. Usually, some solution or workaround is listed alongside the bug, so make sure that you are prepared for upcoming problems.

Also, read the Release Notes which list changes and glitches in the new release.

Upgrading from the command line

The following steps show how to upgrade to 15.3:

1. Update the repos

Check if your Leap repos defined in /etc/zypp/repos.d/ are using the $releasever variable already. If they are still hard-coded with a particular Leap version number, then you need to modify them first. For example, assuming your current version is Leap 15.2, then this can be done with

sudo sed -i 's/15.3/${releasever}/g' /etc/zypp/repos.d/*.repo

2. Refresh with the new repos

Switch and refresh all repositories to 15.3

# zypper --releasever=15.3 refresh

3. Execute the full distribution upgrade

Now execute the full distribution upgrade.Warning: It is strongly recommended that you run the upgrade outside the X-window graphical mode. Thus it is recommended you run the command from either runlevel 3 (text + network), or a virtual console. Unfortunately many times the WIFI connection is managed/available only in runlevel 5, so a virtual text console may be best while staying logged into the graphical console behind the scenes. People had their X session stopped/crashed during the upgrade, causing the upgrade to abort, which in turn left the system in an inconsistent state. To change to runlevel 3, see SDB:Switch_runlevel. To remain in runlevel 5, but use a „virtual console“, type control-alt-F1 (as an example).

# zypper --releasever=15.3 dup --download-in-advance --auto-agree-with-licenses --allow-vendor-change

With the above command, zypper will download all packages in advance – which is more reliable if your internet connection may fail. To download packages in heaps and install them in heaps, use:

# zypper --releasever=15.3 dup

Once the dup is finished, openSUSE sets the releasever variable to the new version.If you did the above dist upgrade before the official release date (eg.2021-06-02 for Leap 15.3), you may have installed a Release Candidate (RC) or a milestone version and will need to repeat the final zypper dup step now to receive the final release.

4. Reboot

After upgrading, a reboot is recommended to start the new kernel and newer versions of everything.

5. Add extra repositories

Search for updated openSUSE Leap 15.3 compatible third-party repositories that you used before — if you still need them — and add them.Warning: Use with caution. Using third-party repositories may break your system or cause instabilities.

zypper addrepo --name <name> <url> <alias>

Or, if you have URL of a .repo file:

# zypper ar <url.repo>

Executing zypper up may be enough to update your software from these extra repositories.

6. Afterwards

Discover and enjoy :)In addition, zypper up 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.