System requirements for deegree 3

This page describes required and optional third-party software for running deegree 3-based applications. The only mandatory requirement for deegree 3 is the correct Java installation. Everything else is only needed under certain circumstances.

1. Java installation

As deegree is written in Java, you will need a recent JAVA 6 installation to run it. Please note that you need a so-called Java JDK (Java Development Kit) installation. A JRE (Java Runtime Environment) is not sufficient. We recommend using the latest Oracle (former Sun) Java 6 JDK, which can be downloaded at oracle.com. Currently, this is JDK 6 Update 22. If you run into problems with the Java installation, please refer to the Oracle installation instructions.

deegree 3 requires at least Sun Java 6 JDK, Update 4, as this was the first one that bundled the JAXB 2.1 API.

After the successful installation of Java 6 (JDK):

Check your Java version using java -version on the command line.

Make sure that the JAVA_HOME system environment variable points to the installation directory of your JDK.

On Linux/Unix, this is usually done by something like export JAVA_HOME=/usr/lib/jvm/java-6-sun) on the command line.

2. Optional components

The optional components described in the following section only need to be installed or set up in very special cases.

2.1. Servlet container

deegree webservices are Java web applications and require a so-called servlet container to be run. Note that the download packages for a specific operating system (Windows / Unixes) already contain a bundled Tomcat servlet container, so you're all set. However, if you rather download the WAR file(s) in order to deploy deegree in you're own servlet container installation, choose a product that implements the Java's servlet 2.5 specification, e.g.

Apache Tomcat: We recommend the latest Tomcat 5 release (currently 6.0.29). Tomcat 7 should work as well, but is not as well-tested.

Jetty: Jetty 6 and up should work, but are not very well tested by the deegree core developers.

If you experience any problems with other/higher versions of PostgreSQL or PostGIS, please report the issues in the deegree-services tracker.

2.3. Oracle

The minimum recommended version is:

Oracle 10

Tested versions are:

Oracle 10, 11

Please note the description on how to add oracle support by adding the required (non free oracle) libraries.

2.4. JOGL (Java OpenGL bindings)

The 3D rendering subsystem of deegree 3 requires OpenGL hardware acceleration. This means that components that use this subsystem have additional requirements regarding hardware and software. Currently, only the deegree 3 terrainService uses the 3D rendering subsystem, so for all other components (e.g. WMS or WFS), this section might just as well be ignored.

2.4.1. Hardware requirements

An OpenGL compliant GPU and a decent OpenGL 2.0 driver is required. Your GPU should have 256MB memory or more.

Hardware setups reported to work:

nVidia GeForce 8500GT, 256 MB, Ubuntu 8.10 AMD64

nVidia GeForce 320M, Mac OS X 10.6 (64 Bit)

please add your tested configuration here

2.4.2. JOGL native libraries

The 3D rendering components of deegree 3 require the native JOGL libraries to be installed on your system, so Java can make use of your OpenGL hardware.

NOTE: Currently, the recommended JOGL version for deegree 3 is 1.1.1a.