|Version 29 (modified by pferreir, 3 years ago) (diff)|
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+
- setuptools 0.6 - older versions of Python (<=2.4)
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're building indico from the development source, please easy_install jstools first. Since easy_install fetches all the other dependencies automatically, just install libxml2, libxslt (both with Python bindings) and ReportLab manually, and jump to the next section.
This is the complete list of dependencies (if for some reason you need to install them manually):
- ZODB 3 (3.7 at least, but 3.8+ recommended) ;
- jstools (build-only)
- libxml2 and libxslt
There are two options:
- Fetching a release tarball - get it here (still not available);
- Checking out a Git tree (development sources);
You should have checked out a cds-indico directory. cd into it and simply do (as root):
# python setup.py install
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.
By the end of the process, you should have obtained some information on how to start the database:
If you are running ZODB on this host: - Review etc/zodb.conf and etc/zdctl.conf to make sure everything is ok. - To start the database run: zdaemon -C etc/zdctl.conf start
As well as some information on the paths:
indico.conf: /opt/indico/etc/indico.conf BinDir: /opt/indico/bin DocumentationDir: /opt/indico/doc ConfigurationDir: /opt/indico/etc HtdocsDir: /opt/indico/htdocs
Then you should configure Apache HTTPD, by adding the following lines to your httpd configuration file:
PythonInterpreter main_interpreter PythonImport MaKaC::setEnvironment main_interpreter <Directory "/your/htdocs"> AddHandler python-program .py PythonHandler mod_python.publisher Allow from All </Directory> <Directory "/your/htdocs/services"> SetHandler python-program PythonHandler MaKaC.services.handler PythonInterpreter main_interpreter Allow from All </Directory> Alias /indico/images "/your/htdocs/images" Alias /indico "/your/htdocs"
(/your/htdocs should be the same as HtdocsDir, mentioned above)
Accessing http://localhost/indico/index.py should give you the main Indico page.
The next step should be inspecting indico.conf and configuring it to fit your server configuration.