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

The following steps describe how to set up aTIBCO BusinessWorks Container Edition monitoring application on the HTTPS Server for Docker.

Before you begin 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. Next, 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, ensure that either the "key" or "pfx" keys are present. If not, the HTTPS server fails 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 database 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 a Docker container on the 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 must 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 the following URL in the browser:
    https://<docker-host-ip>:443