Source

streamtar / INSTALL.txt

============================
streamtar Installation Guide
============================

Installation
============

Installation on Windows
-----------------------

There's no installation. Just copy ``example-server.bat`` to a new file,
edit the environment variables set in it, and then run the new script!


Installation on DreamHost
-------------------------

TODO


Installation on Linux and BSD
--------------------------------

First, make sure you have sudo or root access. Then create and edit
``/usr/lib/python2.5/distutils/distutils.cfg`` and add the following:

    [install]
    prefix = /usr/local

    [easy_install]
    site_dirs = /usr/local/lib/python$py_version_short/site-packages

Note: It's a good idea to have this file for every installation of Python
on your system.

Now download http://peak.telecommunity.com/dist/ez_setup.py and run it
with the your choice of Python version::

    $ sudo python2.5 ez_setup.py

Now installation is as simple as running one command::

    $ sudo python2.5 setup.py install

If you want FastCGI support, run this after installing streamtar::

    $ sudo easy_install-2.5 streamtar[fastcgi]

For standalone HTTP server support::

    $ sudo easy_install-2.5 streamtar[standalone]


Configuration
=============

Configuring lighttpd with FastCGI
---------------------------------

Getting prerequisite software under Debian
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

First, make sure you have sudo or root access. Then Install lighttpd::

    $ sudo apt-get install lighttpd


Configuring lighttpd
~~~~~~~~~~~~~~~~~~~~

TODO


Configuring Apache with FastCGI
-------------------------------

Getting prerequisite software under Debian
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

First, make sure you have sudo or root access. Then Install ``apache2`` and
``libapache2-mod-fastcgi``::

    $ sudo apt-get install apache2
    $ sudo apt-get install libapache2-mod-fastcgi

You'll also need FastCGI support in ``streamtar``::

    $ sudo easy_install-2.5 streamtar[fastcgi]

Note: This command only works *after* you've installed ``streamtar``.


Configuring Apache
~~~~~~~~~~~~~~~~~~

TODO