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.
- Procedure
- Extract the
bwce_mon-<version>.zip
file. - Navigate to the
bwce_mon directory and build the docker image by running the following command:
docker build -t bwce/monitoring:latest .
- 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.
- To start the application monitoring successfully, provide the following two environment variables:
PERSISTENCE_TYPE DB_URL
- 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 PostgreSQLdocker 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 Serverdocker 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
totrue
. By default, this property is set to false. - 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>
- To start the application monitoring successfully, provide the following two environment variables:
- To view the running container, run the following command:
docker ps -a
- 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 toPERSISTENCE_TYPE
.
Configuring and running a monitoring application with Oracle On Docker
- Procedure
- Create a folder on the same level as the root directory and name the folder
instantclient
. - Download Oracle client libraries from https://www.oracle.com/technetwork/topics/linuxx86-64soft-092277.html .
- Add the zip file to the
instantclient
folder. For example,instantclient-basic-linux.x64-19.5.0.0.0.zip
. - Rename the Dockerfile_Oracle to Dockerfile.
- On line 20, change the
ENV CLIENT_FILENAME
according to the client download in step 2. - 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. - Run the following command for Docker build.
docker build -t bwcemonoracle
- 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.
Subtopics