Setting Up TIBCO BusinessWorks™ Container Edition Application Monitoring for HTTPS Server on Docker

The following steps describe how to set up TIBCO BusinessWorks Container Edition Monitoring application on HTTPS Server for Docker.

Prerequisites

Download the bwce_mon-<version>.zip TIBCO BusinessWorks™ Container Edition monitoring zip file, from http://edelivery.tibco.com.

Procedure

  1. Extract the bwce_mon-<version>.zip file.
  2. Navigate to the bwce_mon directory and add the keys and certificates files in the certs folder and update the https_config.json file. For more information on updating the JSON file see, Updating HTTP Config JSON file.
    Note: In the https_config.json file, make sure that either the "key" or "pfx" keys are present, if not the HTTPS Server will fail to start.
  3. Run the following command to build the application monitoring image.
    docker build -t bwce/monitoring:latest
  4. To establish a connection between the monitoring application and the databases pass the two environment variables.
    PERSISTENCE_TYPE
    DB_URL
    1. You must also provide the following environment variable to start the application monitoring on the HTTPS Server.
      HTTPS

      The value of the environment variable is true.

    2. To run the monitoring application on Docker container on HTTPS Server, run the following command.
      For MySQL
      docker run -p 8080:8080 -p 443:443 -e PERSISTENCE_TYPE="mysql" -e DB_URL="mysql://<user name:password>@<machine:port/database>" -e HTTPS=true --name <containerName> <monitoringImageName:tag>
      For PostgreSQL
      docker run -p 8080:8080 -p 443:443 -e PERSISTENCE_TYPE="postgres" -e DB_URL="postgresql://<user name:password>@<machine:port/database>" -e HTTPS=true --name <containerName> <monitoringImageName:tag>
      For MS SQL Server
      docker run -p 8080:8080 -p 443:443 -e PERSISTENCE_TYPE="mssql" -e DB_URL="mssql://<user name:password>@<machine:port/database>" -e HTTPS=true --name <containerName> <monitoringImageName:tag>
  5. Optional. If the monitoring application is using a self-generated CA certificate, this CA certificate should be added in the <BWCE_HOME>/docker/resources/addons/certs folder. The format for the certificate should be non encrypted binary.
  6. Run the following command to view the running container.
    docker ps -a
  7. After the monitoring container runs successfully, you can access the monitoring UI by using following URL in the browser:
    https://<docker-host-ip>:443