安裝與組態 > 安裝 ThingWorx > 安裝附錄 > platform-settings.json 組態詳細資訊
platform-settings.json 組態詳細資訊
管理員可使用 platform-settings.json 檔案調整微調設定，該檔案可在軟體下載中找到。
* 
以下範例包含所有選項。只有一個持續性提供者為必填。
{
"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。
EnableSystemLogging
false
確定是否啟用系統記錄。
* 
除非經 ThingWorx 支援人員指示，否則請勿開啟這項設定。
EnableSSO
false
設定為 true 來為 ThingWorx Platform 啟用 SSO。啟用 SSO 後，所有驗證會重新導向至在 sso-settings.json 檔案中配置的中央授權伺服器。Edge 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 平台的彈性，有些使用案例可能需要比預設更短或更長的逾時期間。
解決方案中心設定
設定
預設值
描述
SolutionCentralHost
sc.thingworx.com
解決方案中心主機名稱。
SolutionCentralPort
443
解決方案中心埠詳細資訊。
* 
如果 SolutionCentralPort 有預設值，請勿予以設定。
KeyStorePath
/ThingworxPlatform/sc-keystore
keystore 的路徑。
KeyStorePass
無
keystore 的密碼。
* 
如需加密密碼，請將 KeyStorePass 設定為 encrypt.sc.password。
ThingWorx Flow 設定
只有在 ThingWorx Foundation 中已安裝 ThingWorx Flow 的情況下，這些內容才適用。必須在 ThingWorx Flow 與 RabbitMQ 組態檔案中定義這些值，除非跨兩個應用程式變更，否則不得編輯這些值。
設定
預設值
描述
EnableOrchestration
true
指示是否在 ThingWorx Foundation 中啟用 ThingWorx Flow。
QueueHost
本機主機
RabbitMQ 主機名稱
QueuePort
5672
RabbitMQ 埠
QueueName
256mb
RabbitMQ 佇列名稱
QueueUsername
flowuser
RabbitMQ 佇列使用者名稱
QueuePassword
encrypt.queue.password
RabbitMQ 佇列密碼
* 
當在與 ThingWorx Foundation 相同的電腦中安裝 ThingWorx Flow 時，會自動加密密碼。
如果在與 ThingWorx Foundation 不同的電腦中安裝 ThingWorx Flow，您需要 加密此密碼。
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 也應該設定為 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 與衍生的子類別
• 專案
• 物形式
• 物範本
• 使用者
• 詞彙與衍生的子類別，例如 DataTagVocabulary、ModelTagVocabulary
false
• "allowEntities": true - 允許匯入在資訊清單中宣告非可延伸實體的延伸功能。
• "allowEntities": false - 不允許匯入在資訊清單中宣告非可延伸實體的延伸功能。
allowExtensibleEntities
允許匯入含有非可延伸實體的延伸功能。可延伸實體的範例包括：
• DirectoryService 與衍生的子類別
• ExtensionPackage
• 包含自訂功能/服務的資源與衍生子類別，這些功能/服務可作為與 OOTB 資源類似的資源使用，例如 InfoTableFunctions、EntityServices 與 EncryptionServices。
* 
不屬於延伸功能一部份的 OOTB 子系統不會受到影響。
• ScriptFunctionLibrary 與衍生的子類別。
• 子系統與衍生的子類別。
* 
不屬於延伸功能一部份的 OOTB 子系統不會受到影響。
• 物件封裝
• 小器具
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:port。(例如 "127.0.0.1:2181，127.0.0.2:2181")。
CoordinatorMaxRetries
3
與用來協調 ThingWorx 主導權的 Apache ZooKeeper 服務建立連線的最大允許重試次數。
CoordinatorRetryTimeout
1000
為每個重試嘗試等待的時間長度 (毫秒)。
CoordinatorSessionTimeout
90000
ThingWorx 等待而不會從用來協調 ThingWorx 主導權的 Apache ZooKeeper 服務收到 "heartbeat" 的時間長度 (以毫秒計)。
CoordinatorZNode
/HALeadershipCoordinator
當一種 Apache ZooKeeper 服務由多個 ThingWorx HA 部署共用時，此設定必須針對每個 ThingWorx HA 部署提供具唯一性的值。此設定的值可以是任意的，但必須遵循 /<anyTextHere> 這一格式。例如，ThingWorx 實例 TWX1 和 TWX2 處於 HA 系統 A 中，而 ThingWorx 實例 TWX3 和 TWX4 處於 HA 系統 B 中。對於 TWX1 與 TWX2，CoordinatorZNode 會設定為 /HAsystemA，而對於 TWX3 與 TWX4，它會設定為 /HAsystemB。
LoadBalancerBase64EncodedCredentials
QWRtaW5pc3RyYXRvcjphZG1pbg==
HA 負載平衡器的 Base64 編碼認證，格式為 <使用者>:<具唯一性的密碼>。
* 
請勿使用 ThingWorx 使用者。
* 
您可以使用 Base64 編碼負載平衡器設定中所用相符 <使用者>:<具唯一性的密碼> 字串的任何公用程式。
管理員使用者設定
設定
預設值
描述
InitialPassword
n/a
第一次登入 ThingWorx 時所需的初始管理員密碼。最小長度可以在使用者管理子系統中配置 (最小值 10 個字元，預設為 14 個字元)。如需詳細資訊，請參閱密碼。
內容類型設定
設定
預設值
描述
supportedMediaEntityContentTypes
"image/svg+xml","image/png","image/gif","image/bmp","image/jpeg","application/pdf","image/vnd.microsoft.icon"
可動態連結至「媒體」實體之有效 MIME 內容類型的逗號分隔清單。可以新增其他類型。
* 
如果內容類型來自不同伺服器，而且不是受支援的類型，則會將內容下載為用戶端電腦上的檔案，而不是以媒體實體串流。
授權連線設定
設定
預設值
描述
username
n/a
PTC 支援網站使用者名稱
password
n/a
PTC 支援網站密碼
timeout (秒)
60
在逾時期間之後，「應用程式記錄檔」中會記錄下列錯誤：
License Server could not process request
useProxy
false
針對授權啟用 proxy 設定。如果設定為 true，會使用 proxy 設定來連線至授權伺服器。
proxyHost
Proxy 主機的名稱。
proxyPort
Proxy 主機的埠號。
proxyScheme
http
http 或 https。
proxyUsername
如果 proxy 伺服器連線需要驗證，則為驗證的使用者名稱。
proxyPassword
如果 proxy 伺服器連線需要驗證，則為驗證的使用者密碼。
* 
如需有關為此值加密的資訊，請參閱 加密密碼 。
proxyUseNTLM
false
使用 NTLM 通訊協定的選項。
proxyWorkstation
如果需要 NTLM 驗證，則為網路上使用者電腦的名稱。
proxyDomain
如果需要 NTLM 驗證，則為使用者網域的名稱。
NeoPersistenceProviderPackage
包含專屬 Neo4j 的「持續性提供者」設定。如果 Neo4j 不是持續性提供者，則應略過整個部份。
設定
預設值
描述
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
設定
預設值
描述
連線資訊
acquireIncrement
5
決定 ThingWorx 在集區耗盡時會試著一次擷取的連線數。
acquireRetryAttempts
30
定義 ThingWorx 在放棄之前會試著從資料庫擷取新連線的次數。
acquireRetryDelay
1000
ThingWorx 在取得嘗試之間等待的時間 (以毫秒計)。
checkoutTimeout
1000000
呼叫 getConnection() 的用戶端在集區耗盡時，等候連線入庫或擷取的毫秒數。
idleConnectionTestPeriod
6
測試連線以使閒置連線不會從外部程序 (例如防火牆等) 關閉的時段 (以秒計)。如果這是一個大於 0 的數字，則 ThingWorx 會測試所有閒置、進入集區但未出庫的連線，每 x 秒鐘測試一次。
* 
如果您遇到「模型提供者沒有連線」錯誤，請審核此設定。比較防火牆預設值。降低預設值將緩解中斷問題。
initialPoolSize
10
啟動時集區中建立及維護的資料庫連線初始數目。應介於 minPoolSize 與 maxPoolSize 之間。
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
n/a
資料庫密碼。
username
twadmin
資料庫使用者名稱。
tableLockTimeout
10000
用戶端等待資料庫表格解除鎖定的毫秒數。
testConnectionOnCheckout
false
若為 true，會在每個連線出庫時執行作業來核對連線是否有效。
unreturnedConnectionTimeout
0
等待來自無反應連線 (在捨棄之前) 之回應的秒數。若已設定，在應用程式出庫但無法在指定時段內入庫連線時，集區將捨棄該連線。這可以讓偶爾發生連線洩露的應用程式存活，而不是最終耗盡連線集區。零表示沒有逾時，應用程式應關閉自己的連線。
StreamProcessorSettings
maximumBlockSize
2500
單一區塊中待處理的最大串流寫入數。
maximumQueueSize
250000
待排入佇列 (之後將被拒絕) 的最大串流項目數。
maximumWaitTime
10000
排清串流緩衝之前的最大等候時間 (以毫秒計)。
numberOfProcessingThreads
5
處理內容時要使用的執行緒數。
scanRate
5
檢查緩衝狀況的速率 (以毫秒計)。
sizeThreshold
1000
排清串流緩衝之前的累計最大項目數。
ValueStreamProcessorSettings
maximumBlockSize
2500
單一區塊中待處理的最大串流寫入數。
maximumQueueSize
250000
待排入佇列 (之後將被拒絕) 的最大串流項目數。
maximumWaitTime
10000
排清串流緩衝之前的最大等候時間 (以毫秒計)。
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
定義 ThingWorx 在放棄之前會試著從資料庫擷取新連線的次數。
acquireRetryDelay
10000
ThingWorx 在取得嘗試之間等待的時間 (以毫秒計)。
checkoutTimeout
10000000
呼叫 getConnection() 的用戶端在集區耗盡時，等候連線入庫或擷取的毫秒數。
driverClass
org.postgresql.Driver
預期提供連線的 JDBC driverClass 的完整類別名稱。
fetchSize
5000
要批量擷取的列計數，而不是快取用戶端的所有列。
idleConnectionTestPeriod
60
如果這是一個大於 0 的數字，則 ThingWorx 會測試所有閒置、進入集區但未出庫的連線，每 x 秒鐘測試一次。
initialPoolSize
5
啟動時集區中建立及維護的資料庫連線初始數目。應介於 minPoolSize 與 maxPoolSize 之間。
jdbcUrl
jdbc:postgresql://localhost:5432/thingworx
用來連接至 PostgreSQL 的 jdbc url。
* 
如果預設結構描述名稱會變更 (從公開)，您必須新增 <資料庫名稱>?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
單一區塊中待處理的最大串流寫入數。
maximumQueueSize
250000
待排入佇列 (之後將被拒絕) 的最大串流項目數。
maximumWaitTime
10000
系統在排清串流緩衝之前的等候時間數 (以毫秒計)
numberOfProcessingThreads
5
處理執行緒數
scanRate
5
系統會以指定速率值 (以毫秒計) 檢查緩衝區狀況。
sizeThreshold
1000
排清串流緩衝之前的累計最大項目數
值串流處理器設定
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
決定 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
啟動時集區中建立及維護的資料庫連線初始數目。應介於 minPoolSize 與 maxPoolSize 之間。
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 結構描述並用來在 JDBC 連線字串中對 MSSQL 進行驗證的使用者 id。
串流處理器設定
maximumBlockSize
2500
單一區塊中待處理的最大串流寫入數。
maximumQueueSize
250000
待排入佇列 (之後將被拒絕) 的最大串流項目數。
maximumWaitTime
10000
系統在排清串流緩衝之前的等候時間數 (以毫秒計)
numberOfProcessingThreads
5
處理執行緒數
scanRate
5
系統會以指定速率值 (以毫秒計) 檢查緩衝區狀況。
sizeThreshold
1000
排清串流緩衝之前的累計最大項目數
值串流處理器設定
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
排清內容緩衝之前的累計最大項目數。