Setting up an Apache Ignite Docker Build
To build the additional Apache Ignite Docker image necessary to support ThingWorx HA, perform both of the following actions:
Make sure the required Ignite files are present in the staging folder and are available for the build process.
Modify the build.env variable file with appropriate values, if using a version of Ignite different from the provided files.
Ignite Required Files
The following files must be present in the staging folder.
Platform
Description
java
The OpenJDK - Amazon Coretto 11.x.x file obtained from Amazon Web Services or the Java JDK (version 11 or 8) archive file obtained from Oracle.
If you want to use some other image as a base, make the required changes in dockerfiles\ignite\Dockerfile
Example file:
amazon-corretto-11.x.x-linux-x64.tar.gz
ThingWorx Ignite Archives
The ThingWorx Ignite Archives are included in the staging folder and should be included in the Docker builds automatically. Make sure the CACHE_API_ARCHIVE and CACHE_IGNITE_ARCHIVE variables in the staging folder match your build.env settings.
Docker Helper Archive
The docker-helper program is included in the staging folder and should be included in the Docker builds automatically. Make sure the version and archive file names in the staging folder match your build.env settings.
Apache Ignite Archive
The Apache Ignite Archive is included in the staging folder and should be included in the Docker builds automatically. Make sure the IGNITE_ARCHIVE variable in the staging folder matches your build.env settings.
Ignite build.env Variable
The build.env file contains a list of variables that you must set. The following variables must be set:
Variable Name
Default
Comment
IGNITE_VERSION
2.9.0
The Apache Ignite Library Version.
IGNITE_ARCHIVE
apache-ignite-2.9.0-bin.zip
The Apache Ignite Library name as it exists in the staging folder.
CACHE_API_ARCHIVE
cache-provider-api-3.5.3.0.jar
The file name of the Thingworx Cache API Library zip as it exists in the staging folder.
CACHE_IGNITE_ARCHIVE
cache-provider-ignite-3.5.3.0.jar
The file name of the ThingWorx Cache Ignite Library zip as it exists in the staging folder.
DOCKER_HELPER_ARCHIVE
docker-helper-11.17.2.6-application.tar.gz
The version of the docker-helper archive as it exists in the staging folder.
Staging Ignite Files
You must place the required files for building the Docker image in the staging folder that is part of this release. The staging folder should already contain a base platform-settings.json file.
To download Apache Ignite automatically:
1. Make sure you have set the build.env file variables appropriately.
2. Run the command ./build.sh stage.
If there are no errors, the files should be in the staging folder and they should match your build.env settings.
Was this helpful?