RoKoFo Picture Gallery

Installation

Software in need:

• Debian GNU/Linux operating system
  (This is acutally a lie. It will work on any UNIX-like system supporting the following software components, but you wont find installation instructions here.
• Python 2.3 programming language
  Some features of version 2.3 get acutally used, so older is not possible
• PostgreSQL 7.4 data base
  Script creating the data structures will probably even work on 7.2, but changes are underway which require 7.4.
• Psycopg
  This is the database adapter for python which gets used. If you try hard, you'll find a beta version 2, which is not needed nor tested.
• 4suite XML tools
  Get the latest. I use a CVS version from 20041008.
• ImageMagick
  We need the "convert" command line tool.
• C compiler
  Something with POSIX thread support
• a Web server
  Apache will do. The only thing required at the moment is a "clean up" PATH_INFO variable passed to CGI scripts. So, I wont see double slashes nor %-encoded stuff.
• this stuff

Unpack the source. You have basically four parts there. The daemon dispatching the hard work, some python modules, the application and a script preparing the data base with the needed data structures.

Place the modules directory somewhere you like. Dont change the simple structure. The general "import" function of python looks of course only in the system standard directories. While you could get the python interpreter to look additionally in another paths, too (PYTHON_PATH environment variable), it's hard coded in the script. - I chose this way, because the suexec of Apache does not generally permit passing of environment variables. So, change the script to set the module path according to where you put the files.

Change further in the application script the base directory holding you fotos. This is basically a directory tree containing JPEGs.

Compile the daemon. In the daemon directory do:
gcc -o gdomain gdomain2-unix.c -lpthread

Finally get the Webserver to execute the application script and you are done!

See "Operation" for further instructions.