面向 Windows 的 ThingWorx Foundation 安装程序
A.) 使用 Windows 安装程序安装 Azure PostgreSQL 灵活服务器的先决条件
 | 如果在此过程中找到现有安装，则安装程序将升级 ThingWorx Foundation。有关详细信息，请参阅使用安装程序升级 ThingWorx Foundation。 |
| | 不建议在 ThingWorx 安装程序的文件名中使用空格。如果您尝试使用包含空格字符的文件路径安装 ThingWorx，则 ThingWorx 安装程序会遇到问题。如果必须使用空格，则管理员应启用 Windows 对 8dot3 的支持。 |
• 您已经查阅了 ThingWorx Foundation 安装程序帮助主题中所述的信息和一般先决条件。
• 要在使用 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.) 使用 Windows 安装程序安装 PostgreSQL 的先决条件
| | 如果在此过程中找到现有安装，则安装程序将升级 ThingWorx Foundation。有关详细信息，请参阅使用安装程序升级 ThingWorx Foundation。 |
| | 不建议在 ThingWorx 安装程序的文件名中使用空格。如果您尝试使用包含空格字符的文件路径安装 ThingWorx，则 ThingWorx 安装程序会遇到问题。如果必须使用空格，则管理员应启用 Windows 对 8dot3 的支持。 |
• 您已经查阅了 ThingWorx Foundation 安装程序帮助主题中所述的信息和一般先决条件。
• 要在使用 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 文件在 PostgreSQL 与 ThingWorx Foundation 主机之间创建连接。 例如，如果 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.) 使用 Windows 安装程序安装 SQL Server 的先决条件
| | 如果在此过程中找到现有安装，则安装程序将升级 ThingWorx Foundation。有关详细信息，请参阅使用安装程序升级 ThingWorx Foundation。 |
| | 不建议在 ThingWorx 安装程序的文件名中使用空格。如果您尝试使用包含空格字符的文件路径安装 ThingWorx，则 ThingWorx 安装程序会遇到问题。如果必须使用空格，则管理员应启用 Windows 对 8dot3 的支持。 |
• 您已经查阅了 ThingWorx Foundation 安装程序帮助主题中所述的信息和一般先决条件。
要在使用 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
| |
在安装程序的“ThingWorx Foundation 属性”屏幕中，默认情况下会选中“使用 SSL/TLS 以提供安全连接”复选框。通过清除此复选框，可以禁用安装程序中 SSL/TLS 的使用。如果选取保留默认设置并使用 SSL/TLS，则必须在运行安装程序之前生成 Java keystore (.jks) 文件。Java keystore (.jks) 文件必须具有以下安全权限：
• keystore 文件必须在 Windows 上将 Read 和 Read & Execute 权限授予 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 值。 |
| | SSL 模式参数对于 Azure PostgreSQL 灵活服务器而言必不可少。sslRootCert 对于 verify-ca 和 verify-full SSL 模式而言必不可少。有关与 Azure PostgreSQL 灵活服务器进行安全通信以及下载证书的详细信息，请参阅在 Azure Database for PostgreSQL 中使用 TLS/SSL 进行加密连接 - 灵活服务器。 |
6. 在上一安装程序屏幕上，默认会选中 Open License Configurator 复选框。如果选中此复选框，则许可证配置器会在安装程序完成并关闭后打开。如果取消选中 Open License Configurator 复选框，则安装程序会关闭，且许可证配置器不会自动打开。
a. 在 Setup : Configure licensing for ThingworxFoundation for Postgres 或 Setup : Configure licensing for ThingworxFoundation for Mssql 屏幕上，单击 Next。
b. 使用许可证配置器连接到 PTC 许可证服务器，或配置 ThingWorx Foundation 使用预先下载的许可证。
c. 逐步通过许可证屏幕。
7. ThingWorx Foundation 安装已完成。
| | 有关在安装后增加 Tomcat 内存的信息，请参阅 PTC 支持文章 CS306401。 |
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。