RIMapperWMS
readme, installation and setup
- Make sure you have a database running that supports
the OpenGeospatial consortium's
Simple Features for SQL standard. The current RIMapperWMS version (1.0b) has SQL statements and
JDBC connections working for the PostGIS extension of PostgreSQL and for MySQL 4.1
and higher. Our setup and tests have until now only been extensive for PostGIS/PostgreSQL, as MySQL is lacking some OGC-SFS features, most notably a projection engine (as long as all your data is in the same spatial reference system that should be no problem, though).
- Make sure you have a Webserver and a Java Servlet
container running, or a combination of these, such as Jakarta Tomcat
4 and higher. Our setup uses Tomcat 5.5, which can be downloaded from
the appropriate
Apache project pages.
- Set up a database schema with your geometric and attribute data. The simplest way is to download the example database SQL loadscript [ZIP archive of sql file] and load it in your database system:
- For PostGIS/PostgreSQL, create a new database called "rimapper" with UTF-8 encoding and the PostGIS extension installed (check the PostGIS documentation on how to do that). Execute the SQL load script. This can be done in several ways, eg.:
- load the file into PGadminIII SQL window and execute, or
- type '\i rimapper_loadscript.sql' in the command-line client (psql).
- For other SFS compatible databases, you will have to check how to create geometry type columns and might have to change the SQL script accordingly.
- Note that the load script creates a DB user (or 'role') called 'rimapper' with password 'rimapper' that corresponds with the connection data in the file 'wms_instance.xml' inside the TomCat Webapps directory for RIMapper. When changing or adding DB priviliges and/or users for the RIMapper DB, you'll have to change this file accordingly!
- Download the file RIMapper.war [2 Mb zipped Web Application Archive], and deploy it in your servlet container. In Tomcat you can do this by going to the Tomcat Manager (from your Tomcat home page or directly to http://localhost:8080/manager/html/) and choosing the RIMapper.war file in "Select WAR file to upload" and click 'Deploy'. After this the RIMapper system will be set up in the Tomcat webapplication directory (see details).
You can expand this database with your own data later. You can also build your own schema from scratch, as long as it adhers to this schema setup.
The system is released as Open Source under a Creative Commons Attribution-nonCommmercial-ShareAlike license.
Barend Köbben - last changes March 20, 2008
This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 2.5 License.
