Winter 2011 Handout - Koji Setup Documentation

Status

This page status is: DRAFT.

Title

Koji Setup Documentation

Participants

Todd Westacott

Introduction

Many people are interested in setting up a Koji Build System to test software packages on different architectures. Most of these people will turn to the Koji documentation on the Fedora wiki for guidance but find it hard to follow when they run into problems. This project addressed the need to provide a better explanation as to how someone with very little exposure to Koji could setup their own build system. The goal of the project was to test the setup process which was already documented and ensure that all of the steps work and will result in a working Koji Build System.

Approach

My approach to this project was to walk through the process of setting up a complete Koji Build System on the CDOT machines to test if the existing documentation worked and was correct. The intention was to make notes along the way of what steps worked well and which ones did not work. If a step did not work correctly I would turn to the Koji community and the internet for help. Once I found the correct step I would document it. I would also make note of any steps which were unclear and needed to be explained further. Once the Koji Build System was complete I would have a complete set of steps which I know will work. As an added measure I was also able to obtain some notes from Paul Whalen who setup the existing Koji Build System on Hong Kong and from Anthony Boccia who is working on a related project to migrate the existing Koji Build System to the Open RD system.