安裝 ThingWorx Flow 8.4.x

ThingWorx Flow > ThingWorx Flow 安裝與管理 > 安裝 ThingWorx Flow 8.4.x

ThingWorx Flow 隨 ThingWorx 8.4.1 一起發行。

您可以在 ThingWorx 的現有實例上安裝 ThingWorx Flow，也可以使用單一安裝程式執行 ThingWorx 和 ThingWorx Flow 的端對端安裝。

如果要在現有 ThingWorx 安裝上安裝 ThingWorx Flow，您必須將 ThingWorx 實例手動升級到版本 8.4.1。不支援在 ThingWorx 8.4.0 上自動安裝 ThingWorx Flow 8.4.1。

您可以使用不同資料庫組合在下列作業系統安裝 ThingWorx Flow：

• 含 PostgreSQL 9.6 的 Windows Server 16

• 含 Microsoft SQL Server 2016 的 Windows Server 16

• 含 PostgreSQL 9.6 的 Red Hat Enterprise Linux 7.5

• 含 Microsoft SQL Server 2016 的 Red Hat Enterprise Linux 7.5

請注意下列幾點：

• 除非來自之前安裝的所有加工品均已移除，否則 ThingWorx Flow 安裝程式不支援重複執行。請在可以回復至安裝前狀態的虛擬機器快照中安裝 ThingWorx Flow。

• ThingWorx Flow 安裝程式不支援解除安裝。

伺服器需求

下表提供關於部署 ThingWorx 和 ThingWorx Flow 的最低系統需求的資訊。不過，實際大小取決於應用程式與使用情況：

硬體大小

項目

值

附註：

記憶體

16 GB RAM (最低)

必須為 Java VM 分配專用記憶體。

CPU

虛擬化環境可能擁有自己的術語，用來指定提供的 CPU 與核心數。確定環境是否符合最低需求時，必須考慮這一點。

磁碟空間

100 GB 的可用磁碟空間

此大小可容納預設 ThingWorx Flow web 應用程式與一些初始組態資料。

• 這不包括 OS 或其他必要軟體所需的空間。

• 任何所提供應用程式需要的總磁碟空間都取決於必須保留的組態與執行時間資料量。客戶應使用銷售與現場支援，根據其應用程式需求預估空間需求。

磁碟速度

10K RPM 或更快

如果您要將資料儲存在 ThingWorx Platform，速度是很重要的。ThingWorx Flow 建議使用經濟實惠的最快速磁碟，但不應使用速度低於 10000 RPM 的磁碟。

作業系統
支援的作業系統 (僅限 64 位元)	生產
Windows Server 2016 或更新版本 (管理員存取權)	是
Red Hat Enterprise Linux (RHEL) 7.5	是

資料庫選項
資料庫	支援的版本
PostgreSQL	最低 9.6
Microsoft SQL Server	2016

ThingWorx Flow 支援遠端資料庫。

如需有關在生產環境中執行 ThingWorx 之伺服器硬體需求的詳細資訊，請參閱「PTC 參考文件支援」網站中的 ThingWorx 系統需求指南。

安裝先決條件

安裝 ThingWorx Flow 之前，請執行下列任務：

1. 確定要在其中部署元件的環境，例如實體伺服器、虛擬伺服器環境、公用雲端或私人雲端。

2. 您決定好部署環境之後，請確保符合 ThingWorx Platform 與 ThingWorx Flow 先決條件。

有關 ThingWorx 安裝先決條件的資訊，請參閱 ThingWorx 安裝程式主題的先決條件部份。

使用 thingworx.war 檔案與使用安裝程式安裝 ThingWorx，兩者先決條件不同。在安裝 ThingWorx Flow 之前，請確保已符合 ThingWorx 安裝程式的先決條件。

3. 根據您的作業系統與資料庫組合從 PTC 支援網站下載適當軟體封裝。

下列安裝程式可在「下載軟體」 > 「訂購或下載軟體更新」 > ThingWorx Platform > 「8.4 發行版本」下找到。

◦ ThingWorx Flow - 適用於含 PostgreSQL 的 Windows Server 2016

◦ ThingWorx Flow - 適用於含 Microsoft SQL Server 2016 的 Windows Server 2016

◦ ThingWorx Flow - 適用於含 PostgreSQL 的 Red Hat Enterprise Linux 7.5

◦ ThingWorx Flow - 適用於含 Microsoft SQL Server 2016 的 Red Hat Enterprise Linux 7.5

◦ ThingWorx 與 ThingWorx Flow - 適用於含 PostgreSQL 的 Windows Server 2016

◦ ThingWorx 與 ThingWorx Flow - 適用於含 Microsoft SQL Server 2016 的 Windows Server 2016

◦ ThingWorx 與 ThingWorx Flow - 適用於含 PostgreSQL 的 Red Hat Enterprise Linux 7.5

