Installing the CGI Scripts

The Python scripts in this package comprise the web interface. You will need to install these such that the web server can execute these scripts (actually, the only executables are kbExec.py and kbGraphicLoader.py, all others are called from these two script).

The scripts should be unpacked into a directory which can be read by the web server. Then, set up Apache as below (changing /home/mike/... to suit your setup). DocumentRoot points to the top-level directory (containing kbExec.py and kbGraphicLoader.py); /graphics/ and /js/ are aliases to access some fixed graphics and the client side JavaScript libraries respectively. Also tell Apache to execute files with the .py extension as CGI scripts.

The SetEnv line sets KB_USERDIR to point to the directory which is used to contain you application; this is the directory to which you will export forms and so forth from Rekall itself. This setting allows you to run multiple RekallWeb virtual hosts from the same installation. This assumes a sufficiently recent version of Apache; if your version does not support this then see below for a slightly restrictive work-around.

<VirtualHost 192.168.1.66:80>
    ServerName      rekallweb.henley.seriesone.net
    ServerAdmin     mike@quaking.demon.co.uk
    DocumentRoot    /home/mike/Rekall/rekallWebCGI
    Alias           /graphics/ /home/mike/rekallWebCGI/graphics/
    Alias           /js/       /home/mike/rekallWebCGI/js/
    AddHandler      cgi-script .py
    SetEnv          KB_USERDIR /home/mike/Rekall/rekallWebApp
</VirtualHost>
      

If your version of Apache does not support SetEnv then (at the expense of needing a separate RekallWeb installation for each virtual host) create a file kbEnv.py on the top-level directory that contains:

kbUserdir = '/home/mike/Rekall/rekallWebApp'