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.5+/PostGIS 2.5+
Get the Docker image for PostgreSQL with PostGIS extension installed and start the container with:
% docker pull postgis/postgis
% docker run --name postgis -p 5432:5432 -d postgis/postgis
see https://hub.docker.com/r/postgis/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-r2
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 ojdbc8.jar, version 12.2.0.1 or higher 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
