Docker Java-Image with Oracle Server JRE 8 Update 152 as basis for Trivadis Engineering, especially for the work on Oracle Unified Directory (OUD) and Docker.

This docker image is based on the official Oracle Linux slim image (oraclelinux). It has been extended with the following Linux packages and configuration:

• Upgrade of all installed packages to the latest release (yum upgrade)
• Install the following additional packages including there dependencies:
  • unzip A utility for unpacking zip files
  • zip A file compression and packaging utility compatible with PKZIP
  • tar A GNU file archiving program
• Install Oracle Server JRE 8 update 152

The purpose of this image is provide base image for miscellaneous engineering work on Oracle Unified Directory (OUD) and Docker. The following docker images are indirectly based on this images or build with similar structures.

• oehrlis/docker-oud
• oehrlis/docker-oudsm

The following environment variable have been used for the installation:

The docker image has to be build manually based on oehrlis/docker-java from GitHub. Due to license restrictions from Oracle I can not provide this image on a public Docker repository (see OTN Developer License Terms). The required Software has to be downloaded prior image build. Alternatively it is possible to specify MOS credentials in scripts/.netrc or via build arguments.

The Oracle Software required to setup the docker image is not public available. It is subject to Oracle's license terms. For this reason a valid license is required (eg. OTN Developer License Terms). In addition, Oracle's license terms and conditions must be accepted before downloading.

The following software is required for the Oracle Unified Directory docker image:

• Oracle Java Development Kit (JDK) 1.8 (1.8u152)

The software can either be downloaded from My Oracle Support (MOS), Oracle Technology Network (OTN) or Oracle Software Delivery Cloud (OSDC). The following steps will refer to the MOS software download to simplify the build process.

Simplest method to build the Java image is to manually download the required software. However this will lead to bigger docker images, since the software is copied during build, which temporary blow up the container file-system. But its more safe because you do not have to store any MOS credentials.

The corresponding links and checksum can be found in *.download files in the softwarefolder. Alternatively the Oracle Support Download Links:

• Oracle Java Server JRE 8 update 152 Patch 26595894 or direct

Copy the file to the softwarefolder.

cp p26595894_180152_Linux-x86-64.zip.zip docker-java/software

Build the docker image either by using docker build or build.sh.

docker build -t oehrlis/java .

scripts/build.sh

The advantage of an automatic software download during build is the reduced image size. No additional image layers are created for the software and the final docker image is about 50MB smaller. But the setup script (setup_java.sh) requires the MOS credentials to download the software with curl. Curl does read the credentials from the .netrc file in scripts folder. The .netrc file will be copied to /opt/docker/bin/.netrc, but it will be removed at the end of the build.

Create a .netrc file with the credentials for login.oracle.com.

echo "machine login.oracle.com login <MOS_USER> password <MOS_PASSWORD>" >docker-oud/scripts/.netrc

Build the docker image either by using docker build or build.sh.

    docker build -t oehrlis/java .

    scripts/build.sh

This method is similar to the automatic download with .netrc file. Instead of manually creating a .netrc file it will created based on build parameter. Also with this method the .netrc file is deleted at the end.

Build the docker image with MOS credentials as arguments.

docker build --build-arg MOS_USER=<MOS_USER> --build-arg MOS_PASSWORD=<MOS_PASSWORD> -t oehrlis/java .

Since this is more of a basic image for further development work, it makes only limited sense to create a container. Nevertheless it is simple to just create a container by executing docker run.

    docker run -it --name java oehrlis/java
    
    docker run -it --name java oehrlis/java java -version

Please file your bug reports, enhancement requests, questions and other support requests within Github's issue tracker:

• Existing issues
• submit new issue

docker-oud is licensed under the Apache License, Version 2.0. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0.

To download and run Oracle Unifified Directory , regardless whether inside or outside a Docker container, you must download the binaries from the Oracle website and accept the license indicated at that page. See OTN Developer License Terms and Oracle Database Licensing Information User Manual