Installation

Here, setting up django-productline in ape’s container mode is described. This way, you can testdrive or develop multiple product lines isolated from the rest of your system.

If all you need is to deploy a single product, you can also use ape in standalone mode, as described here.

First, make sure virtualenv is installed. On Debian/Ubuntu you can install it like so:

$ sudo apt-get install python-virtualenv

Then, create a new ape container environment and install django-productline and all dependencies:

$ wget -O - https://raw.github.com/henzk/django-productline/master/bin/install.py | python - webapps

For the development version, use:

$ wget -O - https://raw.github.com/henzk/django-productline/master/bin/install.py | python - --dev webapps

This will create a new folder called webapps with the following structure:

webapps/
    _ape/
        venv/
        activape

Note

this is a completely self contained installation. To get rid of everything or to start over, simply delete the webapps folder.

Congratulations, the installation is now complete!

SPL (software product line) containers can now be placed into the webapps directory. Folder venv contains a virtualenv that is isolated from the system (created with the --no-site-packages option). ape and its dependencies have been installed there. If you want to use system packages, either recreate the virtualenv without the --no-site-packages option and install ape into it or put the system packages back on sys.path using softlinks, .pth files, or path hacking.

Note

--no-site-packages is the default in newer versions of virtualenv. To use system packages the flag --system-site-packages needs to be specified.

To activate container mode, change into the webapps directory and issue the following commands:

$ . _ape/activape

Under the hood, this takes care of setting some environment variables and activating the virtualenv.