Licensing ThingWorx Docker
You must have a license file for ThingWorx 8.0 and later. There are three ways to get licensing for ThingWorx Docker. You can authenticate to the PTC Licensing server and automatically download a license, include your organization’s license.bin file in the docker container, or start the ThingWorx instance in limited mode and obtain a license from PTC Support.
Authentication Method
To use the authentication method:
1. When starting your instance, add the following options to the environment section in your docker-compose.yml file:
environment:
- LS_USERNAME=${PTCUSERNAME}
- LS_PASSWORD=${PTCPASSWORD}
2. Replace ${PTCUSERNAME} and ${PTCPASSWORD} with your user name and password for the PTC Support site.
This downloads the license file to your /ThingworxPlatform folder.
License Inclusion Method
To use the license inclusion method:
1. Place your organization’s license.bin file in the same directory as the docker-compose.yml file.
2. Uncomment the following lines belonging to the Platform service in the docker-compose file:
# Use this to mount your orgs licence file, if not ThingWorx will fallback to temporary licence
volumes:
- ./mylicense.bin:/ThingworxPlatform/license.bin
Limited Mode Method
If you do not have login credentials for the PTC Support site, you can start the instance in limited mode by not adding any credentials (LC_USERNAME or LC_PASSWORD) to your docker-compose.yml file. The ThingWorx Platform generates a licenseRequestFile.txt file in the /ThingworxPlatform folder which represents your temporary license. To get an actual license, contact PTC Technical Support. Once you have your license file, create a volume mount for the /ThingworxPlatform folder, place the license file in the folder you volume-mounted, and proceed to bringing your environment down and back up again using the following commands:
docker compose down
docker compose up -d
License Troubleshooting
Some possible issues that can require troubleshooting are described in the following table:
Issue
Possible Resolution
Problem deploying thingworx.war
Verify that the ThingworxStorage/extensions/web-inf folder contains the licensing libraries (DLL files).
The following error message appears when you deploy ThingWorx:
org.apache.catalina.core.ApplicationContext.log
HTMLManager: FAIL - Deploy Upload Failed, Exception:
org.apache.tomcat.util.http.fileupload.
FileUploadBase$SizeLimitExceededException: the
request was rejected because its size (90883556)
exceeds the configured maximum (52437800)
java.lang.IllegalStateException:
org.apache.tomcat.util.http.fileupload.FileUploadBase
$SizeLimitExceededException: the request was rejected
because its size (90883556) exceeds the configured
maximum (52437800)
at org.apache.catalina.connector.Request.
parseParts(Request.java:2871
The maximum file size in the Tomcat web.xml file must be increased (default is 50 MB). This file is located at:
<path to Tomcat>\Apache Software Foundation\Tomcat 8.5\webapps\manager\WEB-INF
1. Open web.xml.
2. Change the max-file-size and max-request-size to 104857600.
3. Save and close the file.
4. Restart Tomcat.
The following error message appears when you import a PTC-licensed extension:
is licensed but cannot find feature in license.bin
file
Go to the Manage Licenses section on the PTC Support site to confirm the correct license file that matches your entitlement. If you need further assistance with your licenses, contact the License Management team.
The following error message appears when you try to undeploy ThingWorx:
FAIL - Unable to delete [<path to Tomcat>\webapps\
Thingworx]. The continued presence of this file may
cause problems. Due to FlxCore64.dll (<path to
Tomcat>\webapps\Thingworx\WEB-INF\extensions\
FlxCore64.dll)
Remove -Djava.library.path from Tomcat’s Java configuration before undeploying ThingWorx.
An error message, similar to the following one, appears in the ConfigurationLog.log:
2017-03-10 05:56:07.097-0500 [L: ERROR] [O: ] [I: ]
[U: SuperUser] [S: ] [T: localhost-startStop-1]
**********LICENSING ERROR ANALYSIS
2017-03-10 05:56:07.097-0500 [L: ERROR] [O: ] [I: ]
[U: SuperUser] [S: ] [T: localhost-startStop-1]
/Library/flexs is listed as a java.library.path but
it does not exist.
/Library/blah is listed as a java.library.path but
it does not exist.
/Library/zzz is listed as a java.library.path but it
does not exist. No flx dll files found.
Is the java.library.path set?
2017-03-10 05:56:07.097-0500 [L: ERROR] [O: ] [I: ]
[U: SuperUser] [S: ] [T: localhost-startStop-1]
**********END LICENSING ERROR ANALYIS
The log message verifies if there is an issue with the license file.
An error message, similar to the following one, appears while the platform is starting:
2017-06-12 11:33:59.204+0530 [L: ERROR]
[O: c.t.s.s.l.LicensingSubsystem] [I: ]
[U: SuperUser] [S: ] [T: localhost-startStop-1]
[message: The size of provided data is incorrect.]
2017-06-12 11:33:59.205+0530 [L: ERROR]
[O: c.t.s.s.l.LicensingSubsystem] [I: ]
[U: SuperUser] [S: ] [T: localhost-startStop-1]
======================================
2017-06-12 11:33:59.205+0530 [L: ERROR]
[O: c.t.s.s.l.LicensingSubsystem] [I: ]
[U: SuperUser] [S: ] [T: localhost-startStop-1]
Invalid License file: /ThingworxPlatform\license.bin
2017-06-12 11:33:59.205+0530 [L: ERROR]
[O: c.t.s.s.l.LicensingSubsystem] [I: ]
[U: SuperUser] [S: ] [T: localhost-startStop-1]
======================================
2017-06-12 11:33:59.205+0530 [L: WARN]
[O: c.t.s.ThingWorxServer] [I: ]
[U: SuperUser] [S: ] [T: localhost-startStop-1]
Shutting down the Platform.
The license file may have been opened, edited, or saved in a browser. Download the license file again, rename it to license_capability_response.bin, and place it in the ThingworxPlatform folder without editing or saving it.
Was this helpful?