INSTALL
branchxbelweb
changeset 20 8c201fa3bdc7
child 28 f34f8083c1ed
--- /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.
+
+