User documentation for the Edge Matching Service

The installation and the use of this HUMBOLDT WPS is explained here. The available information is:

  1. Apache installation
  2. Setting up the Web Processing Service
  3. Setting the WPS environment in Linux
  4. Web Processing Service Client

Apache installation

1. Go to http://tomcat.apache.org and download Apache. Install version 5.5 or later.
2. After download, execute the installer and press next.
3. Agree to the terms.
4. Press next.
5. Choose username and password and press next. Connector port: 8080
6. Choose where to install Apache Tomcat and press next.
7. Select path for the Java Virtual machine.
8. Press finish and run Apache.
9. If the properties do not show up, start “Monitor Tomcat” which should be situated in the start menu. Thereafter, press start to start the server.


Monitoring Tomcat

10. Now should, in this case, the local server work. Visit http://localhost:8080 and if the webpage is visible, the server works. Otherwise, please check if the server has correctly been started.

Setting up the Web Processing Service

1. Download the EMS war file from here.

2. If the WPS war is unpacked, extract it to a chosen location.


Unpacking the service

3. Go to the localhost folder in your Apache folder, i.e. \Apache Software Foundation\Tomcat 6.0\conf\Catalina\localhost. Create a xml file, name it wps.xml and fill it with the following information:

<Context path="/WPS_directory" privileged="true" docBase="full_path_to_deployed_war\WPS-Webapp-0.0.1" debug="1"/>
WPS_directory and full_path_to_WPS_directory should be changed to your corresponding paths.

Editing the wps.xml

4. Open the xml file wps_config.xml in your_WPS_folder\config\. At line 29, check that the server information is correct. In this case, port 8080, hostname localhost and webappPath wps is correct. Save and exit. This will be used when the client connects to the WPS service.
Please, change localhost to servername in order to be used on the network.


Editing the wps_config.xml

You can find the GetCapabilities and the ProcessDescription of the EMS operations here: [http://www.inspire-x.eu/wps/]

  1. GetCapabilities request
  2. ProcessDescrition of the Dataset Cleaning Process
  3. ProcessDescription of the Coverage Aligner Process

Setting the WPS environment in Linux

If you prefer setting the WPS environment in Linux you can use the following tutorial which explains how to set up the WPS application on Tomcat in a Linux environment, and how to setup multiple Tomcat instances since it may be to prefer when you have several web applications. Moreover, Apache will be connected to Tomcat with JK Connectors so the users may access the WPS application through Apache (port 80) instead of Tomcat (8080).

You can find the tutorial here: Installation of the WPS in a Linux environment

Web Processing Service Client

There are several available Web Processing Service Clients: tests have been done with both OpenJUMP and uDig. Here the preparation and use of JUMP as WPS client is described in detail. For more information on how prepare/use uDig see uDig home

1. Download last version of JUMP from here. For windows, it is recommended to download OpenJUMP win32 installer, version 1.3. You can learn more about OpenJump here.
2. Execute the installer.
3. Agree to the terms.
4. Choose location for the software and install.
5. If you do not have Java 1.5, OpenJUMP will download and install it for you. Press OK.
6. Do not run OpenJUMP yet. The WPS plugin needs first to be installed.


Finishing the OpenJUMP installation

7. Download the latest WPS client for JUMP at the webpage of 52north: http://52north.org/maven/project-sites/wps/52n-wps-client-jump/download.html
8. Extract the plugin files in your_OpenJUMP_directory\bin\lib\ext\
9. Start OpenJUMP. If the WPS plugin works, the tab “WPS Client” should be visible in the toolbar.


OpenJUMP tool with WPS extension

After the WPS Client installation, some use cases are demonstrated in the following links:

Data Processing (Data Cleaning)

Data Processing (Coverage Aligner)