Building RMS Docker Image

TIBCO BusinessEvents provides a script file to build the RMS Docker image by using bundled Dockerfiles.

You can build the Docker image either by using existing TIBCO BusinessEvents installation (BE_HOME) from your computer or by using the software installer of TIBCO BusinessEvents and other required products. The Docker image generated by using software installers is of smaller size in comparison to the Docker image generated by using your TIBCO BusinessEvents installation.

For details about Dockerfiles provided with TIBCO BusinessEvents, see Dockerfile for TIBCO BusinessEvents.

Procedure

  • RMS Docker Image by Using Software Installers

    Go to the BE_HOME/cloud/docker/bin folder and run the RMS Docker image building script build_rms_image.

    Syntax:
    build_rms_image -l <installers-directory> [-a <rms-artifact-directory>] [-r <rms-image-name>:<rms-image-version>]  [-d <Dockerfile>] [-h]
    Example:
    build_rms_image -l /home/user/tibco/installers
  • (Windows and Linux Only) RMS Docker Image by Using Existing TIBCO BusinessEvents Installation

    Go to the BE_HOME/cloud/docker/frominstall folder and run the RMS Docker image building script build_rms_image.

    Syntax:
    build_rms_image [-l <BE_HOME_location>] [-a <rms-artifact-directory>] [-r <rms-image-name>:<rms-image-version>] [-d <Dockerfile>] [-h]
    Example:
    build_rms_image -r rms.server:1.0
Note: For the Windows platform, enclose all arguments in double quotes (").
RMS Docker Image Script Arguments
Argument Required/Optional Description
-l/--installers-location

(For the Docker image based on software installers)

Required The location where installers for TIBCO BusinessEvents, TIBCO ActiveSpaces, and TIBCO BusinessEvents add-ons (optional) are stored. This option is available for scripts that are run from BE_HOME/cloud/docker/bin.
-l/--be-home

(For the Docker image based on the existing TIBCO BusinessEvents installation)

Optional Specify TIBCO BusinessEvents installation (BE_HOME) location. This is optional if the script runs from its default location (BE_HOME/cloud/docker/frominstall).
-a/--app-location Optional If you have modified the RMS project, specify the location of the updated RMS.cdd and RMS.ear files.

If not specified, the script file takes the RMS.cdd and RMS.ear files bundled with TIBCO BusinessEvents installers.

-r/--repo Optional Name that you want to assign to the RMS Docker image.
Optionally, you can provide the version number for the Docker image. Use the following naming convention of the RMS Docker image:
<image-name>:[version-number]
For example, rms.server:latest.

The default value is rms:<BE_version>. For example, for version 5.6.0 of TIBCO BusinessEvents, the default value is rms:5.6.0.

-d/--dockerfile Optional The custom Dockerfile used for generating image. You can use your own Dockerfile or you can edit and use the Dockerfile provided with the TIBCO BusinessEvents installation.

If you have placed the Dockerfile at a location other than the default location, provide the path of the Dockerfile.

If not specified, the script uses the default bundled Dockerfile. For the list of default Dockerfiles associated with the scripts that are provided with TIBCO BusinessEvents, see Dockerfile for TIBCO BusinessEvents.

-h/--help Optional Provides help for the script file.

What to do next

Running RMS in Docker