INSTALL
author fabien
Sun, 26 Oct 2003 22:56:49 -0500
branchxbelweb
changeset 52 fe0d02f344cb
parent 28 f34f8083c1ed
child 65 b975a3d7606a
permissions -rw-r--r--
[svn r1609] Oops! Old code in remove_folders()
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
20
8c201fa3bdc7 [svn r1554] Installation instruction.
fabien
parents:
diff changeset
     1
These instructions assume that you have the following working
8c201fa3bdc7 [svn r1554] Installation instruction.
fabien
parents:
diff changeset
     2
together: Web Server, database and Python.  I personnaly used
8c201fa3bdc7 [svn r1554] Installation instruction.
fabien
parents:
diff changeset
     3
this configuration for my testing.
8c201fa3bdc7 [svn r1554] Installation instruction.
fabien
parents:
diff changeset
     4
8c201fa3bdc7 [svn r1554] Installation instruction.
fabien
parents:
diff changeset
     5
- Apache Web Server (http://www.apache.org/).  Currently, the
8c201fa3bdc7 [svn r1554] Installation instruction.
fabien
parents:
diff changeset
     6
  only to restrict access to your code, is to used the web server
8c201fa3bdc7 [svn r1554] Installation instruction.
fabien
parents:
diff changeset
     7
  authentification.  With apache, I used the AuthType Basic and
8c201fa3bdc7 [svn r1554] Installation instruction.
fabien
parents:
diff changeset
     8
  Limit/require instruction for doing so.
8c201fa3bdc7 [svn r1554] Installation instruction.
fabien
parents:
diff changeset
     9
8c201fa3bdc7 [svn r1554] Installation instruction.
fabien
parents:
diff changeset
    10
- PostgreSQL (http://www.postgresql.org).  I try to make my code
8c201fa3bdc7 [svn r1554] Installation instruction.
fabien
parents:
diff changeset
    11
  SQL-92 compliant but currently, only test it on PostgreSQL.  The
8c201fa3bdc7 [svn r1554] Installation instruction.
fabien
parents:
diff changeset
    12
  code can show strange behavior and be corrupt especially if your
8c201fa3bdc7 [svn r1554] Installation instruction.
fabien
parents:
diff changeset
    13
  server doesn't support transaction on UPDATE.  Also, the DB must
8c201fa3bdc7 [svn r1554] Installation instruction.
fabien
parents:
diff changeset
    14
  have a Python DBAPI-2.0 interface.
8c201fa3bdc7 [svn r1554] Installation instruction.
fabien
parents:
diff changeset
    15
8c201fa3bdc7 [svn r1554] Installation instruction.
fabien
parents:
diff changeset
    16
- Python (http://www.python.org).  I used a python installation 2.1
8c201fa3bdc7 [svn r1554] Installation instruction.
fabien
parents:
diff changeset
    17
  with some basic modules:
8c201fa3bdc7 [svn r1554] Installation instruction.
fabien
parents:
diff changeset
    18
  - htmltmpl (http://htmltmpl.sourceforge.net/).  A simple HTML
8c201fa3bdc7 [svn r1554] Installation instruction.
fabien
parents:
diff changeset
    19
    template system.  I always think I should upgrade to a more
8c201fa3bdc7 [svn r1554] Installation instruction.
fabien
parents:
diff changeset
    20
    powerful one but htmltmpl really simply do the job.
8c201fa3bdc7 [svn r1554] Installation instruction.
fabien
parents:
diff changeset
    21
  - pygresql (http://www.pygresql.org/).  A Python DBAPI-2.0
8c201fa3bdc7 [svn r1554] Installation instruction.
fabien
parents:
diff changeset
    22
    interface to postgresql.  I think any other DBAPI-2.0 compliant
8c201fa3bdc7 [svn r1554] Installation instruction.
fabien
parents:
diff changeset
    23
    module will do it with only small modifications.
28
f34f8083c1ed [svn r1562] Add the xbel-utils dependency.
fabien
parents: 20
diff changeset
    24
  - xbel-utils.  A part of python-xml to manipulate XBEL XML files.
f34f8083c1ed [svn r1562] Add the xbel-utils dependency.
fabien
parents: 20
diff changeset
    25
    Only necessary if you want the XBEL files import feature.
20
8c201fa3bdc7 [svn r1554] Installation instruction.
fabien
parents:
diff changeset
    26
8c201fa3bdc7 [svn r1554] Installation instruction.
fabien
parents:
diff changeset
    27
--
8c201fa3bdc7 [svn r1554] Installation instruction.
fabien
parents:
diff changeset
    28
xbelweb installation
8c201fa3bdc7 [svn r1554] Installation instruction.
fabien
parents:
diff changeset
    29
(after untar/unzip the distribution file to a temporary location...)
8c201fa3bdc7 [svn r1554] Installation instruction.
fabien
parents:
diff changeset
    30
8c201fa3bdc7 [svn r1554] Installation instruction.
fabien
parents:
diff changeset
    31
1. Move the python code into a repertory where the web server will serve
8c201fa3bdc7 [svn r1554] Installation instruction.
fabien
parents:
diff changeset
    32
   the CGI.
8c201fa3bdc7 [svn r1554] Installation instruction.
fabien
parents:
diff changeset
    33
8c201fa3bdc7 [svn r1554] Installation instruction.
fabien
parents:
diff changeset
    34
2. Tell the web server to serve only CGI .py from the root directory
8c201fa3bdc7 [svn r1554] Installation instruction.
fabien
parents:
diff changeset
    35
   of the application.  The lib and inc directory content should not
8c201fa3bdc7 [svn r1554] Installation instruction.
fabien
parents:
diff changeset
    36
   be used.  Add any authorization you need.
8c201fa3bdc7 [svn r1554] Installation instruction.
fabien
parents:
diff changeset
    37
8c201fa3bdc7 [svn r1554] Installation instruction.
fabien
parents:
diff changeset
    38
3. Create a database for xbelweb (e.g., "xbelweb"), then create the
8c201fa3bdc7 [svn r1554] Installation instruction.
fabien
parents:
diff changeset
    39
   tables in the database used by xbelweb using the
8c201fa3bdc7 [svn r1554] Installation instruction.
fabien
parents:
diff changeset
    40
   ./lib/db/create_db.[your database] definition.  I do it with
8c201fa3bdc7 [svn r1554] Installation instruction.
fabien
parents:
diff changeset
    41
   psql -U php < create_db.postgresql
8c201fa3bdc7 [svn r1554] Installation instruction.
fabien
parents:
diff changeset
    42
8c201fa3bdc7 [svn r1554] Installation instruction.
fabien
parents:
diff changeset
    43
4. Update the lib/config.py file to reflect your db configuration.
8c201fa3bdc7 [svn r1554] Installation instruction.
fabien
parents:
diff changeset
    44
8c201fa3bdc7 [svn r1554] Installation instruction.
fabien
parents:
diff changeset
    45