Install and run BBjServices in a docker container.
Before building the docker container, follow the following steps:
-
Download a BBj install jar and put it to the Dockerfile directory. This provides the BBjServices that will be installed. You can select the package you desire. Note that the Dockerfile is preconfigured with JDK21, so select a BBj version that fits that Java JDK version.
-
Run a Basis License Service (BLS) server somewhere on the network. This BLS server needs to be registered to serve licenses. This license server will be used by BBjServices for licensing.
-
Copy the
certificate.blsfile from the registered BLS server into the Dockerfile directory. This will allow BBjServices to connect to the license server and check out licenses.
We provide a build.sh script that will prompt the customer for a license server host (usually of the form <host>:<port>) and then build an image with the name "bbjservices". This is just a trivial shell script, so the customer can look at what the script does and handle it themselves.
If the customer wants to build the docker container manually, they just need to know ahead of time the license server host and what they want to name the image:
docker build --tag <image name> --build-arg "license_server=<license server host>" .
Once the docker image has been built, running it is straight-forward. The image exposes port 8888 for the BBjServices web server, but you may want other ports accessible depending on your use case. You may also want some persistent directories or change settings to the BBj cfg files. Adjust the Dockerfile or add scripts to customize to your needs.