root/bbox/INSTALL

INSTALLING BBOX
---------------

DEPENDENCIES
------------

* The Redland RDF toolkit. http://librdf.org/
  -  Debian: apt-get install librdf redland-python
  -  *BSD: is in ports
  -  Fedora/RedHat: get RPMs http://download.librdf.org/binaries/

* Optional: PostGIS (which needs postgres): see INSTALLING POSTGIS

* Some python modules:
  - cheetah (template) : apt-get install python-cheetah
  - pgdb (postgres): apt-get install python-pygresql

CONFIGURATION
-------------

* Edit the file 'bbox/config.py'

  boot='file:/a/bootstrap/RDF/file'
  # (See BOOTING A BBOX for details)
  
  store='/path/to/directory/'
  # Where Redland stores its files
  
  db='filename'
  # The name of Redland filestore ('bbox' by default)

  # *OPTIONAL* for the spatial index

  spatialdb='dbname'
  # name of the PostGIS database or other spatial index
  
  utm_zone=31
  # find your zone at http://www.dmap.co.uk/utmworld.htm
  
  srid=32631
  # Spatial Reference ID for PostGIS; usually '326'+utm_zone


BOOTING A BBOX
--------------

* The data store needs to be 'booted' with knowledge about 
  RDF namespaces and short names for them. The file 
  'store/boot.rdf' contains this knowledge. Run the script:

  bbox#> python store/boot.py

  If you don't go through the booting phase, the first time BBox runs, 
  it will boot itself but then fail, and only run the second time.
  (It needs to know about namespaces before it can refer to them)
  

RUNNING A BBOX
--------------

BBox typically runs inside another application, though the 
bbox/ui directory contains a proto standalone HTTP interface to it.

Please see the file README for information on how to run a bbox.

INSTALLING POSTGIS
------------------

Currently in order to use the spatial index you need to be running a
PostGIS database, with a table in it mapping RDF nodes (URLs) to
geometries that can be queried spatially.

Debian install:
    
  * append the following line to /etc/apt/sources.list
  
  deb http://pkg-grass.alioth.debian.org/debian-gis unstable main non-free contrib
  
  * run:
    bbox#> apt-get update
    bbox#> apt-get install postgis

BSD install: PostGIS is in ports. You should be okay. I'd apprec feedback.

Fedora/RH users: 
  
  * RPMs available at http://mappinghacks.com/rpm/
  * install postgis* and postgres* from there.

Source and documentation for PostGIS is available from 
http://postgis.refractions.net/

      
SETTING UP POSTGIS
------------------

As the 'postgres' user, do the following
(where 'bbox' is the name of your database):

    postgres#> createdb bbox
    postgres#> createlang plpgsql bbox
    postgres#> psql bbox < /usr/share/doc/postgis/postgis.sql
    postgres#> psql bbox < /usr/share/doc/postgis/spatial_ref_sys.sql

The 'store' directory contains a file 'spatialStore.psql'

You need to EDIT 'store/spatialStore.psql' and change the line that begins
'SELECT AddGeometryColumn', which should read:

  SELECT AddGeometryColumn ('[your database name]','nodes','geom',[SRID],'GEOMETRY',2);

Where SRID matches the SRID you set in bbox/config.py
Now load this file into your new database:

    postgres#> psql bbox < ~/bbox/store/node_geom.psql

At this stage you might want to grant permissions to your webserver user:

    postgres#> psql bbox
        bbox=> grant all on nodes to "www-data" # or apache or whoever
        bbox=> grant select on geometry_columns to "www-data"
        bbox=> grant select on spatial_ref_sys to "www-data"