Skip to content

Latest commit

 

History

History
 
 

12.2.1.4.0

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
README.md
README.md
 
 
additionalBuildCmds.txt
additionalBuildCmds.txt
 
 
buildArgs
buildArgs
 
 

README.md

Building an Oracle Internet Directory image with WebLogic Image Tool

Contents

  1. Introduction
  2. Prerequisites
  3. Setup WebLogic Image Tool
  4. Download the required packages and installers
  5. Required build files
  6. Additional build commands
  7. Steps to Create Oracle Internet Directory image
  8. Generate Sample dockerfile with imagetool

1. Introduction

This README describes the steps involved in building an Oracle Internet Directory image with the WebLogic Image Tool.

2. Prerequisites

The following prerequisites are necessary before building Oracle Internet Directory container images with WebLogic Image Tool:

  • A working installation of Docker 18.03.1 or later
  • Bash version 4.0 or later (commands should be run in a bash shell)
  • JAVA_HOME environment variable set to the location of your JDK e.g: /scratch/export/oracle/product/jdk
  • git and unzip
  • Set WORK_DIR variable to a desired location of your choice e.g: /scratch/

3. Setup WebLogic Image Tool

  • Download the latest version of WebLogic Image Tool.
  • Extract the release archive (zip, tar.gz) content into WORK_DIR.
$ unzip imagetool.zip
Archive:  imagetool.zip
   creating: imagetool/
   creating: imagetool/lib/
  inflating: imagetool/lib/fluent-hc-4.5.12.jar
  inflating: imagetool/lib/httpclient-4.5.12.jar
  inflating: imagetool/lib/httpcore-4.4.13.jar
  inflating: imagetool/lib/commons-logging-1.2.jar
  inflating: imagetool/lib/commons-codec-1.11.jar
  inflating: imagetool/lib/httpmime-4.5.12.jar
  inflating: imagetool/lib/picocli-4.3.2.jar
  inflating: imagetool/lib/json-20200518.jar
  inflating: imagetool/lib/compiler-0.9.10.jar
   creating: imagetool/bin/
  inflating: imagetool/bin/setup.sh
  inflating: imagetool/bin/logging.properties
  inflating: imagetool/bin/imagetool.cmd
  inflating: imagetool/bin/imagetool.sh
  inflating: imagetool/LICENSE.txt
  inflating: imagetool/lib/imagetool_completion.sh
  inflating: imagetool/lib/imagetool.jar
  inflating: imagetool/VERSION.txt
$
  • Run the following commands to setup imagetool
$ cd $WORK_DIR/imagetool/bin
$ source setup.sh
  • Execute the following to validate the WebLogic Image Tool:
$ imagetool --version
imagetool:1.9.16
$

The WebLogic Image Tool creates a temporary Docker context directory, prefixed by wlsimgbuilder_temp, every time the tool runs.
Under normal circumstances, this context directory will be deleted.
However, if the process is aborted or the tool is unable to remove the directory, it is safe for you to delete it manually.
By default, the WebLogic Image Tool creates the Docker context directory under the user's home directory.
If you prefer to use a different directory for the temporary context, set the environment variable WLSIMG_BLDDIR.

$ export WLSIMG_BLDDIR="/path/to/dir"

The WebLogic Image Tool maintains a local file cache store.
This store is used to look up where the Java, WebLogic Server installers, and WebLogic Server patches reside in the local file system.
By default, the cache store is located in the user's $HOME/cache directory. Under this directory, the lookup information is stored in the metadata file.
All automatically downloaded patches also reside in this directory. You can change the default cache store location by setting the environment variable WLSIMG_CACHEDIR.

$ export WLSIMG_CACHEDIR="/path/to/cachedir"

4. Download the required packages,installers and patches

Download the required installers from the Oracle Software Delivery Cloud and save them in a directory of your choice e.g: $WORK_DIR/stage:

Create a stage directory under $WORK_DIR for downloading the below installers by using the following command:

$ mkdir -p $WORK_DIR/stage
  • Oracle Internet Directory 12.2.1.4.0
  • Oracle JDK
  • Oracle Fusion Middleware Infrastructure 12.2.1.4.0

