deegree webservices on Docker

This projects contains sample Dockerfiles for building Docker images containing ready-to-use deegree webservices. This includes quick start Dockerfiles and samples to facilitate installation, configuration, and environment setup of deegree webservices running on different Java EE application servers and using different database systems for data storage.

Please consult the deegree documentation for further information how to configure and use deegree webservices. The Docker web site provides all information about Docker.

Docker images on Docker hub

https://hub.docker.com/r/tfr42/deegree/

How to run deegree with PostgreSQL 9.4+/PostGIS 2.2+

Get the Docker image for PostgreSQL with PostGIS extension installed and start the container with:

% docker pull mdillon/postgis
% docker run --name postgis -p 5432:5432 -d mdillon/postgis

see https://hub.docker.com/r/mdillon/postgis/ for more information.

Then start the container with deegree. Build the Docker image using the Dockerfile for the deegree WAR on Tomcat and start the container with:

% docker run --name deegree -p 8080:8080 --link postgis:db -d deegree/deegree-tomcat

To configure a JDBC connection for deegree use the deegree console and create a JDBC connection for PostgreSQL DB under "connections > databases":

<?xml version='1.0' encoding='UTF-8'?>
<JDBCConnection configVersion='3.4.0'  xmlns='http://www.deegree.org/jdbc' xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' xsi:schemaLocation='http://www.deegree.org/jdbc http://schemas.deegree.org/jdbc/3.4.0/jdbc.xsd'>
  <Url>jdbc:postgresql://db:5432/postgres</Url>
  <User>postgres</User>
  <Password>postgres</Password>
  <ReadOnly>false</ReadOnly>
</JDBCConnection>

How to run deegree with Oracle DB 11g/12c and Oracle WebLogic Server 12c

Oracle XE 11g (inofficial)

To run Oracle DB 11g inside a Docker container follow: https://github.com/wnameless/docker-oracle-xe-11g

% docker pull wnameless/oracle-xe-11g
% docker run --name oracle11g -p 49160:22 -p 49161:1521 -d wnameless/oracle-xe-11g

Oracle 12c

To run Oracle DB 12c inside a Docker container follow the official description on https://github.com/oracle/docker-images/tree/master/OracleDatabase:

% docker run --name oracle12g -p 49161:1521 --privileged -d oracle/database:12.2.0.1-ee

Oracle WebLogic Server 12c

To run Oracle WLS 12c (12.1 or 12.2) inside a Docker container follow: https://github.com/oracle/docker/tree/master/OracleWebLogic

% docker run --name wlsadmin -p 7001:7001 --link oracle11g:db -d 1221-domain

To configure a JDBC connection for deegree use the deegree console and create a JDBC connection for Oracle:

<JDBCConnection configVersion="3.4.0" xmlns="http://www.deegree.org/jdbc" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  xsi:schemaLocation="http://www.deegree.org/jdbc http://schemas.deegree.org/jdbc/3.4.0/jdbc.xsd">
  <Url>jdbc:oracle:thin:@db:1521:xe</Url>
  <User>system</User>
  <Password>oracle</Password>
  <ReadOnly>false</ReadOnly>
</JDBCConnection>

deegree on Tomcat HOWTOs

How to add Oracle JDBC driver to Apache Tomcat

First download the Oracle JDBC driver from Oracle Tech Net. Then copy the Oracle JDBC driver JAR file into the $CATALINA_HOME/lib directory inside the Docker container:

% docker cp PATH_TO/ojdbc8.jar deegree-tomcat:/usr/local/tomcat/lib

Before configuring a JDBC connection for Oracle you need to restart the Docker container with:

% docker restart deegree-tomcat

How to pass CATALINA_OPTS to Apache Tomcat

This is an example how to fix the issue with Oracle JDBC when running into the error ORA-01882: timezone region not found:

% docker run --env CATALINA_OPTS="-Doracle.jdbc.timezoneAsRegion=false -Duser.timezone=CET" -d deegree/deegree-tomcat

deegree on Oracle Weblogic HOWTOs

TBD

Use Docker Compose to run the Docker application

Use the sample Docker Compose file docker-compose.yml to run the multi-container Docker application:

% docker-compose up -d deegree 

Starts the docker container deegree-webapp-tomcat and postgis.

How to configure a deegree webservice

Check out the tutorial script posted on the branch "foss4g2016_workshop". The latestes workshop resources how to setup INSPIRE Network Services with deegree are available at https://github.com/lat-lon/deegree-workshop

Build status