Package unblocking SOP

This page is deprecated
All Fedora Release Engineering Documentation has moved here with source hosted along side the code in the releng pagure repository

Description

Packages are sometimes unblocked from Fedora, usually when a package had been orphaned and now has a new owner. When this happens, release engineering needs to "unblock" the package from koji tags.

Action

Find Unblock requests

Unblock requests are usually reported in the rel-eng trac instance at Fedorahosted in the component koji. You can use a trac query to list all unassigned Koji tickets. This query also includes requests, that are not an unblock request, because there is no automated way to distinguish them. The results of the query are also available as an RSS feed, the link is in the footer of the page.

Perform the unblocking

First assign the ticket to yourself to show, that you are handling the request.

Discover proper place to unblock

The ticket should tell you which Fedora releases to unblock the package in. Typically it'll say "Fedora 13" or "F14". This means we need to unblock it at that Fedora level and all future tags. However depending on where the package was blocked we may have to do our unblock action at a different Fedora level.

To discover where a package is blocked, use the list-pkgs method of koji.

$ koji list-pkgs --help
Usage: koji list-pkgs [options]
(Specify the --help global option for a list of other help options)

Options:
  -h, --help         show this help message and exit
  --owner=OWNER      Specify owner
  --tag=TAG          Specify tag
  --package=PACKAGE  Specify package
  --quiet            Do not print header information
  --noinherit        Don't follow inheritance
  --show-blocked     Show blocked packages
  --show-dups        Show superseded owners
  --event=EVENT#     query at event
  --ts=TIMESTAMP     query at timestamp
  --repo=REPO#       query at event for a repo

For example if we wanted to see where python-psco was blocked we would do:

$ koji list-pkgs --package python-psyco --show-blocked
Package                 Tag                     Extra Arches     Owner          
----------------------- ----------------------- ---------------- ---------------
python-psyco            dist-f14                                 konradm         [BLOCKED]
python-psyco            olpc2-ship2                              shahms         
python-psyco            olpc2-trial3                             shahms      
...

Here we can see that it was blocked at dist-f14. If we got a request that was to unblock it before f14, we can simply use the dist-f14 target to unblock. However if they want it unblocked after f14, we would use the earliest dist-f?? tag the user wants, such as dist-f15 if the user asked for it to be unblocked in Fedora 15+

Performing the unblock

To unblock a package for a tag, use the unblock-pkg method of Koji.

$ koji unblock-pkg --help
Usage: koji unblock-pkg [options] tag package [package2 ...]
(Specify the --help global option for a list of other help options)

Options:
  -h, --help  show this help message and exit

For example, if we were asked to unblock python-psyco in F14 we would issue:

$ koji unblock-pkg dist-f14 python-psyco

Now the ticket can be closed.

Verification

To verify that the package was successfully unblocked use the list-pkgs koji command:

$ koji list-pkgs --package python-psyco --show-blocked

We should see the package listed as not blocked at dist-f14 or above:

Package                 Tag                     Extra Arches     Owner          
----------------------- ----------------------- ---------------- ---------------
python-psyco            olpc2-trial3                             jkeating       
python-psyco                   olpc2-ship2                              jkeating       
python-psyco                   olpc2-update1                            jkeating       
python-psyco                   trashcan                                 jkeating       
python-psyco                   f8-final                                 jkeating       
...

We should not see it listed as blocked in dist-f14 or any later Fedora tags.

Consider Before Running

• Watch the next day's rawhide/branched/whatever report for a slew of broken deps related to the package. We may have to re-block the package in order to fix the deps.