Installing Indico

Only v0.97+

Before starting

Currently, Indico can only run on ​mod_python, using the ​Apache httpd server. Make sure you install them for your operating system (as well as Python, of course), if you don't have them yet. These are the recommended versions:

• Python 2.4+
• Apache httpd 2.2+
• mod_python 3.3+

Some older versions will probably work, but we cannot guarantee that everything goes fine. Regarding Python, don't hesitate to use 2.5 or 2.6 - we plan to move from 2.4 soon, anyway. If you plan to use easy_install (and we recommend that you do so, specially if you are installing everything from scratch), you may install ​setuptools (0.6c9+), otherwise Indico will download it for you.

Dependencies

Indico can be installed either through easy_install or running directly setup.py. We recommend easy_install (it's much easier for fresh installs), but you can choose whichever method suits your needs.

easy_install

If you're using easy_install, just install ​libxml2, ​libxslt (both with Python bindings) and ​ReportLab manually, and jump to the next section.

setup.py

If you're using setup.py, you have to manually install all the following dependencies:

• ​ReportLab;
• ​ZODB 3 (3.7 at least, but 3.8+ recommended) ;
• ​jstools
• ​pytz
• ​zope.index
• ​simplejson
• ​libxml2 and libxslt

Installing it

There are two options:

• Fetching a release tarball - get it here;
• Checking out a Git tree (development sources);

easy_install

from Git

You should have checked out a cds-indico directory. Simply do (as root, from the parent directory):

# easy_install cds-indico

Note: Since you are using a version from Git (not an official EGG/tar package), easy_install will ask for a version number. We normally use a cds-indico-git-YYYYmmdd convention.

easy_install will fetch all the dependencies for you and install Indico as a Python EGG in your Python library path.

The next step is to run indico_initial_setup:

# indico_initial_setup 
No previous installation of Indico was found.
Please specify a directory prefix:
[/opt/indico]: 

and follow the instructions that the script will provide. By default, Indico will be installed under /opt/indico, but the setup script allows you to specify other paths.