Building the image

Overview

TIBCO EBX® Container Edition image is Linux based (amd64 architecture) and includes the following:

• Application Server Apache Tomcat® 9.0

• Java JDK 11

Requirement

The image can be built on a POSIX native system or using a compatible layer:

• Operating system: Linux, macOS, Windows (10 or 2019) using WSL2,

• Docker Engine installed and running,

• Access to Internet.

Building the image

Download installers

To build an EBX® image, one needs to download file TIB_ebx_6.0.10_addon_5.X.Y_container_edition.amd64.zip from TIBCO eDelivery.

Running the interactive installer

To start installer on Linux or macOS:

• Unzip the TIB_ebx_6.0.10_addon_5.X.Y_container_edition.amd64.zip,

• Open a terminal in folder where file ebx-ce-installer.sh file is located,

• Execute command ./ebx-ce-installer.sh.

To start installer on Windows 10 or greater:

• Unzip the TIB_ebx_6.0.10_addon_5.X.Y_container_edition.amd64.zip,

• Open a Windows PowerShell in folder where file ebx-ce-installer.bat file is located,

• Execute command ebx-ce-installer.bat.

Follow instructions and select addons to be added to the image.

The installer will then build the image and print a summary similar to:

**********************************************************************************************
The TIBCO EBX Container Edition image was successfully created with following names:
 ebx:latest
 ebx:6.0.10-mame-tese-dama-dmdv-5.X.Y
This image includes the following addon(s):
 Match and Merge (MAME)
 Information Search (TESE)
 Digital Asset Manager (DAMA)
 Data Model and Data Visualization (DMDV)
To run this image with the default configuration and an embedded database, use command:
 docker run -p 8080:8080 -d ebx:latest
You can test EBX by visiting http://localhost:8080 in a browser.
To run this image with other configurations, for example with an external database, see
documentation.
**********************************************************************************************

Running the batch installer

To start batch installer on Linux or macOS:

• Unzip the TIB_ebx_6.0.10_addon_5.X.Y_container_edition.amd64.zip,

• Open a terminal in folder where file ebx-ce-installer-batch.sh file is located,

• Execute command ./ebx-ce-installer-batch.sh [OPTION]…​ [addon]…​

Batch script to build image with optionally addon(s).

  -a             add all addons
  -t <tag_file>  create a file named tag_file including the image tag built
  --help         display this help and exit

  [addon]...     add specific addons (separate by a space)
                 for sample: mame tese

To start batch installer on Windows 10 or greater:

• Unzip the TIB_ebx_6.0.10_addon_5.X.Y_container_edition.amd64.zip,

• Open a Windows PowerShell in folder where file ebx-ce-installer-batch.bat file is located,

• Execute command ebx-ce-installer-batch.bat [OPTION]…​ [addon]…​

The batch installer will then build the image and print a summary identical to the interactive installer.

Testing the image

The image can be run locally using command:

docker run -p 8080:8080 -d ebx:latest

In production, it is recommended to not use tag latest. The installer will always generate another tag depending on selected addons.

If previous sample, the tag is 6.0.10-mame-tese-dama-dmdv-5.X.Y because the following addons where selected:

• Match and Merge (MAME),

• Information Search (TESE),

• Digital Asset Manager (DAMA),

• Data Model and Data Visualization (DMDV).

The image can then be run using command:

docker run -p 8080:8080 -d ebx:6.0.10-mame-tese-dama-dmdv-5.X.Y

If no addons are selected, the tag is 6.0.10

The image can be run using command:

docker run -p 8080:8080 -d ebx:6.0.10

Sharing the image

The steps to share an image depends on customer’s company infrastructure.

In following example, the image is pushed to a Docker private registry named myregistry:

docker tag ebx:6.0.10 myregistry:5000/ebx:6.0.10
docker push myregistry:5000/ebx:6.0.10