-
Installing Deliverance
last modified January 25 by miohtama
Quickstart
Per Ian, this is the place to start: http://deliverance.openplans.org/quickstart.html
Per Veda: Several people on Mac OSX have indicated that they've been able to get started pretty easily, but installing the libraries isn't always painless. I ran into an error "The following dependencies failed to build: py25-hashlib py25-setuptools py25-zlib" while trying to install lxml that was resolved by rerunning this command:
sudo port install py25-lxml
Also, upon running this command, DelivTest/bin/pyinstall.py http://deliverance.openplans.org/dist/Deliverance-snapshot-latest.pybundle, I received this error: svn: '/var/folders/YM/YMVPEkryGc0oFozQ5cmn-k+++TI/-Tmp-/pyinstall-BXos3J-build/src/deliverance' is not a working copy. I resolved this by:
To get around this, you can run the following command, making sure to use the easy_install from your virtualenv, so bin/easy_install (probably).
easy_install https://svn.openplans.org/svn/pyinstall/trunk
then, try the command:
DelivTest/bin/pyinstall.py http://deliverance.openplans.org/dist/Deliverance-snapshot-latest.pybundle
It may also help to save this bit locally, then point to it on your local machine so you don't have to do such a large download each time you try to get this running:
http://deliverance.openplans.org/dist/Deliverance-snapshot-latest.pybundle
As it turns out, my libxml didn't want to install correctly, but setting the PATH explicitly helped:
[bash: ~/DelivTest] export PATH=/opt/local/bin:$PATH:/usr/local/bin
The output I was trying to achieve was this:
[bash: ~/DelivTest] which xml2-config /opt/local/bin/xml2-config
After that, I could run this to successfully set up my libxml.
[bash: ~/DelivTest] bin/pyinstall.py ~/Deliverance-snapshot-latest.pybundle
The quickstart instructions also suggest using paster to create a Deliverance template, but my DelivTest didn't come with paster in the bin directory, so I had to run this to set up a localized version of it:
[bash: ~/DelivTest] ./bin/easy_install PasteScript
Running "which paster" indicated that it was still trying to use my system paster, so it's important to make sure you've got the right one, e.g.
[bash: ~/DelivTest] /bin/paster create -t deliverance DelivTest
Presto!
If the above instructions don't work for some reason: ie, you get the /tmp error trying to compile Deliverance these instructions via Kees Hink work:
# Get development libraries (i'm on Ubuntu)
sudo apt-get install libxml2-dev libxslt1-dev
# sudo apt-get install libxml-dev libxslt-dev # Old ubuntus
# Create virtualenv
virtualenv --no-site-packages deliverance_svn
cd deliverance_svn# Install latest version of setuptools to prevent error "global name 'log' is not defined"
. bin/activate
easy_install -U setuptools# We need to install httplib2 manually, as its PyPi download link is broken
easy_install http://httplib2.googlecode.com/files/httplib2-0.4.0.tar.gz
deactivate# Checkout deliverance from svn
svn co http://codespeak.net/svn/z3/deliverance/trunk/ deliverance
cd deliverance
# Install deliverance
../bin/python setup.py install# Install paster in virtualenv
../bin/easy_install PasteScript
cd ..# Create deliverance instance
./bin/paster create -t deliverance DelivTest# Answer the questions...
./bin/deliverance-proxy DelivTest/etc/deliverance.xmllink: http://keeshink.blogspot.com/2009/03/installing-deliverance.html
Older Instructions
To install Deliverance manually, it is recommeded that you first get virtualenv and create a working environment for Deliverance and its dependencies:
virtualenv deliverance_env source deliverance_env/bin/activate
Checkout and setup Deliverance, then make sure your installation is complete by running the tests:
svn co http://codespeak.net/svn/z3/deliverance/trunk deliverance cd deliverance python setup.py develop nosetests
You can also run the tests like this:
deliverance_env/bin/deliverance-tests deliverance_env/bin/deliverance-speed
If you intend to use the Deliverance Proxy, you should also
easy_install PasteScript
Your miliage may vary depending on platform, for OS X in particular. If you encounter segfaults or other strange failures, installing recent versions of libxml2, libxslt and lxml may help. Also see Martin Aspeli's manual setup steps
The easiest way to get Deliverance and recent versions of libxml2, et al installed is to checkout the buildout and follow the instructions in ./deliverance/README.txt
svn co http://codespeak.net/svn/z3/deliverance/buildout/trunk deliverance.buildoutYou may also find Martin Aspeli's Deliverance Buildout Recipe and instructions useful
on to
using the proxy