インストールおよび設定 > ThingWorx Docker の使用 > ThingWorx Docker のライセンス
ThingWorx Docker のライセンス
ThingWorx 8.0 以降のライセンスファイルが必要です。ThingWorx Docker のライセンスを取得するには 2 つの方法があります。PTC ライセンスサーバーの認証を受けてライセンスを自動的にダウンロードするか、制限されたモードで ThingWorx インスタンスを開始して PTC サポートからライセンスを取得します。
認証による方法
認証による方法を使用するには、以下の手順に従います。
1. インスタンスを開始するときに、docker-compose.yml ファイルの environment セクションに以下のオプションを追加します。
environment:
- LS_USERNAME=${PTCUSERNAME}
- LS_PASSWORD=${PTCPASSWORD}
2. ${PTCUSERNAME} および ${PTCPASSWORD} を PTC サポートサイトのユーザー名とパスワードに置き換えます。
ライセンスファイルが /ThingworxPlatform フォルダにダウンロードされます。
制限されたモードによる方法
PTC サポートサイトへのログイン資格証明がない場合、資格証明 (LC_USERNAME または LC_PASSWORD) を docker-compose.yml ファイルに追加しないことによって、制限されたモードでインスタンスを開始できます。一時的なライセンスを表す 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 ファイルでファイル最大サイズを増やす必要があります (デフォルトは 50 MB)。このファイルは以下の場所にあります。
<path to Tomcat>\Apache Software Foundation\Tomcat 8.5\webapps\manager\WEB-INF
1. web.xml を開きます。
2. max-file-size と max-request-size を 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)
ThingWorx の展開を解除する前に、Tomcat の Java コンフィギュレーションから -Djava.library.path を除去します。
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 フォルダに配置します。