Note: If the image is required to have patches included, download patches from My Oracle Support and copy to WORK_DIR/stage.

5. Required build files

The Oracle Internet Directory image requires additional files for creating and starting the Oracle Internet Directory instance in the container. Clone the Oracle docker-images repository repository. For example:

$ cd $WORK_DIR
$ git clone https://github.com/oracle/docker-images

This will create the required directories and files under $WORK_DIR/docker-images.

The files required for creation of the Oracle Internet Directory image can be located in the $WORK_DIR/docker-images/OracleInternetDirectory/dockerfiles/12.2.1.4.0/container-scripts directory.

6. Additional build commands

Oracle Internet Directory image requires additional build commands to set the required environment variables, install os packages and copy the additional build files to the image being built.

A sample additional build commands input file can be found at $WORK_DIR/docker-images/OracleInternetDirectory/imagetool/12.2.1.4.0/additionalBuildCmds.txt.

7. Steps to Create Oracle Internet Directory image

Add the required installers, packages and patches to the imagetool cache by running the following commands.

i) Add JDK package to Imagetool cache

$ imagetool cache addInstaller --type jdk --version 8u301 --path $WORK_DIR/stage/jdk-8u301-linux-x64.tar.gz

ii) Add installers to Imagetool cache

$ imagetool cache addInstaller --type oid --version 12.2.1.4.0 --path $WORK_DIR/stage/fmw_12.2.1.4.0_oid_linux64.bin
$ imagetool cache addInstaller --type fmw --version 12.2.1.4.0 --path $WORK_DIR/stage/fmw_12.2.1.4.0_infrastructure.jar

iii) Add Patches to Imagetool cache

In case patches are required to be included in image, they should be added to Imagetool cache:

$ imagetool cache addEntry --key 28186730_13.9.4.2.2 --value $WORK_DIR/stage/p28186730_139422_Generic.zip
$ imagetool cache addEntry --key 31400392_12.2.1.4.0 --value $WORK_DIR/stage/p31400392_122140_Generic.zip

iv) Create the Oracle Internet Directory image

Execute the imagetool create command to create the Oracle Internet Directory image.

The following parameters are provided as input to the create command,

  • jdkVersion - JDK version to be used in the image.
  • type - type of image to be built.
  • version - version of the image.
  • tag - tag name for the image.
  • additionalBuildCommands - additional build commands provided as a text file.
  • addtionalBuildFiles - path of additional build files as comma separated list.

Below is a sample command used to build an Oracle Internet Directory image.

$ imagetool create --jdkVersion=8u301 --type oid --version=12.2.1.4.0 \
    --tag=oracle/oid:12.2.1.4.0 \
    --chown=oracle:root \
    --additionalBuildCommands $WORK_DIR/docker-images/OracleInternetDirectory/imagetool/12.2.1.4.0/additionalBuildCmds.txt \
    --additionalBuildFiles $WORK_DIR/docker-images/OracleInternetDirectory/dockerfiles/12.2.1.4.0/container-scripts \
    --patches <patch_a>,<patch_b>,...

--patches option is required only when image is required to be generated with patches

v) View the Docker image

Run the docker images command to ensure the new Oracle Internet Directory image is loaded into the repository:

$ docker images
REPOSITORY                                                                   TAG                       IMAGE ID            CREATED             SIZE
oracle/oid                                                                   12.2.1.4.0                09294d0fd357        About an hour ago   5.09GB
...

8. Generate sample Dockerfile with imagetool

If you want to review a sample Dockerfile created with the imagetool issue the imagetool command with the --dryRun option:

imagetool @$WORK_DIR/docker-images/OracleInternetDirectory/imagetool/12.2.1.4.0/buildArgs --dryRun

License

To download and run Oracle Fusion Middleware products, regardless whether inside or outside a container, you must download the binaries from the Oracle website and accept the license indicated at that page.

All scripts and files hosted in this project and GitHub docker-images/OracleInternetDirectory repository required to build the images are, unless otherwise noted, released under UPL 1.0 license.

Copyright

Copyright (c) 2021, Oracle and/or its affiliates. Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl