GEOSS Banner

Section 4.3.3 Offering a shapefile with deegree

<<Prev T.O.C.  Next>>

Deegree version 3.0 offers the possibility to have a WMS and WFS service simultaneously with a single application. It also provides WPS and CSW support. The easiest way to start with Deegree is setting up the demo version that includes Utah datasets. This version is the one we are going to use.

Before setting up degree, you must setup the JDK java virtual machine. Please do not rely on the usual JRE because it will not work. We have downloaded the version jdk-7u1-windows-i586.exe from the Oracle website




Once the Java setup is completed, it is important to define the JAVA_HOME path. This is done by including a new environment variable in the system by creating it in the advanced tab of the system properties.


You can know download Deegree 3.0. We have done it directly from and decompressed the zip file to the c: root directory. The decompression creates the following folder.


Now you can open a Windows console (CMD), change directory to "c:\deegree_utah_demo" and run "start-deegree.bat". The result is another console window with a tomcat report about the web service starting process. Leave this window open, unless you want to close the service.


Now Deegree is running in your machine under the port 8080, and you can get access to the main interface just by typing http://localhost:8080 in a web browser:.


Now, you have to click on "download" to get the data that is needed to run this demo:


After the download is completed, new options will appear in the same screen. Among the new ones, you will see ;administrative console; that allows you to configure your server and to add new data.


To get in, you need to know the default password: "deegree"

Step 1: Adding new data

At this point, we are going to create a new feature store with the name which is a type.


The system creates a new configuration file for this layer. We have to manually edit the position of the vector shape file that we are going to publish. We have downloaded a world borders dataset from: To simplify the process we are going to decompress the data directly into the same directory where the Utah data is: C:\deegree-utah-demo\webapps\ROOT\WEB-INF\workspace\data\data\utah\vector.
In the next screen, we have to change the content of the element to include the relative position of the shp file using '/' as slashes (instead of back slashes) and without the extension ".shp". We also have to change the to a data type name that will be representative in the wfs capabilities. In our case we introduced "WorldBorders" instead of the proposed "Shape".


Once you save it, you have to reload the server by pressing a small red linked text.


Finally, the layer becomes available at the end of the list below the others.


Step 2: Testing the layer

The first evidence that the system is working properly is that we can see the layer in the capabilities document. Accessing the capabilities document is as simple as clicking in the text "Capabilities" from in the "web services" subpage, next to "On wfs Edit"


The capabilities document includes the name of the layer that we have just included:


Once again, we use Gaia v3 to illustrate that the resulting dataset works perfectly. Gaia can be downloaded from: and requires Microsoft NET framework 2.0 to start.

When the program is started, the only thing we have to do is to press the icon with the plus symbol from the dark blue bar, and add a new server by clicking again in the multilayer with a plus symbol icon. In our installation, the name of the service is http://localhost:8080/services but, in a real implementation, we are going to use the ip name of the machine instead of “localhost”.



After an arbitrary "name" is introduced and the "version" 1.1.0 is selected, we can click “OK” to select the relevant layer that, in this particular case is app:WorldBorders. If you are doing itcorrectly, you will see a preview of the layer:


Since this is a WFS service, the elements are individualized and we can select one of them to find the attributes.


This illustration shows world vector map and the result of a query by location for Libya.

<<Prev T.O.C.  Next>>

Files (0)

You must login to post a comment.