Setting up the 52°North WPS with Ecplise
In the following you set up the 52°North WPS by cloning the source from github, build it with Eclipse and at the end you can test it by runing it in a servlet container such as Tomcat.
You will need to have installed
- Git
- Ecplise IDE for Java Developers
- Apache Tomcat
At first you have to clone the WPS Git repository from github to a convenient location to work with it, such as the Eclipse Workspace or somewhere else. To clone you have to open your shell, navigate to the favored location and execute the following command.
git clone https://github.com/52North/WPS.git
The WPS Git repository will be cloned in a sub-folder named WPS.
Hereafter you need the Ecplise EGit and Maven Integration for Ecplise plugins. If they are not preinstalled with your Eclipse, install them from the marketplace before continue. You can check your installed software by select Help > About Eclipse IDE > Installation Details .
The repository you cloned from git is a maven project. To build the WPS you first have to import the maven project into Eclipse.
Open Eclipse. If possible start with an empty workspace. Select File > Import > Maven > Existing Maven Projects and click Next .
Then click on Browse and navigate to the WPS folder that was created by clone the Git repository. Select all projects and click Finish .
The Project now should be add to your Package Explorer in Eclipse where WPS is the folder in your workspace. If you not cloned the git repository in your workspace you create a working set named 52n-wps-parent , take this.
For further works, control if the project in Eclipse is connected to Git by right click on the WPS Folder and go to Team . If it looks like in the following picture the project is connected to Git and you can continue with build the project.
If not, you have click on Team > Share Project select Git and click Next .
Check the box Use or create repository in parent folder or project select the project and click Finish .
Now the Git functionalities are enabled in Eclipse.
In order to build the WPS, right click on WPS and go to Run as > Maven install . The build will take some time. It's possible that there are some error massage in the console. Ignore them, this are only tests that failed. At the end it should be look like this
Now the WPS is build you maybe like to test if it works. For this you have to run Apache Tomcat and open localhost:8080/manager/.
Go to Deploy > WAR file to deploy and select the .war file in ... > WPS > 52n-wps-webapp > target and deploy it. After it should be listed in the Applications list.
You can now open the WPS by localhost:8080/52n-wps-webapp-3.6.3-SNAPSHOT/ or whichever path the application have and test it.