Installing tramline
===================

Requirements
------------

* It needs Apache 2.0.55 or higher. Apache 2.0.54 and below do *not*
  work due to a bug in mod_proxy filter handling.

* You tend to need mod_proxy installed to proxy requests that come
  into Apache into your underlying appserver. It also works with
  mod_rewrite if you use proxying mode for this ([P]).

* mod_python, with the apache.py file patched so filter is not
  flushed. In mod_python/lib/python/apache.py, comment out
  'filter.flush()' in FilterDispatch.

Apache conf
-----------

* Enable mod_python.

* Then:

  PythonPath "sys.path+['/path/to/tramline/src']"
  PythonInputFilter tramline.core::inputfilter TRAMLINE_INPUT
  PythonOutputFilter tramline.core::outputfilter TRAMLINE_OUTPUT
  SetInputFilter TRAMLINE_INPUT
  SetOutputFilter TRAMLINE_OUTPUT

  Note that if tramline is installed as a Python package into the same
  Python installation as the one mod_python uses, the PythonPath line
  can go away.
