安裝與組態 > ThingWorx 組態資源
ThingWorx 組態資源
修改 ThingWorxStorage 資料夾的位置
ThingWorx 利用兩個頂層目錄資料夾來進行儲存:ThingworxStorage 儲存所有使用中資訊 (資料、記錄檔、延伸功能等等),而 ThingworxBackupStorage 則儲存所有備份資訊。ThingWorx 依預設會在根目錄中建立這些資料夾。
Microsoft Windows 上的根目錄是 <drive>:\\,其中 <drive> 是 Tomcat 安裝所在的磁碟機
非 Microsoft Windows 系統上的根目錄是 /
啟動 Tomcat 之前,自訂 ThingworxStorage 資料夾的位置。如果您變更位置且未停止 Tomcat,請在變更 ThingworxStorage 的位置之後重新啟動 Tomcat。
.
為 ThingWorxStorage 指定自訂位置
欲修改 ThingWorxStorage 在檔案系統中的位置,請指向用來指定儲存位置之 JSON 組態檔案的位置。您可以透過以下兩種方式其中之一來執行此操作:
1. 建立一個名為 ThingworxPlatform 的根目錄。
在 Microsoft Windows 上會是 <drive>:\\ThingworxPlatform,其中 <drive> 是 Tomcat 安裝所在的磁碟機
在非 Microsoft Windows 上會是:/ThingworxPlatform
-或-
2. 將一個環境變數定義為系統變數 (不以使用者身分)。環境變數應該只有路徑。請勿包括 platform-settings.json
%THINGWORX_PLATFORM_SETTINGS% (Microsoft Windows)
$THINGWORX_PLATFORM_SETTINGS (非 Microsoft Windows),其指向 JSON 組態檔案的位置
* 
Ubuntu 建議在 /etc/environment 中定義系統範圍的環境變數。在此檔案中,您必須定義並匯出 THINGWORX_PLATFORM_SETTINGS 變數。例如,export THINGWORX_PLATFORM_SETTINGS=/usr/share/tomcatx/x.x.xx/conf,其中 x 是您使用的 Tomcat 版本。
3. 僅針對 RHEL 定義 Tomcat 服務可以存取的 THINGWORX_PLATFORM_SETTINGS 變數,例如 tomcat.service 檔案或啟動指令集。
* 
系統服務不會從呼叫使用者及其工作階段中繼承任何前後關聯 (例如 HOME 與 PATH 環境變數)。每個服務都在乾淨的執行前後關聯中執行。
格式範例
定義 JSON 組態檔案的位置後,請在上面指定的位置建立 platform-settings.json 檔案。請使用下列範例中的格式來修改 ThingworxStorageThingworxBackupStorage 資料夾的位置。在此範例中,所有項目均包含在名為 /ThingworxStorage 的根目錄底下。
此檔案中的每項設定都是選用的。若未在此檔案裡指定某項設定,ThingWorx 在執行時間會預設為採用硬式編碼的值。
設定
描述
預設
核心平台設定
BackupStorage
建立/放置備份儲存目錄所在的目錄。
/ThingworxBackupStorage
DatabaseLogRetentionPolicy
資料庫記錄檔的保留天數。除非經 ThingWorx 支援人員指示,否則請勿修改這項設定。
7
EnableBackup
控制是否啟用備份。
True
EnableHA
控制是否要針對高可用性 (HA) 環境來配置平台。
False
EnableSystemLogging
控制是否啟用系統記錄。
* 
只有 ThingWorx 支援指示時才使用。
False
HTTPRequestHeaderMaxLength
HTTP 請求標題值的最大允許長度。
2000
HTTPRequestParameterMaxLength
HTTP 請求參數值的最大允許長度。
2000
Storage
建立/放置所有儲存目錄 (備份儲存除外) 所在的目錄。
/ThingworxStorage
HA 設定
專屬高可用性 (HA) 環境組態的設定。選用,並會在 EnableHA 設定 (如上所述) 設為 false 時略過
CoordinatorConnectionTimeout
等待與用來協調平台優先順序的流程/伺服器建立連線的時間長度 (毫秒)
15000
CoordinatorHosts
此逗號分隔清單會列出用來協調平台主導權的流程所在的伺服器 IP 位址 (例如,"127.0.0.1:2181, 127.0.0.2:2181")。
127.0.0.1:2181
CoordinatorMaxRetries
與用來協調平台主導權的流程/伺服器建立連線的最大允許重試次數。
3
CoordinatorRetryTimeout
為每個重試嘗試等待的時間長度 (毫秒)。
1000
CoordinatorSessionTimeout
收到來自用來協調平台主導權的流程/伺服器的活動訊號前,平台的工作階段所要等待的時間長度 (毫秒)
60000
LoadBalancerBase64EncodedCredentials
HA 負載平衡器的 Base64 編碼認證,格式為 "<user>:<password>"。
PersistenceProviderPackageConfigs
取決於您的資料庫選項。
如需所有可能的組態,請參閱 持續性提供者
適用於非 Windows 的指令集範例
將下列內容複製到有效的 JSON 檔案時,請避免貼上任何不必要的格式化字元。

{
"PlatformSettingsConfig": {
"BasicSettings": {
"BackupStorage": "/home/johndoe/Developer/thingworx/platform/backup",
"DatabaseLogRetentionPolicy": 7,
"EnableBackup": true,
"EnableHA": false,
"EnableSystemLogging": false,
"HTTPRequestHeaderMaxLength": 2000,
"HTTPRequestParameterMaxLength": 2000,
"Storage": "/home/johndoe/Developer/thingworx/platform/storage"
},
"HASettings": {
"CoordinatorConnectionTimeout": 15000,
"CoordinatorHosts": "127.0.0.1:2181",
"CoordinatorMaxRetries": 3,
"CoordinatorRetryTimeout": 1000,
"CoordinatorSessionTimeout": 60000,
"LoadBalancerBase64EncodedCredentials": "QWRtbW4pc1RyYXRvajphZG1pbg=="
}
}
}
適用於 Windows 的指令集範例
{
"PlatformSettingsConfig": {
"BasicSettings": {
"BackupStorage": "C:\\Users\\John Doe\\Developer\\thingworx\\platform\\backup",
"DatabaseLogRetentionPolicy": 7,
"EnableBackup": true,
"EnableHA": false,
"EnableSystemLogging": false,
"HTTPRequestHeaderMaxLength": 2000,
"HTTPRequestParameterMaxLength": 2000,
"Storage": "C:\\Users\\John Doe\\Developer\\thingworx\\platform\\storage"
},

"HASettings": {
"CoordinatorConnectionTimeout": 15000,
"CoordinatorHosts": "127.0.0.1:2181",
"CoordinatorMaxRetries": 3,
"CoordinatorRetryTimeout": 1000,
"CoordinatorSessionTimeout": 60000,
"LoadBalancerBase64EncodedCredentials": "QWRtbW4pc1RyYXRvajphZG1pbg=="
}
}
}