Steps to Build and Run the Docker Image

1. Download the domain binary files, AdminConsole Distribution as mentioned in the Prerequisites section of this document.
2. Extract the AdminConsole distribution.

3. Create a directory named externallibs to place the 3rd party application libraries, configuration, and property files required.

4. Copy the following configuration files from <Admin Console distribution zip>/conf directory into the externallibs/conf directory:

   • ac.properties

   • ac-oipa-jmxconnection-context.xml

5. Copy the following files from the <Admin Console distribution zip>/libs directory into the externallibs directory:

   • commons-logging-1.2-9f99a00.jar

   • eclipselink-2.7.6.jar

   • jakarta.persistence-2.2.3.jar

   • el-api-2.2.jar

   • Download aspectj 1.8.10.jar

     • Open aspectj-1.8.10.jar with an unzipping software and retrieve aspectjrt.jar and aspectjweaver.jar from the lib folder.

     • Copy aspectjrt.jar and aspectjweaver.jar into externallibs sub-directory.

6. Copy the database drivers for your database into this directory.

   • Oracle – The necessary driver, ojdbc8-12.2.0.1.jar, is included in the externallibs directory.

     • Microsoft SQL Server - Download the sqljdbc4.jar library version 4.0

   • IBM DB2 – The two necessary .jar files (db2jcc4 and db2jcc4_license_cu) are included with the purchase of the DB2 software. These files are not available for download. Contact your IT department if you need assistance in locating these files.

7. Use a text editor to open the ac.properties file that you just copied to the server. The ac.properties file contains properties for Oracle, SQL Server, and DB2 database types, with the Oracle settings active by default. The inactive settings are commented out with a '#' character at the start of each line. To change a setting, remove the '#' from the required property setting, and insert it at the beginning of the setting you want to deactivate.

8. These properties must match the type of database being used.

   Note: Refer to the ac. properties document in the Oracle Insurance Policy Administration Documentation Library on the OHC(Oracle Help Center) for a complete list of all properties and allowed values.

   • application.databaseType

   • jpa.databasePlatform

9. Identify the default locale in the ac.properties file. The locale selected will determine the translation that is loaded in the database for OIPA when it launches.

   • application.defaultLocale

10. If using an Oracle or Microsoft SQL Server database, skip this step. If using a DB2 database, modify the ac.properties file to include configuration for case-insensitive search. Modify the ac.properties file to include the following line:

    • search.field.text.caseInsensitive=true

11. Copy the downloaded AdminConsole distribution zip under the externallibs/zip directory.

Note: Maintain the externallibs folder and place the required libraries and the supported files which are discussed in earlier steps. Check the below snippets for your reference. Make sure to check the filenames are correct and if not, update them as mentioned in the below snippets.

The directory structure is,

Note: The PASSWORD file contains the WebSphere Admin Password which needed to access the IBM Console. Make sure to update this file according to the need before running the containerized application.

Under the "conf" folder,

Note: Place the AdminConsole build artifacts that are downloaded from the Oracle Software Delivery Cloud in the externallibs/zip directory. Check the below snippet for your reference.

From the copied location, execute the below command:

docker build format

$ docker build -t <Image_Name>:<Image_Tag> . --build-arg IBMID=<IBM-SSO_ID> --build-arg IBMID_PWD=<IBM-SSO_PASSWORD> --build-arg AC_PKG="<AC Package Name>"

docker build example

$ docker build -t ac_was:11.3.1.0 . --build-arg IBMID=IBMSSOUsername --build-arg IBMID_PWD=IBMSSOPassword --build-arg AC_PKG="AdminConsole-websphere-distribution.zip"

The admin console WebSphere image is generated.

To start the containerized AC application, run

docker run

$ docker run -itd --privileged --mount type=bind,source=/path/to/the/externallibs,target=/opt/IBM/externallibs --env-file /path/to/the/ac_env.dat -v /path/to/the/PASSWORD:/tmp/PASSWORD --name <Container_Name> --hostname localhost -p <AdminServer_External_Port>:<AdminServer_Container_Port> -p <MS_External_Port>:<MS_Container_Port> <Image_Name>:<Image_Tag> start_server.sh

docker run example

$ docker run -itd --privileged --mount type=bind,source=/scratch/oipa/oipa/ac_was/externallibs,target=/opt/IBM/externallibs --env-file /scratch/oipa/oipa/ac_was/ac_env.dat -v /scratch/oipa/oipa/ac_was/PASSWORD:/tmp/PASSWORD --name ac_was --hostname localhost -p 6043:6043 -p 6443:6443 -p 6040:6040 -p 6440:6440 -p 9085:9085 ac_was:11.3.1.0 start_server.sh

Check docker logs:

$ docker logs -f ac_was

The following are a few snippets of the admin console:

Admin Console DS

Admin Console Login

Admin Console Homepage