The deegree2 OGC Web Service (OWS) implementation

1. building & deploying

In order to install and run a deegree2 OGC Web Service (OWS), you must do the following:

a. Download and Install a Java Development Kit

• Download a Java Development Kit (JDK) release (version 1.5 or later) from:

  • http://java.sun.com/j2se/

• Install the JDK according to the instructions included with the release.
• Set an environment variable JAVA_HOME to the pathname of the directory into which you installed the JDK release.

b. Download and install the nightly build deegree2 binary distribution.

2. Getting deegree2 Source Distribution

Get the latest source code from the SVN repository:

anonymous (only read access)

svn checkout https://svn.wald.intevation.org/svn/deegree/base/trunk/

developers (write access)

svn checkout svn+ssh://developername[AT]svn.wald.intevation.org/deegree/base/trunk/

or download the latest source distribution of deegree from the project's download page. Access to other resources (for iGeoPortal, documentation, ...) can be viewd at http://wald.intevation.org/scm/?group_id=27.

There is also a nice description for deegree SVN and Eclipse, if you prefer the gui over the command line.

3. Compiling deegree2

In order to compile deegree2 the Apache Ant tool is required.
deegree2.0 requires at least Java2 SDK 1.4. (outdated)
deegree2.2 requires Java2 SDK 1.5. (current - June 2009). Also check deegreeCompatibility.

• Download the latest version of Apache Ant from:

  • http://ant.apache.org/ (at least version 1.6.3 is required)

• Install Ant by following the installation instructions and set an environment variable ANT_HOME to the pathname of the installation directory.
• Furthermore the optional tasks of Ant-Contrib are required. Download the latest version (tested with 1.0b2 and 1.0b3) from:

  • http://ant-contrib.sourceforge.net (ant-contrib description page)

    current download page (June 2009)

  and place the ant-contrib.jar in the lib directory of your Ant installation.
• To be able to execute the 'test' target, you will need JUnit. Download it from:

  • http://www.junit.org

  and place the file junit.jar in the lib directory of your Ant installation.

1. As long as there is no configure script apply your local setting to the build.properties file.

• Normally apply only the path to your application server and set the value for 'default.server'.

  The default value is 'tomcat'. If you use ApacheTomcat apply the correct values for:

• tomcat.home
• tomcat.server
• tomcat.port
• tomcat.username
• tomcat.password

Verify settings by calling:

>ant env

2. Get Ant project help to see all available targets:

>ant -p

3. Compile deegree source files:

>ant compile

and build JAR archive with:

>ant build-lib

4. To verify the build, call:

>ant test

to run the JUnit test suite.

4. Running deegree2 web services

A. deegree2 Web Feature Server (WFS 1.1.0):

1. Set the local settings in build.properties file as described in step "Compile deegree 2.0".
2. Create a web application in exploded format in a directory which is deployed by the application server automatically.
   • The root directory is $WEBAPP_HOME.
3. Start the application server.
4. call ant build file in $DEEGREE_HOME

   •   >ant deploy

5. Verify if deegree 2.0 WFS services are running by opening the page

   • http://localhost:8080/deegree/ in your web browser.

B. deegree2 Catalog Service for Web (CSW 2.0.0):

• [TODO] (see WFS)

C. deegree2 Web Coverage Service (WCS):

• [TODO]

D. deegree2 Web Map Service (WMS):

• [TODO]

Migration from deegree 1.x WFS 1.0.0 to deegree2 WFS 1.1.0

• [TODO] deegree2.2 supports both versions of WFS (1.0.0 and 1.1.0)

5. Supported Plattforms

deegree2.2 was tested on the following plattforms:

• Linux / Debian / Ubuntu 8.04, 8.10, 9.04
  • Sun JDK 1.5.0_16 (java-1.5.0-sun-1.5.0.16)
    • Tomcat apache-tomcat-5.5.27
• Windows XP/Vista

add more, if you have a different system running

deegree2.0 was tested on the following plattforms:

• Windows 2000/XP
  • Sun JDK 1.4.2_06
    • Tomcat 4.1.31
    • Tomcat 5.0.28

    • BEA WebLogic 8.1.3.0

  • Sun JDK 1.5.0_04
    • Tomcat 5.5.9
• Linux / Suse 9.1
  • SUN JDK 1.4.2
    • Tomcat 4.1.31

6. Known Issues and Bugs in deegree2.0

This information is outdated, as it covers the deegree version 2.0. The current stable version (since December 2008) is deegree v2.2.

• The CSW example configuration requires Apache Xalan

  • (http://xml.apache.org/xalan-j/) as XSLT processor. Sun's JDKs 1.4 + 1.5 ship with Xalan bundled, so they should work out of the box. If you encounter XSLT related problems, check that you do not reference another Transformer implementation (Saxon for example) in your classpath.

---

CategoryDeegree2