Setting Up TIBCO BusinessWorks Container Edition Application Monitoring On Docker

The following steps describe how to set up anTIBCO BusinessWorks Container Edition application on Docker.

Before you begin Download the bwce_mon-<version>.zip file from http://edelivery.tibco.com.
    Procedure
  1. Extract the bwce_mon-<version>.zip file.
  2. Navigate to the bwce_mon directory and build the docker image by running the following command:
    docker build -t bwce/monitoring:latest .

  3. Ensure that MySQL or PostgreSQL or MS SQL Server is running and create the user with all the privileges. You can use a standalone Docker to run the monitoring application by passing the two environment variables.
    1. To start the application monitoring successfully, provide the following two environment variables:
      PERSISTENCE_TYPE
      DB_URL
    2. To run the monitoring application on a Docker container, run one of the following commands:
      For MySQL
      docker run -p 8080:8080 -e PERSISTENCE_TYPE="mysql" -e DB_URL="mysql://<user name:password>@<machine:port/database>" --name <containerName><monitoringImageName:tag>
      For PostgreSQL
      docker run -p 8080:8080 -e PERSISTENCE_TYPE="postgres" -e DB_URL="postgresql://<user name:password>@<machine:port/database>" --name <containerName><monitoringImageName:tag>
      For MS SQL Server
      docker run -p 8080:8080 -e PERSISTENCE_TYPE="mssql" -e DB_URL="mssql://<user name:password>@<machine:port/database>" --name <containerName><monitoringImageName:tag>

      To configure TIBCO BusinessWorks Container Edition Monitoring with the Azure Managed MS SQL Server, set the property DB_ENCRYPT to true. By default, this property is set to false.

    3. To configure TIBCO BusinessWorks Container Edition monitoring with MySQL database using SSL Configuration, you must configure the SSL at the Server and Client side. When starting the monitoring container, pass the following environment variables in the Docker run command:

      DB_SSL_MYSQL=true
      DB_SSL_CA=ca.pem
      DB_SSL_KEY=client-key.pem
      DB_SSL_CERT=client-cert.pem

      For example, run TIBCO BusinessWorks Container Edition monitoring by providing the hostname as an IP address.

      docker run -p 9054:8080 -e PERSISTENCE_TYPE="mysql" -e DB_URL="mysql://<user name:password>@<machine:port/database>" -e DB_SSL_CA="true" -e DB_SSL_CA="ca.pem" -e DB_SSL_KEY="client-key.pem" -e DB_SSL_CERT="client-cert.pem" --name <containerName><monitoringImageName:tag>
  4. To view the running container, run the following command:
    docker ps -a

  5. After the monitoring container runs successfully, you can access the monitoring UI by using the following URL in the browser:
    http://<docker-host-ip>:8080

    Note: The environment variable for application monitoring has been changed to PERSISTENCE_TYPE.

Configuring and running a monitoring application with Oracle On Docker

    Procedure
  1. Create a folder on the same level as the root directory and name the folder instantclient.
  2. Download Oracle client libraries from https://www.oracle.com/technetwork/topics/linuxx86-64soft-092277.html .
  3. Add the zip file to the instantclient folder. For example, instantclient-basic-linux.x64-19.5.0.0.0.zip.
  4. Rename the Dockerfile_Oracle to Dockerfile.
  5. On line 20, change the ENV CLIENT_FILENAME according to the client download in step 2.
  6. On line 27, change the libclntsh.so file name according to the client download and for 18.x or 19.x keep the line commented.
  7. Run the following command for Docker build.
    docker build -t bwcemonoracle 
  8. Run the following command for Docker.
    docker run -p 18080:8080 -e PERSISTENCE_TYPE="oracle" -e DB_URL="oracle://user:pass@machine:1521/orclpdb1" bwcemonoracle
    Note: Use URL encoding for special characters while providing special characters for the database username or password.