Installing the ANGEL APPLICATION
System Requirements
- Mac OS X 10.4 or newer
- on other Unix-like systems, things are a bit more complicated:
- filesystem with support for extended file attributes (ext3 tested)
python 2.4 or newer
wxPython 2.8 or newer
- These systems seem to work:
Ubuntu 7.04 or newer
FreeBSD 6.0-RELEASE (GUI untested)
Debian GNU/Linux Etch 4.0 (without GUI)
Installation on Mac OS X
Download the application, unpack the archive and start the application by double-clicking. It will initialize a repository in your home directory (under ~/.angel-app), and generate a configuration file (~/.angelrc) automatically.
Installation on UNIX style systems
Under Linux, you must enable extended filesystem attributes by mounting your ext-filesystem with the option "user_xattr"!
Generally speaking, there are 3 ways to get Angel running on a Unix style system:
- bootstrap.py
- setup.py (requires setuptools)
- running directly from checkout
bootstrap.py $DESTINATIONDIR
This script can be called from the base directory of the checkout and takes the destination directory as parameter. It should install everything into that directory, by creating a virtual python installation, installing the required libraries etc. You should then be able to run (at least parts of) ANGEL by doing:
cd $DESTINATIONDIR/bin ./python ./master.py
You can uninstall it by running
rm -rf $DESTINATIONDIR
setup.py
This script is using setuptools and supports the standard command line option--prefix. This will most certainly fiddle with your existing python site-packages, so either set $PYTHONPATH to point somewhere else than normally or use a non-standard prefix.
running directly from checkout
This can be used only if all the required dependencies are correctly installed. This is mainly only useful for developers to lower the turnover time when debugging. See our guide for /Ubuntu
Library Dependencies
The setuptools-based installation downloads and installs the required libraries automatically. If for some reason you wish to do that by hand, here is the list of installed/required libraries:
Bob Ippolito's Python xattr module;
there are other xattr modules around which will _not_ work; - the current version (0.4) only supports Mac OS X 10.4, Linux 2.6+, FreeBSD 5.1+
wxPython for the GUI, at least version 2.8.6
Bundled with ANGEL APPLICATION, the twisted matrix library:
- get the current trunk from subversion (the latest release does not yet support WebDAV).
- you'll want to make some modifications to the twisted library, which have not made it into the distribution yet.
Bundled with ANGEL APPLICATION, ezPyCrypto (we also provide a stripped-down version);