README.md

Floodject

This is a project created by Ioannis Angelidis, David Nagy and Emil Møller Rasmussen.

PyPWS

Installation

Installing PyWPS can be a nightmare if trying to follow the instructions from the official documentation, as they are old and your server setup might differ. They are found in the links below:

http://pywps.wald.intevation.org/documentation/installation.html

http://pywps.wald.intevation.org/documentation/course/

Luckily, one of the developers (Luis de Sousa) working on PyWPS gave detailed instructions on how to install PyWPS on Ubuntu 14.04 in the following stackexchange thread:

http://gis.stackexchange.com/questions/83743/how-to-install-pywps-on-ubuntu

The instructions from there are partly used below, but changed to fit with the individual server setup:

Actual installation

Install dependencies, clone the project from GitHub and install it:

sudo apt-get install apache2 python-setuptools python-magic python-lxml  git-core wget

git clone https://github.com/geopython/PyWPS.git

cd ./PyWPS

sudo python setup.py install

Create folders for PyWPS assets

For convenience, in this example all PyWPS assets are stored in /var/www/html, a typical setup for a development environment. In a server setup it might be wiser to store processes in /srv and logs in /var/log.

sudo mkdir /var/www/html/pywps

sudo mkdir /var/www/html/wpsoutputs

sudo cp -R pywps/processes /var/www/html/pywps

Create log and configuration files:

sudo touch /var/www/html/pywps/pywps.log

sudo cp pywps/default.cfg /var/www/html/pywps/pywps.cfg

sudo pico /var/www/html/pywps/pywps.cfg

In the configuration file only the Server environment needs to be tweaked, in order to match the asset locations created before. The set up of the GRASS and MapServer environments are left for a later date.

  [server]
  maxoperations=30
  maxinputparamlength=1024
  maxfilesize=500mb
  tempPath=/tmp
  processesPath=/var/www/html/pywps/processes
  outputUrl=http://localhost/wpsoutputs
  outputPath=/var/www/html/wpsoutputs
  debug=true # deprecated since 3.2, use logLevel instead
  logFile=/var/www/pywps/pywps.log

Pass ownership to the www-data user (again, in a server setup you might want to be more conservative):

sudo chown -R www-data:www-data /var/www/html/pywps /var/www/html/wpsoutputs

Configure the web service

Copy the PyWPS CGI to /usr/lib/cgi-bin:

sudo cp webservices/cgi/pywps.cgi /usr/lib/cgi-bin

whereis wps.py

Copy the path of wps.py to the clipboard.

sudo pico /usr/lib/cgi-bin/pywps.cgi

Modify pywps.cgi to match the present setup:

export PYWPS_CFG=/var/www/html/pywps/pywps.cfg
export PYWPS_PROCESSES=/var/www/html/pywps/processes/

/usr/local/bin/wps.py $1

Give it a try:

cd /usr/lib/cgi-bin

sudo sh pywps.cgi "request=GetCapabilities&service=WPS"

Make sure Apache is configured to run CGI scripts; the CGI module might need to be explicitly enabled:

sudo a2enmod cgid

Edit the default site configuration

sudo pico /etc/apache2/sites-available/000-default.conf

Add the following to the file:

ScriptAlias /cgi-bin/ /usr/lib/cgi-bin/
<Directory "/usr/lib/cgi-bin">
    AllowOverride None
    Options +ExecCGI -MultiViews +SymLinksIfOwnerMatch
    Order allow,deny
    Allow from all
</Directory>

Restart Apache:

sudo service apache2 restart

Various URL strings for accessing the WPS service

Get capabilities

http://52.17.144.192/cgi-bin/pywps.cgi?service=WPS&version=1.0.0&request=getcapabilities

Execute a function

http://52.17.144.192/cgi-bin/pywps.cgi?request=execute&service=WPS&version=1.0.0&identifier=flooding&datainputs=[rasterin%3Dhttp%3A%2F%2F52.16.38.28%2FNEWTIF.tif%3Bvectorin%3Dhttp%3A%2F%2F52.16.38.28%2Ftest.geojson]

Describe process

http://52.17.144.192/cgi-bin/pywps.cgi?service=WPS&version=1.0.0&request=DescribeProcess&Identifier=flooding

Installations

Installation structure of PyWPS

To give a better overview of where the files on the server have been installed, a file-tree of the location of all important files is provided below:

/
├── /var/
|   └── /www/
|       └── /html/
|           └──/pywps/
|               ├── pywps.cfg
|               ├── pywps.log
|               ├── /wpsoutputs/
|               └── /processes/
|                     └── __init__.py
|                     └── process1.py
├── /lib/
|    └── /cgi-bin/
|        └── pywps.cgi
|
└── /etc/
    └── /apache2/
        └── /sites-available/
            └── 000-default.conf

GRASS installation on server

~
├── .grass6
|     └── rc
└── grassdata
      └── <LOCATION>
            └── <MAPSET>

File structure of the webserver

/
└── /var/
    └── /www/
        └── /html/
            └── /FlaskApp/
            	├── flaskapp.wsgi
            	└── /FlaskApp/
            	    ├── /templates/
            	    ├── /static/
            	    ├── /images
            	    └── __init__.py

Debugging

When wanting to debug there are two important file locations, the first one is the pywps.log that we created above, the second one is the general server (apache) error log. These are found in these locations

/
└── /var/
    ├── /www/
    |   └── /html/
    |       └── /pywps/
    |           └── pywps.log
    |
    └── /log/
        └── /apache2/
            └── error.log

CGI-BIN

CGI wrapper

#!/bin/sh

# Author: Jachym Cepicky
# Purpose: CGI script for wrapping PyWPS script
# Licence: GNU/GPL
# Usage: Put this script to your web server cgi-bin directory, e.g.
# /usr/lib/cgi-bin/ and make it executable (chmod 755 pywps.cgi)

# NOTE: tested on linux/apache

export PYWPS_CFG=/var/www/html/pywps/pywps.cfg
export PYWPS_PROCESSES=/var/www/html/pywps/processes/

/usr/local/bin/wps.py $1

Creating functions

It is not the name of the python script, but the name of the "Class" defined within that determines the name of the service.

Setting up Flask with Apache

http://alex.nisnevich.com/blog/2014/10/01/setting_up_flask_on_ec2.html