openSUSE:Maintenance update process

Jump to: navigation, search

Maintenance requests are requests by packagers to release an update for an already released distribution. This page gives on overview of the process of handling these requests.


Knowing the process behind a maintenance release allows to understand the importance of the steps of the process and should help with submitting packages that can be quickly pushed through the process.

The following flow-chart diagram illustrates the maintenance package update process. It includes several different OBS projects: Maintenance update process.png

Let's look a bit closer at some of the steps:

Check if a Leap package is inherited from SLE

Some packages from openSUSE Leap are shared with SLE. Those packages are automatically merged after the SLE-update is released. To check if your package is inherited you can look in the following package:

openSUSE Leap 15.0:

 $osc less openSUSE:Leap:15.0:Update 00Meta lookup.yml


openSUSE Leap 42.3:

 $osc less openSUSE:Leap:42.3:Update 00Meta lookup.yml


Write a meaningful changelog-entry

For the maintenance team it's important, that a meaningful changelog-entry is provided to prepare the patch-documentation and rating. For a detailed description, please refer to the patches guideline, but here is a list of the most important information:

  • Bug reference (boo#123456, CVE-2016-1234,...)
  • short description for the fix
  • Added/modified/dropped patchnames

Open a maintenance request

After the package is ready to submit, you need to open a maintenance-request. You can achieve this with the following commands:

One package for one openSUSE release:

 $osc mr $prj $pkg $release_target

Several packages for one openSUSE release:

 $osc mr $prj $list $of $packages $release_target

Several packages for several openSUSE releases:

(This only works if your packages are in one project and the packages were branched with '$osc mbranch $pkg' or '$osc branch -M $prj $pkg')

 $osc mr $prj

Maintenance team review

The maintenance team decides whether an update will be released. They authorize the initiation of the maintenance process and start the ball rolling. They interact directly with the packager to coordinate the submission of the package that contains the fix. They ensure that the bugs being fixed are what are actually being put into the maintenance update. The decision making process is outlined in more detail below.

Source Review

The openSUSE review team does a manual review of the submission following these guidelines. Those of the review team who intend to review the maintenance submissions will find the SRs in each project's "Update" sub-project. For example, to review the submissions for openSUSE Leap 15.0, the reviewer would find the submissions in the "openSUSE:Leap:15.0:Update" project. (In reference to the graph above, note the differences between the "openSUSE:Maintenance" project and the "openSUSE:Leap:15.0:Update" project. Reviewers shouldn't be looking in the "openSUSE:Maintenance" project to do their reviews.)

QA review

openSUSE maintenance updates are tested with openQA and by our community. We are waiting around 7 days, to see if issues are reported, before we release the update.

If you want to test all pending updates, you need to register the following repository:

openSUSE Leap 15.0:

openSUSE Leap 42.3: