ThingWorx Docker 라이선싱

설치 및 업그레이드 > ThingWorx 설치 > ThingWorx Docker 사용 > 단일 서버 환경에서 ThingWorx Docker 사용 > ThingWorx Docker 라이선싱

ThingWorx 8.0 이상에 대한 라이선스 파일이 있어야 합니다. ThingWorx Docker 라이선스를 구하는 방법은 세 가지입니다. PTC Licensing 서버에 인증하여 자동으로 라이선스를 다운로드하거나, Docker 컨테이너에 조직의 license.bin을 포함하거나, 제한된 모드에서 ThingWorx 인스턴스를 시작하고 PTC 지원에서 라이선스를 받을 수 있습니다.

Authentication Method

인증 방법을 사용하려면 다음을 수행하십시오.

1. 인스턴스를 시작할 때 docker-compose.yml 파일의 environment 섹션에 다음 옵션을 추가합니다.

environment:
- LS_USERNAME=${PTCUSERNAME}
- LS_PASSWORD=${PTCPASSWORD}

2. ${PTCUSERNAME} 및 ${PTCPASSWORD}를 PTC 지원 사이트에 대한 사용자 이름 및 암호로 바꿉니다.

이렇게 하면 라이선스 파일이 /ThingworxPlatform 폴더로 다운로드됩니다.

라이선스 포함 방법

라이선스 포함 방법을 사용하려면 다음을 수행하십시오.

1. 조직의 license.bin 파일을 docker-compose.yml 파일과 동일한 디렉터리에 배치합니다.

2. docker-compose 파일의 플랫폼 서비스에 속하는 다음 줄의 주석 처리를 제거합니다.

# Use this to mount your orgs licence file, if not ThingWorx will fallback to temporary licence
volumes:
- ./mylicense.bin:/ThingworxPlatform/license.bin

제한된 모드 방법

PTC 지원 사이트에 대한 로그인 자격 증명이 없는 경우 docker-compose.yml 파일에 자격 증명(LC_USERNAME 또는 LC_PASSWORD)을 추가하지 않고 제한된 모드에서 인스턴스를 시작할 수 있습니다. ThingWorx Platform은 임시 라이선스를 나타내는 licenseRequestFile.txt 파일을 /ThingworxPlatform 폴더에 생성합니다. 실제 라이선스를 받으려면 PTC 기술 지원에 문의하십시오. 라이선스 파일이 있으면 /ThingworxPlatform 폴더에 대한 볼륨 마운트를 만들고 볼륨 마운트한 폴더에 라이선스 파일을 배치하고 다음 명령을 사용하여 환경을 중지한 다음 다시 실행합니다.

docker compose down

docker compose up -d

라이선스 문제 해결

다음 표에는 문제 해결이 필요할 수 있는 몇 가지 문제가 나와 있습니다.

문제	가능한 해결 방법
thingworx.war 배포 문제	ThingworxStorage/extensions/web-inf 폴더에 라이선스 라이브러리(DLL 파일)가 포함되어 있는지 확인합니다.
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	Tomcat web.xml 파일의 최대 파일 크기를 늘려야 합니다(기본값: 50MB). 이 파일의 위치는 다음과 같습니다. <path to Tomcat>\Apache Software Foundation\Tomcat 8.5\webapps\manager\WEB-INF 1. web.xml를 엽니다. 2. 최대 파일 크기 및 최대 요청 크기를 104857600으로 변경합니다. 3. 파일을 저장한 후 닫습니다. 4. Tomcat을 다시 시작합니다.
PTC 라이선스가 있는 확장을 가져올 때 다음 오류 메시지가 나타납니다. is licensed but cannot find feature in license.bin file	PTC 지원 사이트의 라이선스 관리 섹션으로 이동하여 권한과 일치하는 올바른 라이선스 파일을 확인합니다. 라이선스에 대해 추가 지원이 필요하면 라이선스 관리 팀에 문의하십시오.
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)	Tomcat의 Java 구성에서 -Djava.library.path를 제거한 다음 ThingWorx 배포를 취소합니다.
다음과 유사한 오류 메시지가 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	로그 메시지는 라이선스 파일에 문제가 있는지 여부를 확인합니다.
다음과 유사한 오류 메시지가 플랫폼을 시작하는 동안 나타납니다. 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.	브라우저에서 라이선스 파일이 열려 있거나, 편집되었거나, 저장되었을 수 있습니다. 라이선스 파일을 다시 다운로드하여 해당 파일 이름을 license_capability_response.bin으로 바꾼 다음 편집하거나 저장하지 않고 ThingworxPlatform 폴더에 배치합니다.

도움이 되셨나요?