ThingWorx Flow > ThingWorx Flow 安装和管理 > 安装 ThingWorx Flow 8.4.x
安装 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 2016
• 带有 Microsoft SQL Server 2016 的 Windows 服务器 2016
• Red Hat Enterprise Linux 7.5 与 PostgreSQL 9.6
• Red Hat Enterprise Linux 7.5 与 Microsoft SQL Server 2016
* 
请注意以下几点：
• 除非先前安装中的所有构件均已移除，否则 ThingWorx Flow 安装程序不支持重复执行。在可回滚到安装前状态的虚拟机快照上安装 ThingWorx Flow。
• ThingWorx Flow 安装程序不支持卸载。
服务器要求
下表说明部署 ThingWorx 和 ThingWorx Flow 的最低系统要求。但是，实际大小取决于应用程序和使用情景。
硬件大小
组件
值
注意
内存
16 GB RAM (最小)
必须为 Java VM 分配专用内存。
CPU
4
虚拟环境对于 CPU 或内核数量可能有其特殊要求和用语。在确定环境是否满足最低要求时必须考虑这一点。
磁盘空间
100 GB 可用磁盘空间
该大小将容纳默认的 ThingWorx Flow Web 应用程序和部分初始配置数据。
* 
• 其中不包括操作系统或其他必备软件所需的空间。
• 任何给定应用程序所需的总磁盘空间取决于必须维持的配置和运行时数据量。客户应根据其应用程序要求，与“销售和现场支持”一起估计空间需求。
磁盘速度
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 > Release 8.4：
◦ ThingWorx Flow on Windows Server 2016 with PostgreSQL
◦ ThingWorx Flow on Windows Server 2016 with Microsoft SQL Server 2016
◦ ThingWorx Flow on Red Hat Enterprise Linux 7.5 with PostgreSQL
◦ ThingWorx Flow on Red Hat Enterprise Linux 7.5 with Microsoft SQL Server 2016
◦ ThingWorx and ThingWorx Flow on Windows Server 2016 with PostgreSQL
◦ ThingWorx and ThingWorx Flow on Windows Server 2016 with Microsoft SQL Server 2016
◦ ThingWorx and ThingWorx Flow on Red Hat Enterprise Linux 7.5 with PostgreSQL
◦ ThingWorx and ThingWorx Flow on Red Hat Enterprise Linux 7.5 with Microsoft SQL Server 2016
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“属性”窗口的“ThingWorx Flow 主机名称”字段中，输入下列值之一：
• 要安装 ThingWorx Flow 的机器的主机名称
• 如果已部署 ThingWorx，则建议重用已用于 ThingWorx 实例的主机名称。
此配置允许用户不更改其书签或学习新 URL。但是，必须修改 Tomcat 安装下 server.xml 文件中 Host 标记的 name 属性值。
根据主机硬件配置，整个设置过程大约需要 45 至 60 分钟。在安装的最后阶段，控制台窗口将会启动。请勿关闭或右键单击控制台窗口。安装完成后，该窗口会自动关闭。
如果要在不同的机器上安装 ThingWorx 和 ThingWorx Flow，请完成以下任务：
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，请将您的 <user> 添加到 twxflow 组以运行 pm2。
• 要实现自定义连接器，请使用 Flow SDK。有关详细信息，请参阅 部署连接器。
• 生成第三方 SSL 证书：
默认情况下，安装程序会为主机生成未签名的 SSL 证书。安装后，完成以下步骤来更改证书：
1. 导航到以下路径：
<ThingWorx Flow Installation directory>\SSL
2. 使用 orchestration.csr 证书请求文件从证书颁发机构获取证书。
3. 遵循证书颁发机构说明。
4. 使用颁发机构生成的证书替换现有 orchestration.crt 证书。
验证
要验证 ThingWorx Flow 是否已正确安装，请以管理员的身份启动命令提示符，然后执行以下命令：
pm2 ls
以下 ThingWorx Flow 组件的状态必须为“在线”：
• 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://<主机名>/Thingworx/Composer/index.html
根据在 Hostname for ThingWorx Flow 字段中输入的值，<主机名> 为下列项之一：
• 要安装 ThingWorx Flow 的机器的主机名称
• 现有 ThingWorx 安装的主机名称
排除故障
情景
解决方案
如果 ThingWorx Flow 服务器 URL 不可访问或返回错误代码 500
1. 打开 orchestration-installer 文件夹中的 settings.json 文件。
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 Flow 虚拟机访问 ThingWorx 主机
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/