Skip to content

Building TIBCO BusinessEvents

Jump to bottom
nthota edited this page Jun 3, 2021 · 6 revisions

You can Build TIBCO BusinessEvents using docker or buildah tool. buildah tool is supported only in linux variants. Complete information about buildah is available here. Complete information about docker is available here.

Prerequisites

  1. See Preparing for TIBCO BusinessEvents Containerization
  2. If you choose to build container image with docker Install from here.
  3. If you choose to build container image with buildah Install from here.

Build Script

TIBCO BusinessEvents provides the build_image script for building images of TIBCO BusinessEvents application and its components at BE_HOME\cloud\docker. Use the --image-type as below for the respective images:

  • app - To build the Container image for your TIBCO BusinessEvents application.
  • s2ibuilder - To build the S2i Container image for your TIBCO BusinessEvents application.
  • rms - To build the Container image for RMS.
  • teagent - To build the Container image for TIBCO BusinessEvents Enterprise Administrator Agent.
Usage: build_image.sh

 [-i/--image-type]    :    Type of the image to build ("app"|"rms"|"teagent"|"s2ibuilder") [required]
                           Note: For s2ibuilder image usage refer to be-tools wiki.

 [-a/--app-location]  :    Path to BE application where cdd, ear & optional supporting jars are present
                           Note: Required if --image-type is "app"
                                 Optional if --image-type is "rms"
                                 Ignored  if --image-type is "teagent" or "s2ibuilder"

 [-s/--source]        :    Path to BE_HOME or TIBCO installers (BusinessEvents, Activespaces or FTL) are present (default "../../")

 [-t/--tag]           :    Name and optionally a tag in the 'name:tag' format [optional]

 [-d/--docker-file]   :    Dockerfile to be used for generating image [optional]

 [--gv-provider]      :    Name of GV provider to be included in the image ("consul"|"http"|"custom") [optional]
                           To add more than one GV use comma separated format ex: "consul,http" 
                           Note: This flag is ignored if --image-type is "teagent"

 [--disable-tests]    :    Disables docker unit tests on created image (applicable only for "app" and "s2ibuilder" image types) [optional]

 [-b/--build-tool]    :    Build tool to be used ("docker"|"buildah") (default is "docker")
                           Note: s2ibuilder image and docker unit tests not supported for buildah.

 [-h/--help]          :    Print the usage of script [optional]

 NOTE : supply long options with '='

Note for the Windows platform

  • Use build_image.bat script and enclose all arguments in double quotes (")
  • Flags disable-tests and build-tool not applicable in windows environment.
  • If you are building from a Windows machine behind a firewall, you may see error like - "Unable to connect to the remote server". In such case you need to configure your firewall to allow all traffic on the nat virtual adapter which is only used by containers

Important Information

  • Docker version 18.09 introduces BuildKit for the improved docker build performance. By default build_image script uses BuildKit for the better build time. It can be disabled by using export DOCKER_BUILDKIT=0.

  • Openshift's Source-to-image toolkit can be downloaded from here. This toolkit is used to build TIBCO BusinessEvents application image from TIBCO BusinessEvents S2I Builder image.

  • s2ibuilder Image is not supported with buildah tool.

  • --disable-tests is not supported with buildah tool.

Details for building each component

  1. Building TIBCO BusinessEvents Application.

  2. Building TIBCO BusinessEvents RMS

  3. Building TIBCO BusinessEvents Enterprise Administrator Agent

Next Topic: Running TIBCO BusinessEvents

Parent Topic: Containerize TIBCO BusinessEvents

Clone this wiki locally