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 Windows, this is done via the system properties dialogs.
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.
2.2. PostgreSQL / PostGIS
If you want to setup the deegree 3 catalogueService or if you want to access PostGIS-based feature storage in either deegree 3 featureService or deegree 3 mapService you will need to install PostgreSQL/PostGIS.
The minimum recommended versions are:
- PostgreSQL 8.2
- PostGIS 1.2
Tested versions are:
- PostgreSQL 8.2, 8.3, 8.4
- PostGIS 1.2, 1.3, 1.4
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.
Windows
Download the correct version for your architecture:
Unpack the archive and copy the contained lib folder to a location of your choice. Add the path to the lib folder to your system's PATH variable.
Linux
Download the correct version for your architecture:
Unpack the archive and copy the contained lib folder to a location of your choice. Add the path to the lib folder to your system's LD_LIBRARY_PATH variable.
Mac OS X
Download the archive. Unpack the archive and copy the contained lib folder to a location of your choice. Add the path to the lib folder to your system's LD_LIBRARY_PATH variable.
2.5. Other
If you're interested in setting up a deegree build/development environment, please have a look at deegree3/BuildingDeegree3.