installation.doc - University of Iowa

beefwittedvalentineΔιαχείριση Δεδομένων

29 Νοε 2012 (πριν από 4 χρόνια και 11 μήνες)

219 εμφανίσεις

WEBDMAP INSTALL MANUAL

This memo provides installation and setup instructions for the WebDMAP system. The WebDMAP
system is currently designed for implementation on a dedicated server running Microsoft Windows XP
or Microsoft Windows 2003 server. A prototy
pe system implemented at the Department of Geography
at The University of Iowa runs on a Microsoft Windows XP based server. The prototype system has been
tested for performance and security vulnerabilities and is currently safe against all known SQL inject
ion
attacks and cross site scripting (XSS). The system has not been teste
d for performance and security i
n a
Linux/Unix environment. The full functionality of the WebDMAP system is available on a machine that is
connected to the Internet and has access to
a SMTP server. The programs and scripts for webDMAP are
written in Perl and pgSQL.

Software Required

1. Apache HTTP Server (Required)

The Apache HTTP Server provides the web interface to webDMAP. The server must be configured to
execute CGI/Perl scripts f
rom the default /cgi
-
bin/ folder. Download from
http://www.apache.org
. The
WebDMAP system is currently configured for Apache 2.2.10.

Note: earlier versions should work fine.

2. FWTools (Required)

FWTools provides speci
alized geospatial data translation services. Download from
http://fwtools.maptools.org/
. WebDMAP system is currently configured for FWTools 2.2.6.

Note: earlier
versions should work fine.

3. ActivePerl (Require
d)

The interface to webDMAP is written in the Perl scripting language. Download from
http://www.activestate.com/
. WebDMAP system is currently configured for ActivePerl 5.10.0.

Note:
earlier versions should work f
ine.

4. PostgreSQL (Required)

The Postgres database server will hold all the input and output data. Download from
http://www.postgresql.org
. WebDMAP is currently configured for PostgreSQL 8.3.

Note: earlier versio
ns
should work fine. Version 8.3 does not support automatic casting. The creategrid_quad function
may

cause problems with postgresql versions prior to 8.3.


5. PostGIS (Required)

Provides spatial extensions to the PostgreSQL database server. Download from
http://postgis.refractions.net
. WebDMAP is currently configured for 1.3.3.
Note: earlier versions of
postgis are
not

supported. Please updated your postgis version.

Source code for the webDMAP system
is avail
able on the project website at
http://www.uiowa.edu/~gishlth/webdmap/code/webdmap_v2/

There are three folders under this directory


htdocs (contains the WebDMAP frontend), cgi
-
bin
(contains the Perl scripts), and database (contains the SQL code).

Setup I
nstructions System Configuration

1. Setup the GDAL_DATA environment variable

SetEnv GDAL_DATA "c:
\
progra~1
\
fwtool~1.X
\
data
\
" (replace X with the correct version number)

2.
Setup the

Apache document root (/htdocs)

a. /uploads/

b. /results/

c. Copy everythin
g from the
htdocs

folder
on the project website
to the htdocs folder under
Apache

d
. Add
a blank
index.html to /results and /uploads to prevent directory browsing

e
. Do
not

disable directory browsing for the /results/ folder in httpd.conf

f
. Disable direct
ory browsing for /uploads/ in httpd.conf

3
.
Setup the Apache Perl environment.
Make the following changes to httpd.conf

a. Enable pl and cgi handlers. Add the following lines:

AddHandler cgi
-
script .cgi

AddHandler cgi
-
script .pl

b. Configure /uploads and

/results. Add the following lines

<Directory "C:
/Program Files/Apache Software
Foundation/Apache2.2/htdocs/uploads">


Options FollowSymLinks

</Directory>

7.
PostgreSQL/PostGIS Setup

a
. Create database
dmap (note the lower case)

and ensure

that the spatial extensions are
enabled on the database

b. Execute all the
SQL
scripts found in the database folder on
the project website.


8.
Perl Setup

a
. Install Perl under c:
\
perl

b
. Install the following modules…

DBD::PgPP
,
Math
-
Round
,
Net
-
SMTP_Aut
h
,
File
-
Path
-
Stderr
,
Archive::Extract
,
XML::Simple
,
Data::Dumper
,
LWP::Simple

9.
Scripts

a.
Copy everything from the cgi
-
bin folder on the
project website

to the cgi
-
bin folder under
your
Apache

installation.

b
. Modify the
path locations in all the P
erl sc
ripts
only

if you are using a non
-
standard Windows
install.

c. Modify the SMTP server in the following Perl scripts:
webdmap_aa_direct_new_runquery.pl
,
webdmap_crude_analyze_runquery.pl
,
webdmap_crude_new_runquery.pl
,
webdmap_gis_gengrid_runquery.pl
,
webd
map_visualize.pl