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.