System requirements for deegree 2
This page describes required and optional third-party software for running deegree 2-based applications. The only mandatory requirement for deegree 2 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 5 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 5 JDK, which can be downloaded at oracle.com. If you run into problems with the Java installation, please refer to the Oracle installation instructions.
deegree 2 requires at least Sun Java 5 JDK
After the successful installation of Java 5 (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-5-sun) on the command line.
Latest versions of deegree 2 might also work with JDK 6, but is not officially recommended.
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. If you download the installation package including the WAR file you will need a servlet container installation that implements the Java's servlet 2.4 specification, e.g.
Apache Tomcat: We recommend the latest Tomcat 5 release (currently 5.5.35).
Latest versions of deegree 2 where successfully deployed also with Apache Tomcat 6 / JDK 6, but is not officially recommended.
2.2. PostgreSQL / PostGIS
The minimum recommended versions are:
- PostgreSQL 8.0
- PostGIS 1.2
Tested versions are:
- PostgreSQL 8.2, 8.3
- PostGIS 1.2, 1.3, 1.4 (2.0 won't work!!)
2.3. Oracle
The minimum recommended versions are:
- Oracle 9
Tested versions are:
- 9, 10, 11
Please refer the non free lib section, on how to get/add the required oracle libraries.