| 不建議在 ThingWorx 安裝程式的檔案名稱中使用空格。如果您嘗試使用含空白字元的檔案路徑來安裝 ThingWorx,ThingWorx 安裝程式會遇到問題。如果您必須使用空格,管理員應啟用 Windows 的 8dot3 支援。 |
• 欲在使用 PostgreSQL 的環境中執行適用於 Windows 的 ThingWorx Foundation 安裝程式,您必須符合下列條件。如需有關支援版本的資訊,請參閱
系統需求。
◦ Java 11 已安裝
| 9.2.0 及更新版本需要 Java 11。 • 將 JAVA_HOME 變數設定為使用 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 用戶端安裝位置的路徑。 |
| 不建議在 ThingWorx 安裝程式的檔案名稱中使用空格。如果您嘗試使用含空白字元的檔案路徑來安裝 ThingWorx,ThingWorx 安裝程式會遇到問題。如果您必須使用空格,管理員應啟用 Windows 的 8dot3 支援。 |
欲執行含 Microsoft SQL Server 之適用於 Windows 的 ThingWorx Foundation 安裝程式,您必須符合下列條件。如需有關支援版本的資訊,請參閱
系統需求。
• Java 11 已安裝
| 9.2.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 環境變數中使用。 |
在安裝程式的「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 密碼。
1. 請確保能夠滿足上述各部份所述的先決條件。
2. 針對 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,執行 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 安裝完成。
1. 存取 ThingWorx Foundation URL。
例如:https://<主機名稱>:<埠>/Thingworx/Composer。
根據 SSL/非 SSL 的組態及安裝期間使用的連接埠,ThingWorx Foundation URL 將有所不同。SSL 預設為啟用;但您可以禁用 SSL/TLS。請參閱上述在安裝程式中啟用 SSL/TLS 的先決條件 部份。
2. 提供使用者認證。
使用者名稱是 Administrator,密碼是在安裝期間輸入的內容。
在 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; 指令。
針對 ThingWorx 9.0 與 9.1 升級至 Java 11
如果您使用安裝程式來安裝或升級含 Java 8 的 ThingWorx 9.0.x 或 9.1.x,並且想要使用 Java 11.0.8,請遵循下列步驟:
1. 安裝 Java 11。
2. 在路徑系統變數中設定 /bin 目錄。
3. 將 JAVA_HOME 變數設定為使用 Java 11 安裝目錄。
4. 核對 jvm.dll 檔案的位置位於 Java 11 安裝目錄下。例如:C:\Program Files\Java\jdk-11.0.8\bin\server\jvm.dll。
| Java 11 沒有 JRE 目錄。因此,jvm.dll 檔案將不像在 Java 8 中一樣位於 JRE 資料夾下。 |
5. 停止 ThingWorx-Foundation 服務。
6. 以管理員身分執行 CMD。
7. 導覽至 ThingWorx Foundation 安裝目錄下的 Tomcat /bin 目錄。例如:cd C:\Program Files (x86)\ThingWorxFoundation\tomcat\apache-tomcat-9.0.37\bin。
8. 欲編輯 ThingWorx-Foundation 服務組態,請執行 tomcat9w.exe //ES//ThingWorx-Foundation。
GUI 應用程式即會開啟。
9. 導覽至應用程式中的 Java 標籤,並執行下列操作:
a. 針對 Java 虛擬機器,指向 Java 11 安裝的 jvm.dll。例如:C:\Program Files\Java\jdk-11.0.8\bin\server\jvm.dll。
b. 從 Java Options 中移除下列項目:
-XX:+UseG1GC
-XX:+PrintGCTimeStamps
-XX:+PrintGCDetails
-Xloggc:${CATALINA_HOME}/logs/tomcat-twx-gc.log
${CATALINA_HOME} 參照 Tomcat 目錄。
c. 複製 ThingWorx Foundation 的安裝目錄路徑。例如:C:\Program Files (x86)\ThingWorxFoundation。
d. 將下列項目新增至 Java Options:
-Xlog:gc:file=C:\Program Files
(x86)\ThingWorxFoundation/tomcat/current/logs/gc.log:time,level,tags
10. 選擇 Apply。
11. 選擇「確定」。
應用程式即會關閉。
12. 執行下列操作以使用 tomcat9 更新服務參數:
a. 以管理員身分執行 CMD。
b. 執行下列項目:
tomcat9.exe //US//ThingWorx-Foundation --JavaHome=%JAVA_HOME%
tomcat9.exe //US//ThingWorx-Foundation --Environment="JRE_HOME='%JAVA_HOME%';THINGWORX_PLATFORM_SETTINGS='%THINGWORX_PLATFORM_SETTINGS%';PATH='%PATH%'"
13. 啟動 ThingWorx-Foundation 服務。
14. 在 Application.log 檔案中,確認 Java 版本為 11:
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] ========================================
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] ========================================
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] ThingWorx System Environment Settings
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] ========================================
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] OS: Windows Server 2019
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] OS arch: amd64
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] OS version: 10.0
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] Total Processors: 2
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] Default encoding: UTF-8
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] JAVA vendor: Oracle Corporation
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] JAVA version: 11.0.8
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] JAVA install location: C:\Program Files\Java\jdk-11.0.8
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] JVM Max Memory: 750 (MB)
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] ========================================
如果您在 Windows 中進行服務組態變更時遇到問題,並想要查看更多資訊,請執行下列操作來將更多詳細資訊記錄到 /tomat/current/logs/ directory 下的 commons-daemon.log 檔案中:tomcat9w.exe //ES//ThingWorx-Foundation --LogLevel Debug。