◦ ThingWorx 與 ThingWorx Flow - 適用於含 Microsoft SQL Server 2016 的 Red Hat Enterprise Linux 7.5

4. 若要在 ThingWorx 的現有實例上安裝 ThingWorx Flow，請確保安裝並配置 ThingWorx Platform。

如需有關安裝及配置 ThingWorx 的詳細資訊，請參閱安裝與升級 ThingWorx。

5. 根據已安裝的資料庫，請確保具有下列值：

資料庫	參數
PostgreSQL	• PostgreSQL IP 位址或主機名稱 • PostgreSQL 埠 • PostgreSQL 管理員使用者名稱 • PostgreSQL 管理員密碼 • ThingWorx 資料庫登入使用者名稱 • ThingWorx 登入密碼 • ThingWorx 資料庫名稱
Microsoft SQL Server	• SQL Server IP 位址或主機名稱 • SQL Server 埠 • SQL Server 資料庫實例 • SQL Server 管理員使用者名稱 • SQL Server 管理員密碼 • ThingWorx 資料庫登入使用者名稱 • ThingWorx 登入密碼 • ThingWorx 資料庫名稱

6. (僅限 Linux) 請確保已設定下列先決條件：

◦ 管理員具有 Red Hat 7.5 存取權限

◦ 執行下列指令來啟用軟體集合：

▪ yum-config-manager --enable 'Red Hat Enterprise Linux Server 7 RHSCL (RPMs)'

▪ yum-config-manager --enable 'Red Hat Enterprise Linux Server 7 Extra(RPMs)'

▪ yum-config-manager --enable 'Red Hat Enterprise Linux Server 7 Optional (RPMs)'

▪ yum-config-manager --enable 'Red Hat Enterprise Linux Server 7 RH Common (RPMs)'

▪ yum-config-manager --enable 'Red Hat Enterprise Linux Server 7 Supplementary (RPMs)'

◦ 執行下列指令來啟用 EPEL 存放庫：

wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm

yum localinstall epel-release-latest-7.noarch.rpm

安裝 ThingWorx Flow

請完成下列步驟以安裝 ThingWorx Flow：

1. 以管理員的身份登入。

2. 啟動適當的安裝程式。

3. 依照安裝程式畫面上的指示執行。

在 ThingWorx Flow 視窗的「內容」中，於 Hostname for ThingWorx Flow 中，輸入下列其中一個值：

• 要安裝 ThingWorx Flow 的機器的主機名稱

• 如果已部署 ThingWorx，建議重複使用已用於 ThingWorx 實例的主機名稱。

此配置可讓使用者不變更其書簽或瞭解新的 URL。但是，必須在 Tomcat 安裝下的 server.xml 檔案中修改 Host 標籤中 name 屬性的值。

整個安裝過程需要花費大約 45 到 60 分鐘的時間，具體視主機硬體組態而定。在安裝的最後階段，控制台視窗會啟動。請勿關閉控制台視窗或在其上按一下滑鼠右鍵。安裝完成後，該視窗會自動關閉。

如果要將 ThingWorx Flow 與 ThingWorx 安裝在不同的電腦上，請完成下列任務：

1. 將 ThingWorx platform_settings.json 檔案複製到您要安裝 ThingWorx Flow 的主機。

2. 安裝 ThingWorx Flow。

3. ThingWorx Flow 安裝之後，將更新的 platform_settings.json 檔案複製到 ThingWorx 主機。

4. 重新啟動 ThingWorx。

5. 執行下列指令以在 ThingWorx 主機上啟用 PORT：

firewall-cmd --zone=public --add-port=8080/tcp --permanent && firewall-cmd --reload

ThingWorx Flow 的後安裝步驟

在開始使用 ThingWorx Flow 之前，完成下列後安裝步驟：

• 如果您已在 RHEL 上安裝 ThingWorx Flow，請將 <使用者> 新增至 twxflow 群組以執行 pm2。

• 欲實行自訂連接器，請使用 Flow SDK。如需詳細資訊，請參閱部署連接器。

• 產生協力廠商 SSL 憑證：

依預設，安裝程式會針對主機產生未簽署的 SSL 憑證。完成下列步驟來在安裝後變更憑證：

1. 導覽至下列路徑：

<ThingWorx Flow 安裝目錄>\SSL

2. 使用 orchestration.csr 憑證請求檔案來從憑證授權單位取得憑證。

3. 遵循憑證授權單位的指示操作。

4. 將現有 orchestration.crt 取代為憑證授權單位所產生的憑證。

核對

若要核對 ThingWorx Flow 是否已正確安裝，請以管理員身份啟動命令提示字元並執行下列指令：

pm2 ls

下列 ThingWorx Flow 元件的狀況必須為 'online'：

• flow-api

• flow-engine

• flow-exchange

• flow-lookup

