Building Revisor from Source

This document describes how you can build Revisor from source

Note

This document has a more recent version at http://fedorahosted.org/revisor

Requirements

Revisor was developed for Fedora 7 or later. Backwards compatibility with Fedora Core 6 has never really been an option for us, because of major changes to pungi, pykickstart, system-config-kickstart, anaconda, anaconda-runtime and other tools Revisor depends upon.

Build Requirements

To build Revisor from the source, you will need to following software installed:

automake
autoconf
intltool
glib
glib2-devel
gettext
python

And, in addition, if you want to build the RPM:

rpmdevtools
rpm-build

If you do not yet have these tools installed, run:

$ su -c 'yum -y install git automake autoconf gettext intltool glib glib2-devel rpmdevtools rpm-build'

Runtime Requirements

Additional requirements for Revisor and it's modules are:

pygtk2 >= 2.9.2
pygtk2-libglade
yum >= 3
comps-extras
rhpl
system-config-kickstart
gnome-python2-gconf
notify-python
pungi
livecd-tools
usermode
pam
db4

If any of these are not installed, you cannot run Revisor or one of it's modules. To install, run:

$ su -c 'yum -y install pygtk2 pygtk2-libglade yum comps-extras rhpl system-config-kickstart gnome-python2-gconf notify-python pungi livecd-tools usermode pam db4'

Requirements for Revisor Modules

To be able to run the plugins for Revisor, use:

$ su -c 'yum -y install cobbler koan deltarpm python-virtinst jigdo'

Getting the Source

The Revisor Source Repository is a git repository, so you'll need the git suite installed:

$ su -c 'yum -y install git'

To clone the git repository, use:

$ git clone git://git.fedorahosted.org/git/revisor/

If you can't connect to git over the git protocol/port, you can also use http:

$ git clone http://git.fedorahosted.org/git/revisor/

This will create a directory 'revisor' in the current directory. Before you run revisor, you need to build one of the glade files (enter the revisor/ directory first):

autoreconf [-v] # -v is optional
./configure

Then run revisor as root:

$ sudo ./revisor.py

Please note that it might complain about files missing. To be able to directly run Revisor from the source tree, symlink /etc/revisor to the conf/ directory in the source tree, and symlink /usr/share/revisor to the glade/ directory in the source tree. Below is an example of a user kanarip having cloned revisor in /home/kanarip/revisor. Navigate to that directory, and:

sudo ln -s $PWD/conf /etc/revisor
sudo mkdir -p /usr/share/revisor
sudo ln -s $PWD/glade /usr/share/revisor/ui
sudo ln -s $PWD/glade/pixmaps /usr/share/revisor/pixmaps
sudo ln -s $PWD/conf /usr/share/revisor/comps

Building the Source

To build the source enter the revisor source directory and execute the following commands:

autoreconf [-v] # -v is optional
./configure
rpmdev-setuptree
make srpm
make rpm

The end result is in your ~/rpmbuild directory.

Personal tools