Home

Welcome

Welcome to Katana!

What is Katana?

Katana is a fork of Buildbot. With Katana we have taken the Buildbot CI framework, and extended it to add a slick UI, support for realtime page updating with Autobahn, and many other things.

Getting Started with Katana

Katana can be set up mostly like a Buildbot instance, with a few differences. However, not all users trying to get started with Katana are familiar with Buildbot, so we will try to get you up and running with some simple examples.

Installing Pre-Requisites

Here, we assume you are starting with Ubuntu Server as your host OS. If you are not, you will need to adjust accordingly, but use this as an example:

#!/usr/bin/bash

sudo apt-get update
sudo apt-get install build-essential
sudo apt-get install python-dev

curl -O http://pypi.python.org/packages/2.7/s/setuptools/setuptools-0.6c11-py2.7.egg and sudo sh setuptools-0.6c11-py2.7.egg
sudo easy_install virtualenv
virtualenv --no-site-packages ~/buildbot-venv

source ~/buildbot-venv/bin/activate
pip install -Iv SQLAlchemy-migrate==0.7.2, there are compatibility issues between versions
pip install -Iv SQLAlchemy==0.7.9
apt-get install libmysqlclient-dev
pip install mysql-python
pip install MySQL-python
# Install the slave: pip install buildbot, running buildbot --version should display the version installed