A Primer on the 52°North WPS in Eclipse Java EE Indigo

By Matthias Müller, 2009-03-19

1. Prerequisites

If one of the prerequisites is missing, the necessary steps are described below. You need:
  • Maven2 installed
  • Apache Tomcat installed
  • Eclipse IDE Indigo for Java Developers. Please note: This tutorial is explicitly for this Eclipse version and won't work with other versions the same way (including the JEE version of Indigo).
  • Eclipse.ini with jdk (e.g. -vm /opt/sun-jdk- configured
If you haven't done this yet please follow the next two steps, otherwise you can proceed to step 4.

Steps 4 to 8 are also covered by this video.

2. Download Eclipse Java Indigo

Go to http://www.eclipse.org and download Eclipse IDE Indigo for Java Developers.

Note: It is highly recommended to edit the eclipse.ini file located in your eclipse folder. Please add * -vm \\bin\javaw.exe such as * -vm C:\Programs\Java\jdk1.6.0_16\bin\javaw.exe for Windows or the following for Linux:
* -showsplash

Note: Make sure you add the parameter -vm before the -vmargs parameter as in the example above. The -vm option and its value (the path) must be on separate lines. For more information check out the Eclipsepedia.

Also note that there is no javaw.exe in Linux; just use java instead.

This allows eclipse to use a JDK, since there are some know issues for eclipse in not recognizing correctly a set JDK, which is required for this tutorial.

3. Install Maven2

Download a maven version >=2.2.1 from http://maven.apache.org/download.html.

Note: Maven 2.2.1 was used for this tutorial.

Unzip maven-2.X.X-bin.zip to the directory you wish to install Maven 2.X.X. These instructions assume you chose C:\Program Files\Apache Software Foundation\maven-2.2.1

Add the bin directory to your path, by opening up the system properties (WinKey + Pause), selecting the "Advanced" tab, and the "Environment Variables" button, then editing the PATH variable in the user variables. eg. "C:\Program Files\Apache Software Foundation\maven-2.2.1\bin";%PATH%

In the same dialog, check if the JAVA_HOME environment variable does not exist, if not, create it.

Make sure that JAVA_HOME is set to the location of your JDK, e.g. C:\Program Files\Java\jdk1.5.0_02.

Open the command line and:
  • Run mvn --version to verify that it is correctly installed.
  • Run mvn to generate the local repository. (You will see some errors, but don`t mind.)
Create a new folder repository located under the .m2 folder. The default path is: C:\Documents and Settings\\.m2

Install Subclipse

Eclipse -> Help -> Eclipse Marketplace -> Search for "subclipse"


Hit "Install"


Hit "Next", accept the terms and conditions of the license agreement, hit "Finish".

5. Install m2e-subclipse

Eclipse -> Window -> Preferences -> Maven -> Discovery


Click "Open Catalog" and search for "m2e-subclipse"


Select the checkbox and hit "Finish". Accept the terms and conditions of the license agreement, hit "Finish". You also can install the m2e-subclipse plugin later, see section 7.

6. Install Mongrel

For direct Apache tomcat support, you need the extension Mongrel:

Eclipse -> Help -> Eclipse Marketplace -> Search for "mongrel"


Hit "Install", accept the terms and conditions of the license agreement, and hit "Finish".

7. Checkout the WPS source code

Eclipse -> File -> Import -> Maven -> Check out Maven Projects from SCM


The required SCM URL is two parts: SVN | https://svn.52north.org/svn/geoprocessing/main/WPS/trunk/WPS/


Then hit "Next".

Note: If the SCM type dropbox is empty click on "m2e Marketplace" and follow the steps of section 5.


And "Finish".

Your project should now look like this:


8. Compilation

In order to compile the downloaded code, right click on the module 52n-wps-webapp --> Run As --> Maven install


Open the command line, navigate to the directory where the 52n-wps-parent directory is located and type mvn install

You should see a BUILD SUCCESS message afterwards.

9. Deploy your WPS as Web Application

Eclipse -> Window -> Preferences --> Mongrel

Select your Apache Tomcat version and provide the path to your Apache Tomcat installation


Hit "OK" to finish the dialog.

In order register the WPS in Apache Tomcat, you need to:
  • In your file system, go to your Apache Tomcat folder /conf/catalina/localhost
  • Add an XML file named wps.xml with the following content:
WPS>\52n-wps-webapp\target\52n-wps-webapp-X.X-SNAPSHOT" debug="1"/>

where WPS> points to the folder where your wps project resides. Make sure that 52n-wps-webapp-X.X-SNAPSHOT exists.

10. Starting/Debugging the WPS webapp

In Eclipse: Hit the yellow Tomcat Icon to start/debug your service.

Capabilities can be retrieved by this request: http://localhost:8080/wps/WebProcessingService?Request=GetCapabilities&Service=WPS&Version=1.0.0


Enjoy debugging :-)


  • Topic created by: DanielNuest
  • Topic created on: 2013-03-20</verbatim>
Topic attachments
I Attachment Action Size Date Who Comment
IndogoTutorialMongrel.pngpng IndogoTutorialMongrel.png manage 25 K 20 Mar 2013 - 22:17 DanielNuest  
checkout_sourcecode1.pngpng checkout_sourcecode1.png manage 20 K 20 Mar 2013 - 22:20 DanielNuest  
checkout_sourcecode2.pngpng checkout_sourcecode2.png manage 13 K 20 Mar 2013 - 22:17 DanielNuest  
checkout_sourcecode22.pngpng checkout_sourcecode22.png manage 13 K 20 Mar 2013 - 22:17 DanielNuest  
checkout_sourcecode3.pngpng checkout_sourcecode3.png manage 12 K 20 Mar 2013 - 22:17 DanielNuest  
checkout_sourcecode4.pngpng checkout_sourcecode4.png manage 141 K 20 Mar 2013 - 22:21 DanielNuest  
debug_server4.pngpng debug_server4.png manage 136 K 20 Mar 2013 - 22:23 DanielNuest  
install-m2e-subclipse.pngpng install-m2e-subclipse.png manage 17 K 20 Mar 2013 - 22:17 DanielNuest  
m2e-subclipse-maven-discovery.pngpng m2e-subclipse-maven-discovery.png manage 13 K 20 Mar 2013 - 22:17 DanielNuest  
marketplace_subclipse1.pngpng marketplace_subclipse1.png manage 22 K 20 Mar 2013 - 22:18 DanielNuest  
marketplace_subclipse2.pngpng marketplace_subclipse2.png manage 17 K 20 Mar 2013 - 22:18 DanielNuest  
screenshot_m2e_subclipse.pngpng screenshot_m2e_subclipse.png manage 114 K 20 Mar 2013 - 22:17 DanielNuest  
screenshot_mongrel.pngpng screenshot_mongrel.png manage 24 K 20 Mar 2013 - 22:17 DanielNuest  
Topic revision: r3 - 25 Aug 2014, DanielNuest
Legal Notice | Privacy Statement

This site is powered by FoswikiCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding Wiki? Send feedback