安装和升级 > 安装 ThingWorx > ThingWorx Foundation 安装程序 > 面向 Windows 的 ThingWorx Foundation 安装程序
面向 Windows 的 ThingWorx Foundation 安装程序
A.) 带有 PostgreSQL 的 Windows 安装程序的先决条件 
* 
如果在此过程中找到现有安装，则安装程序将升级 ThingWorx Foundation。有关详细信息，请参阅使用安装程序升级 ThingWorx Foundation。
* 
不建议在 ThingWorx 安装程序的文件名中使用空格。如果您尝试使用包含空格字符的文件路径安装 ThingWorx，则 ThingWorx 安装程序会遇到问题。如果必须使用空格，则管理员应启用 Windows 对 8dot3 的支持。
• 您已经查阅了 ThingWorx Foundation 安装程序帮助主题中所述的信息和一般先决条件。
• 要在使用 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 文件在 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 环境变量中。您可以按照以下步骤进行操作：
a. 下载 pgadmin4-4.1-x86.exe，位于 https://www.postgresql.org/ftp/pgadmin/pgadmin4/v4.1/windows/。
b. 安装 pgadmin 客户端。
c. 更新 PATH 环境变量以添加 pgadmin 客户端的安装路径。
B.) 带有 SQL Server 的 Windows 安装程序的先决条件 
* 
如果在此过程中找到现有安装，则安装程序将升级 ThingWorx Foundation。有关详细信息，请参阅使用安装程序升级 ThingWorx Foundation。
* 
不建议在 ThingWorx 安装程序的文件名中使用空格。如果您尝试使用包含空格字符的文件路径安装 ThingWorx，则 ThingWorx 安装程序会遇到问题。如果必须使用空格，则管理员应启用 Windows 对 8dot3 的支持。
• 您已经查阅了 ThingWorx Foundation 安装程序帮助主题中所述的信息和一般先决条件。
要在使用 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 环境变量中。
C.) 在安装程序中启用 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 密码。
D.) 在 Windows 上安装 ThingWorx Foundation 
1. 确保满足上述各部分中所述的先决条件。
2. 对于 PostgreSQL，请前往 support.ptc.com 的“下载软件” > “订购或下载软件更新” > ThingWorx Foundation > “版本 <最新>” > ThingWorx PostgreSQL > “最近的日期代码”，下载 ThingWorx-Platform-Foundation-Installer-x-x-x-Windows-postgres。
或
对于 Microsoft SQL Server，请前往 support.ptc.com 的“下载软件” > “订购或下载软件更新” > ThingWorx Foundation > “版本 <最新>” > ThingWorx Mssql > “最近的日期代码”，下载 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 复选框。如果选中此复选框，则许可证配置器会在安装程序完成并关闭后打开。如果取消选中 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。
E.) 连接到 ThingWorx Foundation 服务器 
1. 访问 ThingWorx Foundation URL。
例如：https://<主机名>:<端口>/Thingworx/Composer。
根据您在安装期间使用的 SSL/非 SSL 和端口的配置，ThingWorx Foundation URL 将有所不同。默认情况下会启用 SSL；但是，您可以禁用 SSL/TLS。请参阅上文在安装程序中启用 SSL/TLS 的先决条件部分。
2. 提供用户登录凭据。
用户名为 Administrator，密码是在安装过程中输入的密码。
F.) 其他安装程序功能和故障排除 
启动/停止 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. 在 PATH 系统变量中设置 /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 选项”中移除以下内容：
-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 选项”：
-Xlog:gc:file=C:\Program Files
(x86)\ThingWorxFoundation/tomcat/current/logs/gc.log:time,level,tags
10. 选取“应用”。
11. 选取“确定”。
应用程序随即关闭。
12. 通过执行以下操作使用 tomcat9.exe 更新服务参数：
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。
这对您有帮助吗?