ThingWorx 高可用性 > ThingWorx Foundation 檔案儲存
ThingWorx Foundation 檔案儲存
針對獨立 ThingWorx 安裝,通常有三個已建立的檔案位置:
/ThingworxPlatform
/ThingworxStorage
/ThingworxBackupStorage
依預設,系統會在 /ThingworxStorage 位置建立初始檔案存放庫。針對叢集部署,您必須進行變更並遵循某些規則。
/ThingworxPlatform
ThingworxPlatform 資料夾會針對每個伺服器實例保留在本機中且不應共用。資料夾包含會在啟動 ThingWorx 實例時讀取的下列所需檔案:
platform-settings.json
keystore-password
license_capability_response.bin (或此檔案名稱的變體)
下列內容必須在所有 ThingWorx HA 伺服器之間保持同步處理狀態:
platform-settings.json
keystore-password
建構或產生檔案後,每次在 ThingWorx 伺服器上對其進行修改時,相關內容均應在其 HA 組態內的所有其他 ThingWorx 伺服器上更新。
對於授權內容,每個 ThingWorx 伺服器必須維持其自身的授權檔案以及初始啟動時所建立的信任存放區。
可透過以下流程在每個 ThingWorx 伺服器的 /ThingworxPlatform 中建立這些檔案:
1. 在所有 ThingWorx 伺服器上建立 /ThingworxPlatform。HA 組態中所有 ThingWorx 伺服器上的資料夾結構都必須相同。
2. 建構 platform-settings.json 以適應系統環境,並將其儲存至初始 ThingWorx 伺服器的 /ThingworxPlatform (HA 組態中啟動的第一個 ThingWorx 伺服器)。
3. 啟動初始 ThingWorx 伺服器,並確保其全面運作且可以使用所有預期的授權功能。此時,/ThingworxPlatform 內應有三個檔案:
platform-settings.json
keystore-password
successful_license_capability_response.bin
4. 關閉初始 ThingWorx 伺服器。
5. 將三個檔案從初始伺服器複製到另一個或其他伺服器的 /ThingworxPlatform 資料夾。
* 
platform-settings.json 檔案中,您必須將 PlatformId 設定更新為每個伺服器的唯一 ID。如需詳細資訊,請參閱 ThingWorx HA 的平台設定
6. 在其他伺服器中,將授權檔案從 successful_license_capability_response.bin 重新命名為 license_capability_response.bin
7. 啟動、測試和停止其他 ThingWorx 伺服器,每次一個,以確保所有授權功能均處於可用狀態。
ThingworxPlatform 資料夾的預設位置為 /ThingworxPlatform。可以透過環境變數 THINGWORX_PLATFORM_SETTINGS 設定非預設位置。此變數必須在帶有 ThingWorx 的 Tomcat 啟動之前,於 Tomcat 作業系統使用者環境中建立。請確保 THINGWORX_PLATFORM_SETTINGS 所參考的資料夾存在且 Tomcat 作業系統使用者擁有對其的讀取/寫入權限。
/ThingworxStorage
/ThingworxStorage 資料夾必須位於共用的檔案系統磁碟區中,其中所有 ThingWorx 伺服器對其具有同等的讀取/寫入權限。
keystore.pfx 檔案儲存在此資料夾中,且包含平台所需的密碼。該檔案會連結至 keystore-password 檔案。您應該將這兩個檔案保持在安全且備份的狀態。如果任何一個檔案遺失,則無法解密儲存在資料庫中的資訊。
記錄檔將包含所有伺服器中的所有記錄,並將由記錄項目中的 platformId 加以識別。
/ThingworxStorage 的位置於 platform-settings.jsonBasicSettings 部份中進行管理。
僅就 Windows 而言,當 ThingWorx 平台主機與共用儲存目錄所在的主機不在同一網域中時,請完成下列步驟:
* 
僅當使用本機使用者帳戶執行 Apache Tomcat 時,才需完成下列步驟。
1. 建立存在於 ThingWorx Platform 主機和共享目錄所在主機上的「本機使用者帳戶」
* 
此使用者帳戶在兩個主機上必須具有相同的密碼。
2. 配置 Apache Tomcat,以將其作為步驟 1 中的「本機使用者帳戶」執行。
a. 「服務」中,找到 Apache Tomcat 服務,然後選取「內容」 > 「登入」
b. 輸入本機使用者帳戶及使用者密碼。
3. 為本機使用者帳戶授與對於 Apache Tomcat 資料夾下 tomcat9.exe 檔案的「完全控制」權限,以避免出現平台儲存初始化失敗錯誤。
4. 「本機使用者帳戶」共用網路位置,並授與「完全控制」權限。
a. 在網路位置上按一下滑鼠右鍵,然後選取「內容」。按一下「共用」標籤。
b. 找出「本機使用者帳戶」,然後選取「讀取/寫入」
c. 在安全性標籤中,確保已為本機使用者帳戶授與「完全控制」權限。
5. platform-settings.json 中的 BasicSettings 下設定 Storage 金鑰的值,以使用網路位置的完整 UNC 路徑。在路徑中包括每個 \ 的附加反斜線。例如:
網路共用位置:\\ShareHost\MyThingworxShare
platform-settings.json: \\\\ShareHost\\MyThingworxShare 中的 Storage
6. 重新啟動 Apache Tomcat。
/ThingworxBackupStorage
/ThingworxBackupStorage 的主要用途為備份 H2 資料庫。由於 ThingWorx HA 組態不支援 H2,因此不會使用此位置。但其在執行時間仍可能存在。
於每個 ThingWorx 伺服器上均建立此位置足以避免任何登入錯誤。
platform-settings.json 檔案中的 "EnableBackup": false 進行設定以避免於 HA 環境中進行不必要的處理。
/ThingworxBackupStorage 的位置於 platform-settings.json 中進行管理。所有 ThingWorx 伺服器上的資料夾結構都必須相同。
根檔案存放庫
根檔案存放庫必須位於共用的檔案系統磁碟區上,其中所有 ThingWorx 伺服器對其具有同等的讀取/寫入權限。
必須將根檔案存放庫資料夾的位置新增至系統的 platform-settings.json。應將參數 FileRepositoryRoot 與共用檔案位置新增至 BasicSettings 區段。相關值應列出要在其中建立存放庫的資料夾位置。例如,若要在 /ThingworxFileRepository/repository 建立初始存放庫資料夾,則 platform-settings.json 的新增內容應為 "FileRepositoryRoot":"/ThingworxFileRepository"
* 
如果未在 platform-settings.json 檔案中指定 FileRepositoryRoot 參數,則將使用預設的存放庫位置 /ThingworxStorage
若有任何原因造成在 FileRepositoryRoot 中定義的位置無法使用,ThingWorx 將會於啟動時中止。
檔案共用考量:
提供網路連接儲存裝置 (NAS) 或雲端服務的對等服務是提供共用檔案系統的常見解決方案。
所提供的 NAS 應有其自身的高可用性解決方案才能支援此 ThingWorx HA 實行。
必須在 ThingWorx 實例開始之前將磁碟區裝載至伺服器。
每個在 ThingWorx 伺服器上執行 Tomcat 服務的作業系統使用者都必須擁有其中建立了存放庫之檔案共用位置的讀取/寫入權限。
每個 ThingWorx 伺服器上的裝載位置都必須相同。
這是否有幫助?