--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/INSTALL Fri Sep 26 11:31:09 2003 -0400
@@ -0,0 +1,43 @@
+These instructions assume that you have the following working
+together: Web Server, database and Python. I personnaly used
+this configuration for my testing.
+
+- Apache Web Server (http://www.apache.org/). Currently, the
+ only to restrict access to your code, is to used the web server
+ authentification. With apache, I used the AuthType Basic and
+ Limit/require instruction for doing so.
+
+- PostgreSQL (http://www.postgresql.org). I try to make my code
+ SQL-92 compliant but currently, only test it on PostgreSQL. The
+ code can show strange behavior and be corrupt especially if your
+ server doesn't support transaction on UPDATE. Also, the DB must
+ have a Python DBAPI-2.0 interface.
+
+- Python (http://www.python.org). I used a python installation 2.1
+ with some basic modules:
+ - htmltmpl (http://htmltmpl.sourceforge.net/). A simple HTML
+ template system. I always think I should upgrade to a more
+ powerful one but htmltmpl really simply do the job.
+ - pygresql (http://www.pygresql.org/). A Python DBAPI-2.0
+ interface to postgresql. I think any other DBAPI-2.0 compliant
+ module will do it with only small modifications.
+
+--
+xbelweb installation
+(after untar/unzip the distribution file to a temporary location...)
+
+1. Move the python code into a repertory where the web server will serve
+ the CGI.
+
+2. Tell the web server to serve only CGI .py from the root directory
+ of the application. The lib and inc directory content should not
+ be used. Add any authorization you need.
+
+3. Create a database for xbelweb (e.g., "xbelweb"), then create the
+ tables in the database used by xbelweb using the
+ ./lib/db/create_db.[your database] definition. I do it with
+ psql -U php < create_db.postgresql
+
+4. Update the lib/config.py file to reflect your db configuration.
+
+