適用於 Windows 的 ThingWorx Foundation 安裝程式
A.) 含 Azure PostgreSQL 彈性伺服器之 Windows 安裝程式的先決條件
| 不建議在 ThingWorx 安裝程式的檔案名稱中使用空格。如果您嘗試使用含空白字元的檔案路徑來安裝 ThingWorx,ThingWorx 安裝程式會遇到問題。如果您必須使用空格,管理員應啟用 Windows 的 8dot3 支援。 |
• 欲執行含 Azure PostgreSQL 彈性伺服器之適用於 Windows 的 ThingWorx Foundation 安裝程式,您必須符合下列條件。如需有關支援版本的詳細資訊,請參閱
系統需求。
◦ Java 11 已安裝
| 9.3.0 及更新版本需要 Java 11。 • 將 Java_Home 變數設定為使用 Java 11 安裝目錄。 |
◦ 擁有 Windows 管理員存取權限。
◦ 已使用允許的連線配置 ThingWorx 資料庫。
◦ 將資料庫使用者配置為符合以下條件之 ThingWorx 資料庫的擁有者:
▪ 已授與此使用者對 ThingWorx 資料庫的所有權限。
▪ 將 can login 內容設定為 yes。
在安裝程式中,將會輸入此資料庫使用者作為 ThingWorx 資料庫使用者名稱。
下表列出適用的先決條件:
資料庫連線 | 先決條件 |
---|
遠端 | • 安裝與 PostgreSQL 版本相容的 psql 用戶端。 • 依照下列步驟將已安裝的 psql 新增至 PATH 環境變數: b. 安裝 pgadmin 用戶端。 c. 更新 PATH 環境變數,以附加至 pgadmin 用戶端安裝位置的路徑。 |
B.) 含 PostgreSQL 之 Windows 安裝程式的先決條件
| 不建議在 ThingWorx 安裝程式的檔案名稱中使用空格。如果您嘗試使用含空白字元的檔案路徑來安裝 ThingWorx,ThingWorx 安裝程式會遇到問題。如果您必須使用空格,管理員應啟用 Windows 的 8dot3 支援。 |
• 欲在使用 PostgreSQL 的環境中執行適用於 Windows 的 ThingWorx Foundation 安裝程式,您必須符合下列條件。如需有關支援版本的資訊,請參閱
系統需求。
◦ Java 11 已安裝
◦ 擁有 Windows 管理員存取權限
◦ 將 ThingWorx 資料庫配置為允許連線並將編碼設定為 UTF-8
▪ 資料庫內容 Connection_LIMIT 必須設定為 -1 (這是預設值),並允許所有授權使用者無限連線至資料庫。
◦ 將資料庫使用者配置為符合以下條件之 ThingWorx 資料庫的擁有者:
▪ 已授與此使用者對 ThingWorx 資料庫的所有權限。
▪ can login 內容設定為 yes。
在安裝程式中,將會輸入此資料庫使用者作為 ThingWorx 資料庫使用者名稱。
◦ 擁有本機或遠端資料庫連線。下表列出適用的先決條件:
資料庫連線 | 先決條件 |
---|
本機 | • 已安裝 PostgreSQL,且 PostgreSQL/bin 的路徑應該在 PATH 環境變數中。 • 已安裝 Java JDK 請確保 java/bin 位於 PATH 環境變數中。 • 允許透過更新 pg_hba.conf 檔案從 ThingWorx Foundation 主機連線至 PostgreSQL。 例如,如果 ThingWorx Foundation 安裝在與 PostgreSQL 相同的主機上,您可以更新 pg_hba.conf 檔案,以將密碼驗證方法設定為 md5、 password 或 trust。但是,我們不建議您將其設定為 trust。如需有關 pg_hba.conf 檔案與密碼驗證方法的詳細資訊,請參閱 PostgreSQL.org 網站。 以下是密碼驗證設定為 md5 之 pg_hba.conf 檔案的範例: $ Edit pg_hba.conf for following: ... # "local" is for Unix domain socket connections only local all all md5 # IPv4 local connections: host all all 127.0.0.1/32 md5 # IPv6 local connections: host all all ::1/128 md5 |
遠端 | • 安裝與 PostgreSQL 版本相容的 psql 用戶端。 • 將已安裝的 psql 新增至 PATH 環境變數。您可以依照下列步驟執行: b. 安裝 pgadmin 用戶端。 c. 更新 PATH 環境變數,以附加至 pgadmin 用戶端安裝位置的路徑。 |
C.) 含 SQL Server 之 Windows 安裝程式的先決條件
| 不建議在 ThingWorx 安裝程式的檔案名稱中使用空格。如果您嘗試使用含空白字元的檔案路徑來安裝 ThingWorx,ThingWorx 安裝程式會遇到問題。如果您必須使用空格,管理員應啟用 Windows 的 8dot3 支援。 |
欲執行含 Microsoft SQL Server 之適用於 Windows 的 ThingWorx Foundation 安裝程式,您必須符合下列條件。如需有關支援版本的資訊,請參閱
系統需求。
• Java 11 已安裝
| 9.3.0 及更新版本需要 Java 11。 • 將 JAVA_HOME 變數設定為使用 Java 11 安裝目錄。 |
• 擁有 Windows 管理員存取權限
• 將 ThingWorx 資料庫設定配置為如下:
◦ 將 Collate 內容設定為 Latin1_General_100_CS_AS_SC。
◦ 將下列內容設定為 ON:
▪ READ_COMMITTED_SNAPSHOT
▪ ALLOW_SNAPSHOT_ISOLATION
• 使用 SQL Server 驗證登入 Microsoft SQL Server
此登入的密碼是 ThingWorx 資料庫登入密碼。
◦ 此登入的資料庫使用者配置為擁有者,且角色為公開。
此使用者應擁有 dbo 的預設架構、db_owner 的擁有架構,並為 db_owner 的成員。
• 擁有本機或遠端資料庫連線。下表列出適用的先決條件:
資料庫連線 | 先決條件 |
---|
本機 | • 要安裝 ThingWorx Foundation 的主機擁有對 Microsoft SQL Server 的存取權。 • 有效的 Microsoft SQL 用戶端 (sqlcmd) 已安裝且在 PATH 環境變數中可用。 • 已安裝 Java JDK。 java/bin 位於 PATH 環境變數中。 |
遠端 | • 已安裝 sqlcmd,且其可在 PATH 環境變數中使用。 |
D.) 在安裝程式中啟用 SSL/TLS 的先決條件:建立 Keystore
| 將 -Xms 和 -Xmx 的值設定為可用 OS 記憶體的 75% (例如,16GB RAM 的系統為 12GB)。 Xms 與 Xmx 值應以 MB 為單位。如需詳細資訊,請參閱 JVM 調整。 |
在安裝程式的「ThingWorx Foundation 內容」畫面中,「使用 SSL/TLS 進行安全連線」核取方塊預設為已選取。您可以清除此核取方塊來在安裝程式中禁用 SSL/TLS。如果您選擇保留預設設定並使用 SSL/TLS,必須在執行安裝程式之前產生 Java keystore (jks) 檔案。Java keystore (jks) 檔案必須具有下列安全性權限:
• Keystore 檔案必須將 Read 與 Read & Execute 權限授與 Windows 中的 Network Service 使用者設定檔。
有多種方法可用來產生 keystore;其中一種方法如下:
1. 轉至 Java/bin。
2. 執行下列指令來建立 Tomcat Keystore 檔案 (.jks 檔案):keytool -genkey -alias selfsigned -keyalg RSA -keystore keyStore.jks -keysize 2048 -storetype jks
3. 輸入 keystore 的密碼。稍後,您將需要使用此密碼來配置伺服器。
| 密碼不得包含或括在單引號 (')、雙引號 ('') 或節號 (§) 內。 |
4. 出現提示時,輸入伺服器的網域名稱。例如,myserver.mycompany.com。
5. 輸入其他值,例如組織單位與組織。
6. 出現提示時,輸入 keystore 密碼。
E.) 在 Windows 上安裝 ThingWorx Foundation
1. 請確保能夠滿足上述各部份所述的先決條件。
2. 針對 PostgreSQL 或
Azure PostgreSQL 彈性伺服器,從
support.ptc.com 的 > > > > > 下,下載
ThingWorx-Platform-Foundation-Installer-x-x-x-Windows-postgres。
或者
針對 Microsoft SQL Server,從
support.ptc.com 的 > > > > > 下,下載
ThingWorx-Platform-Foundation-Installer-x-x-x-Windows-mssql。
3. 擷取對應版次。
4. 針對 PostgreSQL 或 Azure PostgreSQL 彈性伺服器,執行 ThingWorxFoundationPostgres-9.x.x-x64.exe。
或者
針對 Microsoft SQL Server,執行 ThingWorxFoundationMSSQL-9.x.x-x64.exe。
5. 逐步完成安裝程式畫面。
| 在 「ThingWorx Foundation 內容」畫面中, 「使用 SSL/TLS 進行安全連線」核取方塊預設為已選取。您可以清除此核取方塊來在安裝程式中禁用 SSL/TLS。如果您選擇使用 SSL/TLS,請輸入在 上述先決條件中產生的 keystore 值。 |
6. 在最後一個安裝程式畫面中,Open License Configurator 核取方塊預設為選取。如果選取此核取方塊,則在安裝程式完成並關閉後,License Configurator 會開啟。如果您取消選取 Open License Configurator 核取方塊,安裝程式會關閉,且 License Configurator 不會自動開啟。
a. 在 Setup : Configure licensing for ThingworxFoundation for Postgres 或 Setup : Configure licensing for ThingworxFoundation for Mssql 螢幕中按一下「下一步」。
b. 使用授權組態管理員連線至 PTC 授權伺服器或配置 ThingWorx Foundation 以使用預先下載的授權。
c. 逐步完成授權畫面。
7. ThingWorx Foundation 安裝完成。
F.) 連接至 ThingWorx Foundation 伺服器
1. 存取 ThingWorx Foundation URL。
例如:https://<主機名稱>:<埠>/Thingworx/Composer。
根據 SSL/非 SSL 的組態及安裝期間使用的連接埠,ThingWorx Foundation URL 將有所不同。SSL 預設為啟用;但您可以禁用 SSL/TLS。請參閱上述在安裝程式中啟用 SSL/TLS 的先決條件 部份。
2. 提供使用者認證。
使用者名稱是 Administrator,密碼是在安裝期間輸入的內容。
G.) 其他安裝程式功能與疑難排解
在 Windows 上啟動/停止 ThingWorx Foundation 服務
1. 導覽至 Services.msc。
2. 找到 ThingWorx-Foundation 服務。
3. 將其開始或停止。
尋找安裝程式記錄檔
• 安裝記錄檔:
◦ ${installdir}\installer\logs\ThingWorxFoundation_install.log
例如:C:\Program Files (x86)\ThingWorxFoundation\installer\logs\ThingWorxFoundation_install.log。
• 執行記錄檔:
◦ ${installdir}\ThingworxStorage\logs\
例如:C:\Program Files (x86)\ThingWorxFoundation\ThingworxStorage\logs\。
• 針對中止或失敗:
◦ ${system_temp_directory}\ThingWorxFoundation_Failed_installs\
例如:C:\Users\vagrant\AppData\Local\Temp\ThingWorxFoundation_Failed_installs\。
• 解除安裝記錄檔:
◦ ${system_temp_directory}\bitrock_installer_(pid).log
記錄檔名稱都有 bitrock 前綴。例如:C:\Users\vagrant\AppData\Local\Temp\bitrock_installer_3008.log。
解除安裝基於 ThingWorx Foundation 安裝程式的安裝
1. 導覽至 ThingWorx Foundation 安裝位置。
2. 執行 ThingWorxFoundation_uninstall.exe。
3. 系統提示時,請按一下「確定」以確認要繼續解除安裝。
4. 解除安裝完成後,會刪除安裝。
從 PostgreSQL 刪除 ThingWorx 資料庫
1. 從 Windows 的指令行中,開啟 PostgreSQL 資料庫的連線。
例如,輸入 psql -U admin -h dbhost。
2. 如果您使用預設資料庫名稱,請執行 DROP DATABASE thingworx; 指令。
或者,如果您已自訂資料庫名稱,請執行 DROP DATABASE <your database name>; 指令。
從 Microsoft SQL 刪除 ThingWorx 資料庫
1. 從 Windows 的指令行中,開啟 Microsoft SQL 資料庫的連線。
例如,輸入 sqlcmd -U admin -s ‘dbhost\dbservicename,port’。
2. 如果您使用預設資料庫名稱,請執行 DROP DATABASE thingworx; GO; 指令。
或者,如果您已自訂資料庫名稱,請執行 DROP DATABASE <your database name>; GO; 指令。
如果您在 Windows 中進行服務組態變更時遇到問題,並想要查看更多資訊,請執行下列操作來將更多詳細資訊記錄到 /tomat/current/logs/ directory 下的 commons-daemon.log 檔案中:tomcat9w.exe //ES//ThingWorx-Foundation --LogLevel Debug。