vendor/tramline

view INSTALL.txt @ 47:9eb5c502df01

hgbundler init new CHANGES file
author Georges Racinet on ishtar.racinet.fr <georges@racinet.fr>
date Sat, 21 Jan 2012 22:23:52 +0100
parents 9d9f6733500e
children
line source
1 Installing tramline
2 ===================
4 Requirements
5 ------------
7 * It needs Apache 2.0.55 or higher. Apache 2.0.54 and below do *not*
8 work due to a bug in mod_proxy filter handling.
10 * You tend to need mod_proxy installed to proxy requests that come
11 into Apache into your underlying appserver. It also works with
12 mod_rewrite if you use proxying mode for this ([P]).
14 * mod_python, MAYBE with the apache.py file patched so filter is not
15 flushed. In mod_python/lib/python/apache.py, comment out
16 'filter.flush()' in FilterDispatch.
18 known GNU/Linux distributions where the patch is not needed and turns harmful
19 - Debian lenny
21 known distributions where the patch is needed:
22 - Debian etch
24 TODO: more reports
26 Apache conf
27 -----------
29 * Enable mod_python.
31 * Then:
33 PythonPath "sys.path+['/path/to/tramline/src']"
34 PythonInputFilter tramline.core::inputfilter TRAMLINE_INPUT
35 PythonOutputFilter tramline.core::outputfilter TRAMLINE_OUTPUT
36 SetInputFilter TRAMLINE_INPUT
37 SetOutputFilter TRAMLINE_OUTPUT
38 PythonOption tramline_path /path/to/tramline-storage
40 The last line defines where files should be put on your filesystem.
42 Note that if tramline is installed as a Python package into the same
43 Python installation as the one mod_python uses, the PythonPath line
44 can go away.
46 Example: Zope
47 -------------
49 This is an example configuration of how to run tramline for
50 *development purposes* with a local Apache and a local Zope 3.
52 * Make sure you have your Apache configured with 'rewrite' support.
53 An example:
55 ./configure --prefix=~/lib/apache2 --enable-rewrite
57 * In addition to what's described in the 'Apache Conf', you need to
58 set up your Rewrite rule. I assume that you have Zope 3 running
59 locally on 8080 and Apache running on 8000:
61 RewriteEngine On
62 RewriteRule ^/(/?.*) \
63 http://localhost:8080/++vh++http:localhost:8000/++/$1 [P,L]