Docker Directory Structure

The downloaded upgradeutilityweb distribution has been placed in the path /scratch/oipa/docker/upgradeutilityweb as shown in the below screenshot.

The end user can create the same or different directory structure but docker image has to build by being in this folder where Docker file is present, and the same path has to be given in docker run command.

The folder structure also includes tomee.tar.gz which is downloaded as mentioned in the previous step.

Under the scripts home directory (/scripts)

Note: Place the UpgradeUtilityWeb.zip build artifact which is downloaded in the externallibs/zip directory. Check the below snippet for reference.

The downloaded UpgradeUtilityWeb distribution (as mentioned in prerequisite section) will have uuwebconf folder in it, copy the folder and place it under externallibs folder.

The uuwebconf folder has properties.json file. Open the json file and provide the backend application URL.

ex: http://localhost:6060

To define the following environment variables at docker run time using the -e option in the command line or define them in the uuweb_env.dat file.

The environment configuration variables, that need to be set for the TomEE server, and application configuration are defined below:

Configuration Parameters

Variable

Upgrade Utility Web Application Port

UUWEB_PORT

Server Shutdown Port

SHUTDOWN_PORT

Application Redirect Port

REDIRECT_PORT

 

Note: Refer to the uuweb_env.dat file for more information regarding these variables.

  1. UUWEB_PORT: Mention the Upgrade Utility Web Application port

    • Ex: UUWEB_PORT=7001

  2. SHUTDOWN_PORT: Mention the Server Port

    • Ex: SHUTDOWN_PORT=8001

  3. REDIRECT_PORT: Mention the Application Redirect Port

    • Ex:REDIRECT_PORT=7441

  4. EXT_LIB_PATH: Define the Package Location inside the container (it is configured based on the base image used. No need to change the value of it)

    • Ex:EXT_LIB_PATH=/usr/local/tomee/externallibs