インストールおよび設定 > ThingWorx のインストール > インストールの付録 > platform-settings.json コンフィギュレーションの詳細
platform-settings.json コンフィギュレーションの詳細
platform-settings.json ファイルは、管理者が設定を微調整できるように用意されたもので、ソフトウェアダウンロードで入手できます。
* 
次の例には、すべてのオプションが含まれています。永続化プロバイダは 1 つだけ必要です。
{
"PlatformSettingsConfig": {
"BasicSettings": {
"BackupStorage": "/ThingworxBackupStorage",
"DatabaseLogRetentionPolicy": 7,
"EnableBackup": true,
"EnableHA": false,
"EnableSystemLogging": false,
"EnableSSO": false,
"FileRepositoryRoot": "/ThingworxStorage",
"HTTPRequestHeaderMaxLength": 2000,
"HTTPRequestParameterMaxLength": 2000,
"InternalAesCryptographicKeyLength": 128,
"Storage": "/ThingworxStorage",
"ScriptTimeout": 30
},
"SolutionCentralSettings": {
"SolutionCentralHost": "<Solution Central host name>",
"KeyStorePath": "<Path for your keystore>",
"KeyStorePass": "<Password for your keystore>"
},
"AdministratorUserSettings": {
"InitialPassword": "changeme"
},
"ContentTypeSettings": {
"supportedMediaEntityContentTypes" : ["image/svg+xml","image/png","image/gif","image/bmp","image/jpeg","application/pdf","image/vnd.microsoft.icon"]
},
"OrchestrationSettings": {
"EnableOrchestration": true,
"QueueHost": "localhost",
"QueuePort": 5672,
"QueueName": "256mb",
"QueueUsername": "flowuser",
"QueuePassword": "encrypt.queue.password",
"QueueVHost": "orchestration"
},
"ExtensionPackageImportPolicy": {
"importEnabled": false,
"allowJarResources": false,
"allowJavascriptResources": false,
"allowCSSResources": false,
"allowJSONResources": false,
"allowWebAppResources": false,
"allowEntities": false,
"allowExtensibleEntities": false
},
"HASettings": {
"CoordinatorConnectionTimeout": 15000,
"CoordinatorHosts": "127.0.0.1:2181",
"CoordinatorMaxRetries": 3,
"CoordinatorRetryTimeout": 1000,
"CoordinatorSessionTimeout": 90000,
"CoordinatorZNode": "/HALeadershipCoordinator",
"LoadBalancerBase64EncodedCredentials": "QWRtaW5pc3RyYXRvcjphZG1pbg=="
},
"LicensingConnectionSettings": {
"username": "<username>",
"password": "<password>",
"timeout":"60",
"useProxy": false,
"proxyHost": "<proxyHost>",
"proxyPort" : "<proxy port>",
"proxyScheme": "<http or https>",
"proxyUseNTLM": true,
"proxyUsername": "<user>",
"proxyPassword": "<user password>",
"proxyWorkstation": "<dummyWorkstation>",
"proxyDomain": "<dummyDomain>"
}
},
"PersistenceProviderPackageConfigs": {
"NeoPersistenceProviderPackage": {
"StreamProcessorSettings": {
"maximumBlockSize": 2500,
"maximumQueueSize": 250000,
"maximumWaitTime": 10000,
"scanRate": 5,
"sizeThreshold": 1000
},
"ValueStreamProcessorSettings": {
"maximumBlockSize": 2500,
"maximumQueueSize": 500000,
"maximumWaitTime": 10000,
"scanRate": 5,
"sizeThreshold": 1000
},
"PersistentPropertyProcessorSettings": {
"maximumBlockSize": 2500,
"maximumWaitTime": 1000,
"maximumQueueSize": 100000,
"numberOfProcessingThreads": 20,
"scanRate": 25,
"sizeThreshold": 1000
}
},
"H2PersistenceProviderPackage": {
"ConnectionInformation": {
"acquireIncrement": 5,
"acquireRetryAttempts": 30,
"acquireRetryDelay": 1000,
"checkoutTimeout": 2000,
"idleConnectionTestPeriod": 6,
"initialPoolSize": 10,
"maxConnectionAge": 0,
"maxIdleTime": 0,
"maxIdleTimeExcessConnections": 36000,
"maxPoolSize": 100,
"maxStatements": 0,
"maxStatementsPerConnection": 50,
"minPoolSize": 10,
"numHelperThreads": 6,
"password": "password",
"tableLockTimeout": 10000,
"testConnectionOnCheckout": false,
"unreturnedConnectionTimeout": 0,
"username": "twadmin"
},
"StreamProcessorSettings": {
"maximumBlockSize": 2500,
"maximumQueueSize": 250000,
"maximumWaitTime": 10000,
"numberOfProcessingThreads": 5,
"scanRate": 5,
"sizeThreshold": 1000
},
"ValueStreamProcessorSettings": {
"maximumBlockSize": 2500,
"maximumWaitTime": 10000,
"maximumQueueSize": 500000,
"numberOfProcessingThreads": 5,
"scanRate": 5,
"sizeThreshold": 1000
},
"PersistentPropertyProcessorSettings": {
"maximumBlockSize": 2500,
"maximumWaitTime": 1000,
"maximumQueueSize": 100000,
"numberOfProcessingThreads": 20,
"scanRate": 25,
"sizeThreshold": 1000
}
},
"PostgresPersistenceProviderPackage": {
"ConnectionInformation": {
"acquireIncrement": 5,
"acquireRetryAttempts": 3,
"acquireRetryDelay": 10000,
"checkoutTimeout": 1000000,
"driverClass": "org.postgresql.Driver",
"fetchSize": 5000,
"idleConnectionTestPeriod": 60,
"initialPoolSize": 5,
"jdbcUrl": "jdbc:postgresql://localhost:5432/thingworx",
"maxConnectionAge": 0,
"maxIdleTime": 0,
"maxIdleTimeExcessConnections": 300,
"maxPoolSize": 100,
"maxStatements": 100,
"minPoolSize": 5,
"numHelperThreads": 8,
"password": "password",
"testConnectionOnCheckout": false,
"unreturnedConnectionTimeout": 0,
"username": "twadmin"
},
"StreamProcessorSettings": {
"maximumBlockSize": 2500,
"maximumQueueSize": 250000,
"maximumWaitTime": 10000,
"numberOfProcessingThreads": 5,
"scanRate": 5,
"sizeThreshold": 1000
},
"ValueStreamProcessorSettings": {
"maximumBlockSize": 2500,
"maximumQueueSize": 500000,
"maximumWaitTime": 10000,
"numberOfProcessingThreads": 5,
"scanRate": 5,
"sizeThreshold": 1000
},
"PersistentPropertyProcessorSettings": {
"maximumBlockSize": 2500,
"maximumWaitTime": 1000,
"maximumQueueSize": 100000,
"numberOfProcessingThreads": 20,
"scanRate": 25,
"sizeThreshold": 1000
}
},
"MssqlPersistenceProviderPackage": {
"ConnectionInformation": {
"acquireIncrement": 5,
"acquireRetryAttempts": 3,
"acquireRetryDelay": 10000,
"checkoutTimeout": 1000000,
"driverClass": "com.microsoft.sqlserver.jdbc.SQLServerDriver",
"fetchSize": 5000,
"idleConnectionTestPeriod": 60,
"initialPoolSize": 5,
"jdbcUrl": "jdbc:sqlserver://localhost:1433;databaseName=thingworx;applicationName=Thingworx;",
"maxConnectionAge": 0,
"maxIdleTime": 0,
"maxIdleTimeExcessConnections": 300,
"maxPoolSize": 100,
"maxStatements": 100,
"minPoolSize": 5,
"numHelperThreads": 8,
"password": "Password@123",
"testConnectionOnCheckout": false,
"unreturnedConnectionTimeout": 0,
"username": "msadmin"
},
"StreamProcessorSettings": {
"maximumBlockSize": 2500,
"maximumQueueSize": 250000,
"maximumWaitTime": 10000,
"numberOfProcessingThreads": 5,
"scanRate": 5,
"sizeThreshold": 1000
},
"ValueStreamProcessorSettings": {
"maximumBlockSize": 2500,
"maximumWaitTime": 10000,
"maximumQueueSize": 500000,
"numberOfProcessingThreads": 5,
"scanRate": 5,
"sizeThreshold": 1000
},
"PersistentPropertyProcessorSettings": {
"maximumBlockSize": 2500,
"maximumWaitTime": 1000,
"maximumQueueSize": 100000,
"numberOfProcessingThreads": 20,
"scanRate": 25,
"sizeThreshold": 1000
}
}
}
}
platform-settings.json のオプション
以下に示すすべてのデータベースで、値ストリームプロセッサの設定およびストリームプロセッサの設定について次のガイドラインに従う必要があります。
StreamProcessorSettings.numberOfProcessingThreads + ValueStreamProcessorSettings.numberOfProcessingThreads < 50% of DB connection pool
And
ValueStreamProcessorSettings.numberOfProcessingThreads >= StreamProcessorSettings.numberOfProcessingThreads
基本設定
設定
デフォルト
説明
BackupStorage
/ThingworxBackupStorage
すべてのバックアップの書き込み先となるディレクトリ名。
DatabaseLogRetentionPolicy
7
データベースログが維持される日数。
EnableBackup
true
バックアップを維持するかどうかを決定します。
EnableHA
false
ThingWorx を高可用性 (HA) 環境用に設定できるかどうかを決定します。
EnableSystemLogging
false
システムのログを有効にするかどうかを決定します。
* 
ThingWorx のサポートから指示がないかぎり、これを有効にしないでください。
EnableSSO
false
ThingWorx Platform で SSO を有効にするには、true に設定します。SSO を有効にすると、すべての認証は sso-settings.json ファイルで設定されている中央の認証サーバーにリダイレクトされます。エッジの websocket 認証には影響がありません。
FileRepositoryRoot
/ThingworxStorage
ルートファイルリポジトリが作成されるディレクトリ。スタンドアロン展開ではデフォルトの場所で十分です。ThingWorx HA 展開では、ThingWorx のすべてのサーバーがアクセスできる共有のファイルシステムにリポジトリを配置する必要があります。
HTTPRequestHeaderMaxLength
2000
HTTP リクエストヘッダーの値に許容される最大の長さです。
HTTPRequestParameterMaxLength
2000
HTTP リクエストパラメータ値に許容される最大の長さです。
InternalAesCryptographicKeyLength
128
対称 AES キーの生成時に使用されるキーの長さ。サポートされる値は、128、192、256 です。
* 
キーの長さが 128 より大きく、そのキーのサイズを使用するように Java ポリシーが設定されていない場合、暗号化と解読に失敗します。
Storage
/ThingworxStorage
(バックアップストレージを除く) すべてのストレージを作成/配置するディレクトリ。
ScriptTimeout
30
ThingWorx プラットフォームがスクリプトを終了するまでに、スクリプトが実行できる最大時間 (秒数)。
* 
スクリプトの実行がこのタイムアウトに設定された秒数より長くなると、プラットフォーム上のスクリプトは自動的に終了します。
* 
タイムアウト時間を設定する際には、スクリプトによって処理される情報の機密性や重要性を考慮してください。セキュリティ上の理由から、一定の時間が経過した後でスクリプトを終了することが重要ですが、これを早まって実行するとデータが失われる可能性があります。ThingWorx Platform には柔軟性があるので、使用例の中には、デフォルトよりも必要なタイムアウト時間が短いものや長いものもあります。
Solution Central の設定
設定
デフォルト
説明
SolutionCentralHost
sc.thingworx.com
Solution Central のホスト名。
SolutionCentralPort
443
Solution Central のポートの詳細。
* 
デフォルト値がある場合には SolutionCentralPort を設定しないでください。
KeyStorePath
/ThingworxPlatform/sc-keystore
キーストアへのパス。
KeyStorePass
なし
キーストアのパスワード。
* 
パスワードを暗号化するには、KeyStorePassencrypt.sc.password に設定します。
ThingWorx Flow の設定
これらのプロパティは ThingWorx Flow が ThingWorx Foundation にインストールされている場合にのみ適用されます。これらの値は ThingWorx Flow コンフィギュレーションファイルと RabbitMQ コンフィギュレーションファイルの両方で定義する必要があり、両方のアプリケーションで変更されないかぎり、編集してはなりません。
設定
デフォルト
説明
EnableOrchestration
true
ThingWorx Foundation で ThingWorx Flow が有効であるかどうかを示します。
QueueHost
localhost
RabbitMQ ホスト名
QueuePort
5672
RabbitMQ ポート
QueueName
256mb
RabbitMQ キュー名
QueueUsername
flowuser
RabbitMQ キューのユーザー名
QueuePassword
encrypt.queue.password
RabbitMQ キューのパスワード
* 
パスワードは ThingWorx Foundation と同じマシンに ThingWorx Flow をインストールする際に自動的に暗号化されます。
ThingWorx Flow を ThingWorx Foundation とは異なるマシンにインストールする場合、 このパスワードを暗号化する必要があります。
QueueVHost
orchestration
RabbitMQ VHost 名
拡張パッケージのインポートポリシー
デフォルトでは、すべてのユーザーで拡張機能のインポートが無効になっています。拡張機能のインポート機能を設定するには、以下の設定を使用します。詳細については、 拡張機能のインポートを参照してください。
設定
説明
デフォルト
importEnabled
拡張機能をインポートできるか (=true) インポートできないか (=false) を表すトップレベルのコントロール。
false
"importEnabled": false - ExtensionPackageImportPolicy のその他の設定が true に設定されている場合でも、拡張機能をインポートできません。
"importEnabled": true - 拡張機能のインポートを次のセットの allow<Content>Resources 設定に渡します (以下の行を参照)。
* 
allow<Content>Resources の設定が false の場合、空の拡張機能 (エンティティ、拡張可能なエンティティ、リソースがない) をインポートできます。これは実用的なコンフィギュレーションではないので、importEnabled が true に設定されている場合、allow<Content>Resources のその他の設定のうち少なくとも 1 つを true に設定する必要があります。
allowJarResources
Jar リソースを含む拡張機能のインポートを許可します。
false
"allowJarResources": true - マニフェスト内で jar ファイルを jar リソースとして宣言している拡張機能のインポートを許可します。
"allowJarResources": false - マニフェスト内で jar ファイルを jar リソースとして宣言している拡張機能のインポートを許可しません。
allowJavascriptResources
JavaScript リソースを含む拡張機能のインポートを許可します。
false
"allowJavascriptResources": true - マニフェスト内で JS タイプの JavaScript UI ファイルを JavaScript リソースとして宣言している拡張機能のインポートを許可します。
"allowJavascriptResources": false - マニフェスト内で JS タイプの JavaScript UI ファイルを JavaScript リソースとして宣言している拡張機能のインポートを許可しません。
allowCSSResources
CSS リソースを含む拡張機能のインポートを許可します。
false
"allowCSSResources": true - CSS UI ファイルリソースが含まれている拡張機能のインポートを許可します。
"allowCSSResources": false - CSS UI ファイルリソースが含まれている拡張機能のインポートを許可しません。
allowJSONResources
JSON リソース (ローカライズファイルなど) を含む拡張機能のインポートを許可します。
false
"allowJSONResources": true - JSON UI ファイルリソースが含まれている拡張機能のインポートを許可します。
"allowJSONResources": false - JSON UI ファイルリソースが含まれている拡張機能のインポートを許可しません。
allowWebAppResources
Web リソースを含む拡張機能のインポートを許可します。
false
"allowWebAppResources": true - WebApp UI ファイルリソースが含まれている拡張機能のインポートを許可します。
"allowWebAppResources": false - WebApp UI ファイルリソースが含まれている拡張機能のインポートを許可しません。
allowEntities
拡張不可エンティティを含む拡張機能のインポートを許可します。拡張不可エンティティの例:
アプリケーションキー
認証システム
ダッシュボード
データ解析定義
データシェイプ
GenericContentEntity と状態定義、スタイル定義、スタイルテーマなどの派生した子クラス
グループ
ローカライズテーブル
ログ
マッシュアップ
メディアエンティティ
メニュー
ModeledServiceProviderEntity と通知コンテンツなどの子クラス
ネットワーク
通知定義
組織
永続化プロバイダ
PersistenceProviderPackage と派生した子クラス
プロジェクト
Thing Shape
Thing Template
ユーザー
ボキャブラリと DataTagVocabulary、ModelTagVocabulary などの派生した子クラス
false
"allowEntities": true - マニフェスト内で拡張不可エンティティを宣言している拡張機能のインポートを許可します。
"allowEntities": false - マニフェスト内で拡張不可エンティティを宣言している拡張機能のインポートを許可しません。
allowExtensibleEntities
拡張不可エンティティを含む拡張機能のインポートを許可します。拡張可能エンティティの例:
DirectoryService と派生した子クラス
ExtensionPackage
InfoTableFunctions、EntityServices、EncryptionServices などの既成のリソースと同様にリソースとして使用されるカスタム関数/サービスが含まれているリソースと派生した子クラス。
* 
拡張機能の一部でない既成のサブシステムは影響を受けません。
ScriptFunctionLibrary と派生した子クラス。
Subsystem と派生した子クラス。
* 
拡張機能の一部でない既成のサブシステムは影響を受けません。
Thing パッケージ
ウィジェット
false
"allowExtensibleEntities": true - マニフェスト内で拡張可能エンティティを宣言している拡張機能のインポートを許可します。
"allowExtensibleEntities": false - マニフェスト内で拡張可能エンティティを宣言している拡張機能のインポートを許可しません。
HA の設定
PostgreSQL HA 環境コンフィギュレーションに固有の設定。上記の EnableHA 設定が false に設定されている場合、すべての設定が無視されます。CoordinatorHosts および LoadBalancerBase64EncodedCredentials は環境に合わせて修正する必要があります。
設定
デフォルト
説明
CoordinatorConnectionTimeout
15000
ThingWorx の優先度を調整する Apache ZooKeeper サービスとの接続が確立されるまでに待機する時間 (ミリ秒単位)。
CoordinatorHosts
127.0.0.1:2181
ThingWorx リーダーの選択を調整するために使用される Apache ZooKeeper サーバーのコンマ区切りリスト。文字列パターンは IP:ポートです (例: "127.0.0.1:2181, 127.0.0.2:2181")。
CoordinatorMaxRetries
3
ThingWorx の優先度を調整する Apache ZooKeeper サービスとの接続を確立するための再試行の最大許容数。
CoordinatorRetryTimeout
1000
各再試行の待機時間 (ミリ秒単位)。
CoordinatorSessionTimeout
90000
ThingWorx の優先度を調整する Apache ZooKeeper サービスからの "ハートビート" を受信せずに、ThingWorx が待機する時間 (ミリ秒単位)。
CoordinatorZNode
/HALeadershipCoordinator
1 つの Apache ZooKeeper サービスが複数の ThingWorx HA 展開で共有されている場合、この設定により ThingWorx HA 展開ごとに一意の値を指定する必要があります。この設定の値は任意ですが、/<任意のテキスト> というフォーマットに従う必要があります。たとえば、ThingWorx インスタンス TWX1 と TWX2 が HA システム A にあり、ThingWorx インスタンス TWX3 と TWX4 が HA システム B にある場合、TWX1 と TWX2 の CoordinatorZNode は /HAsystemA に設定され、TWX3 と TWX4 では /HAsystemB に設定されます。
LoadBalancerBase64EncodedCredentials
QWRtaW5pc3RyYXRvcjphZG1pbg==
HA ロードバランサーの Base64 エンコードの資格証明 (フォーマットは <ユーザー>:<一意のパスワード>)
* 
ThingWorx ユーザーを使用しないでください。
* 
Base64 encodes the ロードバランサーの設定で使用される一致する <ユーザー>:<一意のパスワード> 文字列。
管理者ユーザーの設定
設定
デフォルト
説明
InitialPassword
該当なし
初めて ThingWorx にログインするときに必要な初期管理者パスワード。最小長は、ユーザー管理サブシステムで設定できます (最小 10 文字、デフォルトは 14 文字)。詳細については、パスワードを参照してください。
コンテンツタイプの設定
設定
デフォルト
説明
supportedMediaEntityContentTypes
"image/svg+xml","image/png","image/gif","image/bmp","image/jpeg","application/pdf","image/vnd.microsoft.icon"
メディアエンティティに動的にリンク可能な有効な MIME コンテンツタイプのコンマ区切りリスト。さらにタイプを追加できます。
* 
コンテンツタイプが、別のサーバーからの、サポートされていないメディアエンティティタイプである場合、そのコンテンツはメディアエンティティでストリームされる代わりに、クライアントマシン上にファイルとしてダウンロードされます。
ライセンス接続の設定
設定
デフォルト
説明
username
該当なし
PTC サポートサイトのユーザー名
password
該当なし
PTC サポートサイトのパスワード
timeout (秒)
60
タイムアウト時間の経過後、次のエラーがアプリケーションログに記録されます。
License Server could not process request
useProxy
false
ライセンスのプロキシ設定を有効にします。true の場合、プロキシ設定を使用してライセンスサーバーに接続します。
proxyHost
プロキシホストの名前。
proxyPort
プロキシホストのポート番号。
proxyScheme
http
http または https
proxyUsername
プロキシサーバー接続が認証を必要とする場合の認証用のユーザー名。
proxyPassword
プロキシサーバー接続が認証を必要とする場合の認証用のパスワード。
* 
この値の暗号化については、 パスワードの暗号化を参照してください。
proxyUseNTLM
false
NTLM プロトコルを使用するためのオプション。
proxyWorkstation
NTLM 認証が必要な場合の、ネットワーク上のユーザーのコンピュータの名前。
proxyDomain
NTLM 認証が必要な場合の、ユーザーのドメインの名前。
NeoPersistenceProviderPackage
Neo4j 固有の永続化プロバイダの設定が含まれます。Neo4j が永続化プロバイダでない場合は、このセクション全体が無視されます。
設定
デフォルト
説明
StreamProcessorSettings
maximumBlockSize
2500
1 つのブロックで処理されるストリーム書き込みの最大数。
maximumQueueSize
250000
キューに追加される (その後は却下される) ストリームエントリの最大数。
maximumWaitTime
10000
ストリームバッファをフラッシュする前の最大待機時間 (ミリ秒)。
scanRate
5
バッファステータスをチェックするレート (ミリ秒)。
sizeThreshold
1000
ストリームバッファをフラッシュするまで累積されるアイテムの最大数。
ValueStreamProcessorSettings
maximumBlockSize
2500
1 つのブロックで処理されるストリーム書き込みの最大数。
maximumQueueSize
500000
キューに追加される (その後は却下される) ストリームエントリの最大数。
maximumWaitTime
10000
ストリームバッファをフラッシュする前の最大待機時間 (ミリ秒)。
scanRate
5
バッファステータスをチェックするレート (ミリ秒)。
sizeThreshold
1000
ストリームバッファをフラッシュするまで累積されるアイテムの最大数。
PersistentPropertyProcessorSettings
maximumBlockSize
2500
1 つのブロックで処理されるプロパティ書き込みの最大数。
maximumWaitTime
1000
プロパティバッファをフラッシュする前の最大待機時間 (ミリ秒)。
maximumQueueSize
100000
キューに追加される (その後は却下される) プロパティエントリの最大数。
numberOfProcessingThreads
20
プロパティを処理するときに使用するスレッド数。
scanRate
25
バッファステータスをチェックするレート (ミリ秒)。
sizeThreshold
1000
プロパティバッファをフラッシュするまで累積されるアイテムの最大数。
H2PersistenceProviderPackage
設定
デフォルト
説明
接続情報
acquireIncrement
5
プールが使い果たされた場合に ThingWorx が取得しようとする一度の接続数を指定します。
acquireRetryAttempts
30
停止の前に ThingWorx がデータベースから新規接続を取得しようとする回数を指定します。
acquireRetryDelay
1000
取得を試行する間に ThingWorx が待機する時間 (ミリ秒)。
checkoutTimeout
1000000
プールが使い果たされた場合に getConnection() を呼び出すクライアントが接続のチェックインまたは取得を待機するミリ秒数。
idleConnectionTestPeriod
6
プロセス以外 (ファイアウォールなど) からアイドル接続が閉じられないように、接続をテストする時間 (秒)。この数値が 0 より大きい場合、ThingWorx はプールされているがチェックアウトされていないすべてのアイドル接続を、x 秒おきにテストします。
* 
"モデルプロバイダへの接続がない" というエラーが発生した場合は、この設定を見直します。ファイアウォールのデフォルト値と比較してください。デフォルト値より下回ると、切断の問題が緩和されます。
initialPoolSize
10
起動時にプール内で作成され維持されるデータベース接続の初期数。minPoolSizemaxPoolSize 間にする必要があります。
maxConnectionAge
0
事実上の有効期間 (秒)。maxConnectionAge より古い接続は破棄され、プールからパージされます。
maxIdleTime
0
接続が未使用のままプールされている秒数。この時間を経過すると接続が破棄されます。ゼロはアイドル接続が失効しないことを意味します。
maxIdleTimeExcessConnections
36000
minPoolSize を超過した接続がプール内で淘汰される前にアイドル状態でいることを許可される秒数。スパイク後にロードレベルが減少し、取得した接続が必要なくなった場合に、開いている接続数を積極的に最小化して、プールを minPoolSize まで縮小しようとするアプリケーションを対象としています。maxIdleTime が設定されている場合、maxIdleTimeExcessConnections を小さくして影響を与える必要があります。ゼロに設定するとこれが適用されなくなり、過剰接続は破棄されません。
maxPoolSize
100
プールが常に維持する接続の最大数。
maxStatements
0
ThingWorx グローバル PreparedStatement キャッシュのサイズ。
maxStatementsPerConnection
50
接続ごとの ThingWorx グローバル PreparedStatement キャッシュのサイズ。
minPoolSize
5
プールが常に維持する接続の最小数。
numHelperThreads
6
生成するヘルパースレッド数。一般的に、低速な JDBC オペレーションは競合ロックを獲得しないヘルパースレッドによって実行されます。このようなオペレーションを複数のスレッドに分散させると、複数のオペレーションを同時に実行可能になり、パフォーマンスが大幅に向上します。
password
該当なし
データベースのパスワード。
username
twadmin
データベースのユーザー名。
tableLockTimeout
10000
データベーステーブルがロック解除されるのをクライアントが待機するミリ秒数。
testConnectionOnCheckout
false
true の場合、接続チェックアウトのたびに操作が実行され、接続が有効であることを確認します。
unreturnedConnectionTimeout
0
応答しない接続を破棄する前に、そこからの応答を待機する秒数。設定された場合、アプリケーションがチェックアウトしたが、指定の時間内に接続にチェックインできない場合、プールがその接続を破棄します。これにより、最終的に接続プールを使い果たすことなく、偶発的に接続リークを起こしたアプリケーションが生き残れます。ゼロはタイムアウトしないことを意味し、アプリケーション自らが接続を閉じることが求められます。
StreamProcessorSettings
maximumBlockSize
2500
1 つのブロックで処理されるストリーム書き込みの最大数。
maximumQueueSize
250000
キューに追加される (その後は却下される) ストリームエントリの最大数。
maximumWaitTime
10000
ストリームバッファをフラッシュする前の最大待機時間 (ミリ秒)。
numberOfProcessingThreads
5
プロパティを処理するときに使用するスレッド数。
scanRate
5
バッファステータスをチェックするレート (ミリ秒)。
sizeThreshold
1000
ストリームバッファをフラッシュするまで累積されるアイテムの最大数。
ValueStreamProcessorSettings
maximumBlockSize
2500
1 つのブロックで処理されるストリーム書き込みの最大数。
maximumQueueSize
250000
キューに追加される (その後は却下される) ストリームエントリの最大数。
maximumWaitTime
10000
ストリームバッファをフラッシュする前の最大待機時間 (ミリ秒)。
numberOfProcessingThreads
5
プロパティを処理するときに使用するスレッド数。
scanRate
5
バッファステータスをチェックするレート (ミリ秒)。
sizeThreshold
1000
ストリームバッファをフラッシュするまで累積されるアイテムの最大数。
PersistentPropertyProcessorSettings
maximumBlockSize
2500
1 つのブロックで処理されるプロパティ書き込みの最大数。
maximumWaitTime
1000
プロパティバッファをフラッシュする前の最大待機時間 (ミリ秒)。
maximumQueueSize
100000
キューに追加される (その後は却下される) プロパティエントリの最大数。
numberOfProcessingThreads
20
プロパティを処理するときに使用するスレッド数。
scanRate
25
バッファステータスをチェックするレート (ミリ秒)。
sizeThreshold
1000
プロパティバッファをフラッシュするまで累積されるアイテムの最大数。
PostgresPersistenceProviderPackage
設定
デフォルト
説明
ConnectionInformation
acquireIncrement
5
プールが使い果たされた場合にプラットフォームが取得しようとする一度の接続数を指定します。
acquireRetryAttempts
3
停止の前に ThingWorx がデータベースから新規接続を取得しようとする回数を指定します。
acquireRetryDelay
10000
取得を試行する間に ThingWorx が待機する時間 (ミリ秒)。
checkoutTimeout
10000000
プールが使い果たされた場合に getConnection() を呼び出すクライアントが接続のチェックインまたは取得を待機するミリ秒数。
driverClass
org.postgresql.Driver
接続を提供することになっている JDBC driverClass の完全修飾クラス名。
fetchSize
5000
クライアント側ですべての行をキャッシュする代わりに、バッチ内でフェッチされる行数。
idleConnectionTestPeriod
60
この数値が 0 より大きい場合、ThingWorx はプールされているがチェックアウトされていないすべてのアイドル接続を、x 秒おきにテストします。
initialPoolSize
5
起動時にプール内で作成され維持されるデータベース接続の初期数。minPoolSizemaxPoolSize 間にする必要があります。
jdbcUrl
jdbc:postgresql://localhost:5432/thingworx
PostgreSQL への接続に使用する jdbc URL。
* 
デフォルトスキーマ名が (public から) 変更された場合、<データベース名>?currentSchema=<スキーマ名> を追加する必要があります。たとえば、スキーマ名が mySchema の場合、次のようになります。 jdbc:postgresql://<DBServer>:<DBPort>/<databasename>?currentSchema=mySchema
* 
HA ソリューションを設定する場合、ここには pgPool プロセスを実行するサーバー IP を反映する必要があります。pgPool が提供するポートにポートを変更します。
maxConnectionAge
0
事実上の有効期間 (秒)。maxConnectionAge より古い接続は破棄され、プールからパージされます。
maxIdleTime
0
接続が未使用のままプールされている秒数。この時間を経過すると接続が破棄されます。ゼロはアイドル接続が失効しないことを意味します。
maxIdleTimeExcessConnections
300
minPoolSize を超過した接続がプール内で淘汰される前にアイドル状態でいることを許可される秒数。スパイク後にロードレベルが減少し、取得した接続が必要なくなった場合に、開いている接続数を積極的に最小化して、プールを minPoolSize まで縮小しようとするアプリケーションを対象としています。maxIdleTime が設定されている場合、maxIdleTimeExcessConnections を小さくして影響を与える必要があります。ゼロに設定するとこれが適用されなくなり、過剰接続は破棄されません。
maxPoolSize
100
プールが常に維持する接続の最大数。
maxStatements
100
ThingWorx グローバル PreparedStatement キャッシュのサイズ。
minPoolSize
5
プールが常に維持する接続の最小数。
numHelperThreads
8
生成するヘルパースレッド数。一般的に、低速な JDBC オペレーションは競合ロックを獲得しないヘルパースレッドによって実行されます。このようなオペレーションを複数のスレッドに分散させると、複数のオペレーションを同時に実行可能になり、パフォーマンスが大幅に向上します。
password
<一意のパスワード>
データベースへのログインに使用するパスワード。
testConnectionOnCheckout
false
true の場合、接続チェックアウトのたびに操作が実行され、接続が有効であることを確認します。
unreturnedConnectionTimeout
0
応答しない接続を破棄する前に、そこからの応答を待機する秒数。設定された場合、アプリケーションがチェックアウトしたが、指定の時間内に接続にチェックインできない場合、プールがその接続を破棄します。これにより、最終的に接続プールを使い果たすことなく、偶発的に接続リークを起こしたアプリケーションが生き残れます。ゼロはタイムアウトしないことを意味し、アプリケーション自らが接続を閉じることが求められます。
username
twadmin
テーブルを修正する権限を持っているユーザー。これは、ThingWorx サーバーのデータベース上で作成されるユーザーです。
* 
PostgreSQL のパスワードを変更するには: このユーザーのパスワードを変更し、さらに platform-settings.json ファイルで暗号化されていないパスワード設定を変更するか、/ThingworxStorage/keystore.jks キーストアで暗号化されている値を変更します。
ストリームプロセッサの設定
maximumBlockSize
2500
1 つのブロックで処理されるストリーム書き込みの最大数。
maximumQueueSize
250000
キューに追加される (その後は却下される) ストリームエントリの最大数。
maximumWaitTime
10000
ストリームバッファをフラッシュするまでシステムが待機するミリ秒数。
numberOfProcessingThreads
5
処理スレッド数。
scanRate
5
指定した間隔の値 (ミリ秒) でバッファステータスがチェックされます。
sizeThreshold
1000
ストリームバッファをフラッシュするまで累積されるアイテムの最大数。
値ストリームプロセッサの設定
maximumBlockSize
2500
1 つのブロックで処理される値ストリーム書き込みの最大数。
maximumQueueSize
500000
キューに追加される (その後は却下される) ストリームエントリの最大数。
maximumWaitTime
10000
値ストリームバッファをフラッシュするまでシステムが待機するミリ秒数。
numberofProcessingThreads
5
処理スレッド数。
scanRate
5
ストリームバッファをフラッシュする前のレート (ミリ秒)。
sizeThreshold
1000
値ストリームバッファをフラッシュするまで累積されるアイテムの最大数。
PersistentPropertyProcessorSettings
maximumBlockSize
2500
1 つのブロックで処理されるプロパティ書き込みの最大数。
maximumWaitTime
1000
プロパティバッファをフラッシュする前の最大待機時間 (ミリ秒)。
maximumQueueSize
100000
キューに追加される (その後は却下される) プロパティエントリの最大数。
numberOfProcessingThreads
20
プロパティを処理するときに使用するスレッド数。
scanRate
25
バッファステータスをチェックするレート (ミリ秒)。
sizeThreshold
1000
プロパティバッファをフラッシュするまで累積されるアイテムの最大数。
MssqlPersistenceProviderPackage
設定
デフォルト
説明
ConnectionInformation
acquireIncrement
5
プールが使い果たされた場合に ThingWorx が取得しようとする一度の接続数を指定します。
acquireRetryAttempts
3
停止の前に ThingWorx がデータベースから新規接続を取得しようとする回数を指定します。
acquireRetryDelay
10000
取得を試行する間に ThingWorx が待機する時間 (ミリ秒)。
checkoutTimeout
1000000
プールが使い果たされた場合に getConnection() を呼び出すクライアントが接続のチェックインまたは取得を待機するミリ秒数。
driverClass
com.microsoft.sqlserver.jdbc.SQLServerDriver
接続を提供することになっている JDBC driverClass の完全修飾クラス名。
fetchSize
5000
クライアント側ですべての行をキャッシュする代わりに、バッチ内でフェッチされる行数。
idleConnectionTestPeriod
60
プロセス以外 (ファイアウォールなど) からアイドル接続が閉じられないように、接続をテストする時間 (秒)。この数値が 0 より大きい場合、ThingWorx はプールされているがチェックアウトされていないすべてのアイドル接続を、x 秒おきにテストします。
* 
"モデルプロバイダへの接続がない" というエラーが発生した場合は、この設定を見直します。ファイアウォールのデフォルト値と比較してください。デフォルト値より下回ると、切断の問題が緩和されます。
initialPoolSize
5
起動時にプール内で作成され維持されるデータベース接続の初期数。minPoolSizemaxPoolSize 間にする必要があります。
jdbcUrl
jdbc:sqlserver://localhost:1433;databaseName=thingworx;applicationName=Thingworx;
MSSQL への接続に使用する jdbc URL。
maxConnectionAge
0
事実上の有効期間 (秒)。maxConnectionAge より古い接続は破棄され、プールからパージされます。
maxIdleTime
0
接続が未使用のままプールされている秒数。この時間を経過すると接続が破棄されます。ゼロはアイドル接続が失効しないことを意味します。
maxIdleTimeExcessConnections
300
minPoolSize を超過した接続がプール内で淘汰される前にアイドル状態でいることを許可される秒数。スパイク後にロードレベルが減少し、取得した接続が必要なくなった場合に、開いている接続数を積極的に最小化して、プールを minPoolSize まで縮小しようとするアプリケーションを対象としています。maxIdleTime が設定されている場合、maxIdleTimeExcessConnections を小さくして影響を与える必要があります。ゼロに設定するとこれが適用されなくなり、過剰接続は破棄されません。
maxPoolSize
100
プールが常に維持する接続の最大数。
maxStatements
100
ThingWorx グローバル PreparedStatement キャッシュのサイズ。
minPoolSize
5
プールが常に維持する接続の最小数。
numHelperThreads
8
生成するヘルパースレッド数。一般的に、低速な JDBC オペレーションは競合ロックを獲得しないヘルパースレッドによって実行されます。このようなオペレーションを複数のスレッドに分散させると、複数のオペレーションを同時に実行可能になり、パフォーマンスが大幅に向上します。
password
<一意のパスワード>
データベースへのログインに使用するパスワード。
testConnectionOnCheckout
false
true の場合、接続チェックアウトのたびに操作が実行され、接続が有効であることを確認します。
unreturnedConnectionTimeout
0
応答しない接続を破棄する前に、そこからの応答を待機する秒数。設定された場合、アプリケーションがチェックアウトしたが、指定の時間内に接続にチェックインできない場合、プールがその接続を破棄します。これにより、最終的に接続プールを使い果たすことなく、偶発的に接続リークを起こしたアプリケーションが生き残れます。ゼロはタイムアウトしないことを意味し、アプリケーション自らが接続を閉じることが求められます。
username
msadmin
TWSCHEMA スキーマを所有するユーザー ID で、JDBC 接続文字列で MSSQL への認証のために使用されます。
ストリームプロセッサの設定
maximumBlockSize
2500
1 つのブロックで処理されるストリーム書き込みの最大数。
maximumQueueSize
250000
キューに追加される (その後は却下される) ストリームエントリの最大数。
maximumWaitTime
10000
ストリームバッファをフラッシュするまでシステムが待機するミリ秒数。
numberOfProcessingThreads
5
処理スレッド数。
scanRate
5
指定した間隔の値 (ミリ秒) でバッファステータスがチェックされます。
sizeThreshold
1000
ストリームバッファをフラッシュするまで累積されるアイテムの最大数。
値ストリームプロセッサの設定
maximumBlockSize
2500
1 つのブロックで処理される値ストリーム書き込みの最大数。
maximumWaitTime
10000
値ストリームバッファをフラッシュするまでシステムが待機するミリ秒数。
maximumQueueSize
500000
キューに追加される (その後は却下される) ストリームエントリの最大数。
numberofProcessingThreads
5
処理スレッド数。
scanRate
5
ストリームバッファをフラッシュする前のレート (ミリ秒)。
sizeThreshold
1000
値ストリームバッファをフラッシュするまで累積されるアイテムの最大数。
PersistentPropertyProcessorSettings
maximumBlockSize
2500
1 つのブロックで処理されるプロパティ書き込みの最大数。
maximumWaitTime
1000
プロパティバッファをフラッシュする前の最大待機時間 (ミリ秒)。
maximumQueueSize
100000
キューに追加される (その後は却下される) プロパティエントリの最大数。
numberOfProcessingThreads
20
プロパティを処理するときに使用するスレッド数。
scanRate
25
バッファステータスをチェックするレート (ミリ秒)。
sizeThreshold
1000
プロパティバッファをフラッシュするまで累積されるアイテムの最大数。