ThingWorx Foundation 安裝程式
適用於內部部署安裝的最新 ThingWorx Foundation 安裝程式檔案發佈在 support.ptc.com 的 > > > > 與 下。
此安裝程式會執行下列操作:
• 安裝 ThingWorx Foundation
• 安裝 Tomcat
• 協助您配置 ThingWorx Foundation 授權
ThingWorx Foundation 安裝程式支援下列作業系統與這些資料庫組合:
• 含 PostgreSQL 的 Windows
• 含 Microsoft SQL Server 的 Windows
• 安裝了 PostgreSQL 的 Red Hat Enterprise Linux
• 安裝了 Microsoft SQL Server 的 Red Hat Enterprise Linux
硬體大小
以下是最低需求;實際大小取決於應用程式以及使用情境。
項目
|
Value
|
附註:
|
記憶體
|
16 GB RAM (最低)
|
必須為 Java VM 分配專用記憶體。
|
CPU
|
4
|
虛擬化環境可能擁有自己的術語,用來指定提供的 CPU 與核心數。確定環境是否符合最低需求時,必須考慮這一點。
|
磁碟空間
|
100 GB 的可用磁碟空間
|
此大小可容納預設應用程式與一些初始組態資料。
|
• 這不包括 OS 或其他必要軟體所需的空間。
• 任何所提供應用程式需要的總磁碟空間都取決於將保留的組態與執行時間資料量。客戶應使用銷售與現場支援,根據其應用程式需求預估空間需求。
|
|
磁碟速度
|
10K RPM 或更快
|
如果您要將資料儲存在 ThingWorx Platform,速度是很重要的。
|
根據您的作業系統與資料庫,您必須確保在執行 ThingWorx Foundation 安裝程式之前進行下列操作:
含 PostgreSQL 的 Windows 的先決條件
您必須:
• 擁有 Windows 管理員存取權限
• 將 ThingWorx 資料庫配置為允許連線並將編碼設定為 UTF-8
資料庫內容 Connection_LIMIT 必須設定為 -1 (這是預設值),並允許所有授權使用者無限連線至資料庫。
• 將資料庫使用者配置為符合以下條件之 ThingWorx 資料庫的擁有者:
◦ 已授與此使用者對 ThingWorx 資料庫的所有權限。
◦ can login 內容設定為 yes。
在安裝程式中,將會輸入此資料庫使用者作為 ThingWorx 資料庫使用者名稱。
• 欲使用本機資料庫連線,您必須具備下列條件:
◦ 已安裝 PostgreSQL,且路徑 PostgreSQL/bin 應該在 PATH 環境變數中可用。
◦ 已安裝 Java JDK 1.8.0_141 或以上版本
請確保 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 環境變數。您可以依照下列步驟執行:
2. 安裝 pgadmin 用戶端。
3. 更新 PATH 環境變數,以附加至 pgadmin 用戶端安裝位置的路徑。
含 Microsoft SQL Server 的 Windows 的先決條件
您必須:
• 擁有 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 1.8.0_141 或以上版本
請確保 java/bin 位於 PATH 環境變數中。
• 如果想要使用遠端資料庫連接,請安裝 sqlcmd 並使其在 PATH 環境變數中可用。
含 PostgreSQL 的 Red Hat Enterprise Linux 的先決條件
您必須:
• 擁有 Red Hat Enterprise Linux (RHEL) 管理員存取權限
RHEL 8.2 具備增強的安全性強化功能。使用安裝程式在 RHEL 8.2 上安裝 ThingWorx Foundation 應安裝在 /opt 目錄中,以免發生權限問題。您可選擇在 /opt 目錄下您選擇的目錄中安裝。
• 已安裝 Java JDK 1.8.0_141 或以上版本
將 java/bin 附加至 PATH 環境變數中。
• 擁有 PostgreSQL 資料庫
欲使用本機資料庫連線:
• 要安裝 ThingWorx Foundation 的主機必須擁有對 PostgreSQL 伺服器的存取權。
• 您必須已安裝 PostgreSQL,且路徑 PostgreSQL/bin 應該在 PATH 環境變數中可用。
• 將 ThingWorx 資料庫配置為允許連線並將編碼設定為 UTF-8
資料庫內容 Connection_LIMIT 必須設定為 -1 (這是預設值),並允許所有授權使用者無限連線至資料庫。
• 將資料庫使用者配置為符合以下條件之 ThingWorx 資料庫的擁有者:
◦ 已授與此使用者對 ThingWorx 資料庫的所有權限。
◦ can login 內容設定為 yes。
在安裝程式中,將會輸入此資料庫使用者作為 ThingWorx 資料庫使用者名稱。
• 您允許透過更新 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 9.6 或 10.8 版本相容的 psql 用戶端。可以執行下列指令來安裝 psql 用戶端:
yum install rh-postgresql96-postgresql-syspaths
含 Microsoft SQL Server 的 Red Hat Enterprise Linux 的先決條件
您必須:
• 擁有 Red Hat Enterprise Linux (RHEL) 管理員存取權限
RHEL 8.2 具備增強的安全性強化功能。使用安裝程式在 RHEL 8.2 上安裝 ThingWorx Foundation 應安裝在 /opt 目錄中,以免發生權限問題。您可選擇在 /opt 目錄下您選擇的目錄中安裝。
• 已安裝 Java JDK 1.8.0_141 或以上版本
將 java/bin 附加至 PATH 環境變數中。
• 擁有 Microsoft SQL Server 資料庫。
• 將 ThingWorx 資料庫設定配置為如下:
◦ 將 Collate 內容設定為 Latin1_General_100_CS_AS_SC。
◦ 將下列內容設定為 ON:
▪ READ_COMMITTED_SNAPSHOT
▪ ALLOW_SNAPSHOT_ISOLATION
• 使用 SQL Server 驗證登入 Microsoft SQL Server
此登入的密碼是 ThingWorx 資料庫登入密碼。
◦ 此登入的資料庫使用者配置為擁有者,且角色為公開。
• 要安裝 ThingWorx Foundation 的主機必須擁有對 Microsoft SQL Server 的存取權。
• 有效的 Microsoft SQL 用戶端 (sqlcmd) 已安裝且在 PATH 環境變數中可用。
• 擁有管理員權限的 Microsoft SQL 使用者
• 安裝 sqlcmd。
安裝之後,執行下列操作:
ln -s /opt/mssql-tools/bin/sqlcmd /usr/bin/sqlcmd
在安裝程式中啟用 SSL/TLS 的先決條件
在安裝程式的「ThingWorx Foundation 內容」畫面中,「使用 SSL/TLS 進行安全連線」核取方塊預設為已選取。您可以清除此核取方塊來在安裝程式中禁用 SSL/TLS。如果您選擇保留預設設定並使用 SSL/TLS,必須在執行安裝程式之前產生 Java keystore (jks) 檔案。
有多種方法可用來產生 keystore;其中一種方法如下:
1. 轉至 Java/bin。
2. 執行下列指令來建立 Tomcat Keystore 檔案 (.jks 檔案):keytool -genkey -alias selfsigned -keyalg RSA -keystore keyStore.jks -keysize 2048。
3. 輸入 keystore 的密碼。稍後,您將需要使用此密碼來配置伺服器。
4. 出現提示時,輸入伺服器的網域名稱。例如,myserver.mycompany.com。
5. 輸入其他值,例如組織單位與組織。
6. 出現提示時,輸入 keystore 密碼。
在 Windows 上安裝 ThingWorx Foundation
1. 請確保能夠滿足上述各部份所述的先決條件。
2. 以管理員身份登入 ThingWorx 主機。
3. 針對 PostgreSQL,從 support.ptc.com 的 > > > > > 下,下載 ThingWorx-Platform-Foundation-Installer-8-5-0-Windows-postgres。
或者
針對 Microsoft SQL Server,從 support.ptc.com 的 > > > > > 下,下載 ThingWorx-Platform-Foundation-Installer-8-5-0-Windows-mssql。
4. 擷取對應版次。
5. 針對 PostgreSQL,執行 ThingWorxFoundationPostgres-8.5.0-x64.exe。
或者
針對 Microsoft SQL Server,執行 ThingWorxFoundationMSSQL-8.5.0-x64.exe。
6. 逐步完成安裝程式畫面。
|
在「ThingWorx Foundation 內容」畫面中,「使用 SSL/TLS 進行安全連線」核取方塊預設為已選取。您可以清除此核取方塊來在安裝程式中禁用 SSL/TLS。如果您選擇使用 SSL/TLS,請輸入在上述先決條件中產生的 keystore 值。
|
7. 安裝 ThingWorx Foundation 之後,系統將提示您授權組態管理員。
a. 在 Setup : Configure licensing for ThingworxFoundation for Postgres 或 Setup : Configure licensing for ThingworxFoundation for Mssql 螢幕中按一下「下一步」。
b. 使用授權組態管理員連線至 PTC 授權伺服器或配置 ThingWorx Foundation 以使用預先下載的授權。
c. 逐步完成授權畫面。
8. ThingWorx Foundation 安裝完成。
在 Windows 上啟動/停止 ThingWorx Foundation 服務
1. 導覽至 Services.msc。
2. 找到 ThingWorx-Foundation 服務。
3. 將其開始或停止。
在 Linux 上安裝 ThingWorx Foundation
1. 請確保能夠滿足上述各部份所述的先決條件。
2. 以管理員身份登入 ThingWorx 主機。
3. 針對 PostgreSQL,從 support.ptc.com 的 > > > > > 下,下載 ThingWorx-Platform-Foundation-Installer-8-5-0-Linux-postgres。
或者
針對 Microsoft SQL Server,從 support.ptc.com 的 > > > > > 下,下載 ThingWorx-Platform-Foundation-Installer-8-5-0-Linux-mssql。
4. 擷取對應版次。
5. 針對 PostgreSQL,執行 ThingWorxFoundationPostgres-8.5.0-x86_64.run。
或者
針對 Microsoft SQL Server,執行 ThingWorxFoundationMSSQL-8.5.0-x86_64.run。
6. 逐步完成安裝程式畫面。
|
在「ThingWorx Foundation 內容」畫面中,「使用 SSL/TLS 進行安全連線」核取方塊預設為已選取。您可以清除此核取方塊來在安裝程式中禁用 SSL/TLS。如果您選擇使用 SSL/TLS,請輸入在上述先決條件中產生的 keystore 值。
|
7. 安裝 ThingWorx Foundation 之後,系統將提示您授權組態管理員。
a. 在 Setup : Configure licensing for ThingworxFoundation for Postgres 螢幕或 Setup : Configure licensing for ThingworxFoundation for Mssql 螢幕中按一下「下一步」。
b. 使用授權組態管理員連線至 PTC 授權伺服器或配置 ThingWorx Foundation 以使用預先下載的授權。
c. 逐步完成授權畫面。
8. ThingWorx Foundation 安裝已完成,您現在可以使用 ThingWorx Foundation。
在 Linux 上啟動/停止 ThingWorx Foundation 服務
1. 以擁有管理權限的使用者身份登入 ThingWorx 主機 (執行 sudo)。
2. 欲開始服務,請輸入 sudo systemctl start ThingWorx-Foundation。
3. 欲停止服務,請輸入 sudo systemctl stop ThingWorx-Foundation。
連接至 ThingWorx Foundation 伺服器
1. 存取 ThingWorx Foundation URL。
例如:https://<主機名稱>:<埠>/Thingworx/Composer。
根據 SSL/非 SSL 的組態及安裝期間使用的連接埠,ThingWorx Foundation URL 將有所不同。SSL 預設為啟用;但您可以禁用 SSL/TLS。請參閱上述在安裝程式中啟用 SSL/TLS 的先決條件 部份。
2. 提供使用者認證。
使用者名稱是 Administrator,密碼是在安裝期間輸入的內容。
安裝程式記錄檔
安裝
|
Linux
|
Windows
|
ThingWorx Foundation
|
安裝記錄檔:
• ${installdir}/installer/logs/ThingWorxFoundation_install.log
例如:/opt/ThingWorxFoundation-8.5.0/installer/logs/ThingWorxFoundation_install.log
執行記錄檔:
• ${installdir}/ThingworxStorage/logs/
例如:/opt/ThingWorxFoundation-8.5.0/ThingworxStorage/logs/
|
安裝記錄檔:
• ${installdir}\installer\logs\ThingWorxFoundation_install.log
例如:C:\Program Files (x86)\ThingWorxFoundation-8.5.0\installer\logs\ThingWorxFoundation_install.log
執行記錄檔:
• ${installdir}\ThingworxStorage\logs\
例如:C:\Program Files (x86)\ThingWorxFoundation-8.5.0\ThingworxStorage\logs\
|
解除安裝基於 ThingWorx Foundation 安裝程式的安裝
1. 導覽至 ThingWorx Foundation 安裝位置。
2. 在 Windows 中執行 ThingWorxFoundation_uninstall.exe,
或
在 Linux 中執行 ThingWorxFoundation_uninstall.dat。
3. 系統提示時,請按一下「確定」以確認要繼續解除安裝。
4. 解除安裝完成後,會刪除安裝。解除安裝記錄檔會儲存到安裝位置。
從 PostgreSQL 刪除 ThingWorx 資料庫
1. 從 Windows 或 Linux 的指令行中,開啟 PostgreSQL 資料庫的連線。
例如,輸入 psql -U admin -h dbhost。
2. 如果您使用預設資料庫名稱,請執行 DROP DATABASE thingworx; 指令。
或者,如果您已自訂資料庫名稱,請執行 DROP DATABASE <your database name>; 指令。
從 Microsoft SQL 刪除 ThingWorx 資料庫
1. 從 Windows 或 Linux 的指令行中,開啟 Microsoft SQL 資料庫的連線。
例如,輸入 sqlcmd -U admin -s ‘dbhost\dbservicename,port’。
2. 如果您使用預設資料庫名稱,請執行 DROP DATABASE thingworx; GO; 指令。
或者,如果您已自訂資料庫名稱,請執行 DROP DATABASE <your database name>; GO; 指令。