• flow-oauth-server

• flow-trigger

若要執行簡單的測試流程，請參閱測試流程執行。

存取 ThingWorx Flow

欲存取 ThingWorx Flow，請完成下列步驟：

1. 在 Google Chrome 中輸入以下 URL，來存取 ThingWorx Flow：

https://<hostname>/Thingworx/Composer/apps/flow/，其中，<hostname> 是您在安裝 ThingWorx Flow 時於「ThingWorx Flow 的主機名稱」欄位中輸入的主機名稱。依預設，這是您安裝 ThingWorx Flow 之電腦的主機名稱。

2. 輸入用來登入的 ThingWorx Platform 使用者認證。

存取 ThingWorx

使用下列 URL 來存取 ThingWorx Composer：

https://<hostname>/Thingworx/Composer/index.html

根據在 Hostname for ThingWorx Flow 中輸入的值，<hostname> 是下列其中一項：

• 要安裝 ThingWorx Flow 的機器的主機名稱

• 現有 ThingWorx 安裝的主機名稱

疑難排解

情境	解決方案
如果 ThingWorx Flow 伺服器 URL 不可存取或傳回錯誤代碼 500	1. 開啟 settings.json 檔案，此檔案位於 orchestration-installer 資料夾中。 2. 在 orchestration 部份中，檢查 protocol、host 或 port 參數的值。 "orchestration": { "url": "hostname", "services": { "thingworx": { "protocol": "https", "host": "localhost", "port": "8443", "platform_settings": "C:\\Program Files (x86)\\ThingWorxPostgres-8.4.1-SNAPSHOT\\ThingworxPlatform\\platform-settings.json" } } }, 3. 如果存在任何不正確的值，請更新該值並儲存檔案。 4. 導覽到 orchestration-installer\bin 資料夾，並根據作業系統執行下列其中一項： ◦ install.bat ◦ install.sh 5. 重新啟動 ThingWorx-Flow 服務。 6. 存取 ThingWorx Flow 伺服器 URL。
如果 ThingWorx 主機無法從 ThingWorx Flow 虛擬機器存取	1. 導覽到 ThingWorxOrchestration\modules\RabbitMQ\log 資料夾下的 RabbitMQ 記錄檔。 2. 開啟記錄檔並檢查下面一行內容是否在記錄檔中： user 'flowuser' authenticated and granted access to vhost 'orchestration' 3. 如果該行不存在，請執行下列操作： ◦ 檢查 ThingWorx 虛擬機器上的防火牆連線。 ◦ 請確保在兩個主機上均可存取 RabbitMQ 埠。檢查 ThingWorx 與 ThingWorx Flow 主機可以使用 DNS 名稱或主機名稱彼此存取。

情境

解決方案

如果 ThingWorx Flow 伺服器 URL 不可存取或傳回錯誤代碼 500

1. 開啟 settings.json 檔案，此檔案位於 orchestration-installer 資料夾中。

2. 在 orchestration 部份中，檢查 protocol、host 或 port 參數的值。

"orchestration": {
"url": "hostname",
"services": {
"thingworx": {
"protocol": "https",
"host": "localhost",
"port": "8443",
"platform_settings": "C:\\Program Files (x86)\\ThingWorxPostgres-8.4.1-SNAPSHOT\\ThingworxPlatform\\platform-settings.json"
}
}
},

3. 如果存在任何不正確的值，請更新該值並儲存檔案。

4. 導覽到 orchestration-installer\bin 資料夾，並根據作業系統執行下列其中一項：

◦ install.bat

◦ install.sh

5. 重新啟動 ThingWorx-Flow 服務。

6. 存取 ThingWorx Flow 伺服器 URL。

如果 ThingWorx 主機無法從 ThingWorx Flow 虛擬機器存取

1. 導覽到 ThingWorxOrchestration\modules\RabbitMQ\log 資料夾下的 RabbitMQ 記錄檔。

2. 開啟記錄檔並檢查下面一行內容是否在記錄檔中：

user 'flowuser' authenticated and granted access to vhost 'orchestration'

3. 如果該行不存在，請執行下列操作：

◦ 檢查 ThingWorx 虛擬機器上的防火牆連線。

◦ 請確保在兩個主機上均可存取 RabbitMQ 埠。

檢查 ThingWorx 與 ThingWorx Flow 主機可以使用 DNS 名稱或主機名稱彼此存取。

可以使用記錄檔對安裝進行疑難排解。記錄檔會儲存到下列位置：

• Windows

◦ 安裝記錄：C:\orchestration-installer\logs\install.log

◦ ThingWorx Flow 記錄：C:\ThingWorxOrchestration\.pm2\logs\

• Linux

◦ 安裝記錄：/opt/orchestration-installer/logs/install.log

◦ ThingWorx Flow 記錄：/opt/ThingWorxOrchestration/.pm2/logs/