Setting up an Apache Ignite Docker Build
To build the additional Apache Ignite Docker image necessary to support ThingWorx HA, perform the following actions:
• Download the Ignite Dockerfiles from the PTC Software Download page by selecting ThingWorx Ignite > ThingWorx-Ignite-DockerFiles-v.v.
• 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
|
Used for ThingWorx Docker files Ignite–DockerFiles–2.8.0 and prior.
|
||
|
Template Processor Archive
|
The template-processor 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.
|
|
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
|
Used for ThingWorx Docker files Ignite–DockerFiles–2.8.0 and prior.
|
||
|
TEMPLATE_PROCESSOR_ARCHIVE
|
template-processor-11.17.2.6-application.tar.gz
|
The version of the Docker Helper Archive as it exists in the staging folder.
|
||
|
IGNITE_DEV_ONLY_LOGGING_DISABLED
|
true
|
While using Docker directly, set this flag as true. This prevents debug level logging information.
|
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.