h1. User documentation for the Edge Matching Service

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

# Apache installation
# Setting up the Web Processing Service
# Setting the WPS environment in Linux
# Web Processing Service Client 
* [[Data Processing (Data Cleaning)]]
* [[Data Processing (Coverage Aligner)]]


h2. 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.
 
!http://community.esdi-humboldt.eu/attachments/download/20/10_HumboldtWPS_Apache_Properties_.png!
_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.


h2. Setting up the Web Processing Service

1. Download the EMS war file from "here":http://builds.esdi-humboldt.eu/WPS-Webapp-0.0.1.war.

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

!http://community.esdi-humboldt.eu/attachments/download/19/12_HumboldtWPS_Server_unwar_.PNG!
_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. 
!http://community.esdi-humboldt.eu/attachments/download/21/13_HumboldtWPS_Server_edit_wps_xml_.PNG!
_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. 

!http://community.esdi-humboldt.eu/attachments/download/23/14_HumboldtWPS_Server_edit_wps_config_.png!
_Editing the wps_config.xml_

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

# "GetCapabilities request":http://www.inspire-x.eu/wps/WebProcessingService?Request=GetCapabilities&Service=WPS
# "ProcessDescrition of the Dataset Cleaning Process":http://www.inspire-x.eu/wps/WebProcessingService?Request=DescribeProcess&Service=WPS&Identifier=eu.esdihumboldt.transformers.wps.em.DatasetCleaning
# "ProcessDescription of the Coverage Aligner Process":http://www.inspire-x.eu/wps/WebProcessingService?Request=DescribeProcess&Service=WPS&Identifier=eu.esdihumboldt.transformers.wps.em.CoverageAligner

h2. 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]]

h2. 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":http://udig.refractions.net/

1. Download last version of JUMP from "here":http://sourceforge.net/projects/jump-pilot/files/. For windows, it is recommended to download OpenJUMP win32 installer, version 1.3. You can learn more about OpenJump "here":http://www.openjump.org/index.html.
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.

!http://community.esdi-humboldt.eu/attachments/download/24/22_HumboldtWPS_Client_Jump_Finish_.PNG!
_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. 

!http://community.esdi-humboldt.eu/attachments/download/25/25_HumboldtWPS_Client_Jump_WPS_checkingWPS_.PNG!
_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)]]