Djinni  2.2
Install

Before You Begin...

We don't like Autotools, but we have to admit that it's probably the best game in town right now. In the past we tried a CMake-based build system, but that turned out to create more problems than it solved.

That means you can do a simple ./configure && make && make install dance to install Djinni. Depending on your system you may need to use the --prefix and/or --with-boost arguments to ./configure.

You will need:

Boost 1.34 or later

Most installation troubles stem from not having the proper tools. Please make sure you're using the proper tools before you file a bug report.

Building the Perfect Beast

(... with apologies to Don Henley)

Once you've uncompressed Djinni into its own directory, it should just be a simple process of typing

./configure --prefix=install-path --with-boost=boost-root && make && make install

The process of building takes well under a minute on modern hardware.

Once the build completes and the installation finishes, you can find the Python libraries in the appropriate site-packages directory. E.g., if I used /export/home/rjh as my prefix and I'm running Python 2.5, I could find the libraries in /export/home/rjh/lib/python2.5/site-packages/djinni.

Make sure your PYTHONPATH environment variable is set correctly. E.g., using the bash shell I would type:

export PYTHONPATH=/export/home/rjh/lib/python2.5/site-packages

Once your PYTHONPATH variable is set, feel free to pop into src/examples and run gtk-salesman.py. If this application runs successfully, you can be confident Djinni is installed correctly.