Migrating to Koji 1.10

The 1.10 release of Koji includes a few changes that you should consider when migrating.

DB Updates

The new tag_extra table tracks extra data for tags.

There is a new entry in the channels table and some additions and updates to the archivetypes table.

As in previous releases, we provide a migration script that updates the database.

# psql koji koji  </usr/share/doc/koji-1.10.0/docs/schema-upgrade-1.9-1.10.sql

Command line changes

A few commands support new arguments

maven-build
  • --ini : Pass build parameters via a .ini file
  • --section : Get build parameters from this section of the .ini
wrapper-rpm
  • --ini : Pass build parameters via a .ini file
  • --section : Get build parameters from this section of the .ini
import
  • --link : Attempt to hardlink instead of uploading
list-tagged
  • --latest-n: Only show the latest N builds/rpms
list-history
  • --watch : Monitor history data
edit-tag
  • --extra : Set tag extra option
list-tasks
  • --user : Only tasks for this user
  • --arch : Only tasks for this architecture
  • --method : Only tasks of this method
  • --channel : Only tasks in this channel
  • --host : Only tasks for this host
download-build
  • --task-id : Interpret id as a task id

And there are three new commands

  • image-build-indirection
  • maven-chain
  • runroot

Other Configuration changes

The Koji web interface can now treat extra-footer.html as a Cheetah template. This behavior can be enabled by setting the LiteralFooter option to False in the kojiweb config.

RPC API Changes

The readTaggedBuilds and readTaggedRPMS now treat an integer value for the optional latest argument differently. Before it was simply treated as a boolean flag, which if true caused the call to return only the latest build for each package. Now, if the value is a positive integer N, it will return the N latest builds for each package. The behavior is unchanged for other values.

New rpc calls: chainMaven, buildImageIndirection, and mergeScratch