Getting Started with ThingWorx Docker
To get up and running quickly with the Dockerfiles, perform the following steps:
1. Download Java and place it in the staging folder.
◦ Update build.env with the downloaded Java version.
2. Download ThingWorx and place it in the staging folder.
◦ The ThingWorx artifact should be named Thingworx-Platform-[H2|Postgres|Mssql|Azuresql]-version.zip. Rename the file as necessary and mention the version in build.env under PLATFORM_VERSION.
3. Run the ./build.sh stage command.
4. Enter ./build.sh type for the persistence provider you would like to use.
type can be one of the following values:
◦ h2
◦ postgres
◦ mssql
◦ azuresql
5. Update the docker-compose-type.yml file for the desired persistence provider.
◦ For h2, specify THINGWORX_INITIAL_ADMIN_PASSWORD.
◦ For postgres, specify
TWX_DATABASE_USERNAME,
TWX_DATABASE_PASSWORD, and
TWX_DATABASE_SCHEMA in both the postgresql and platform sections, and
THINGWORX_INITIAL_ADMIN_PASSWORD in the platform section. Ensure you define the variables identically in both postgresql and platform sections for the environment to get started. Additional variables for postgresql and their details can be found at the
Docker Hub.
|
TWX_DATABASE_USERNAME must match TWX_DATABASE_SCHEMA due to a limitation of the existing implementation. Also, TWX_DATABASE_USERNAME must not be "postgres".
|
◦ For mssql, specify TWX_DATABASE_PASSWORD and THINGWORX_INITIAL_ADMIN_PASSWORD in the platform section.
6. Type docker-compose -f docker-compose-type.yml up -d.
You should be up and running and able to access your docker image via the URL
localhost:8080/Thingworx.