ThingWorx Foundation 安装程序
最新 ThingWorx Foundation 安装程序文件发布在 support.ptc.com 的 > > > > 和 下。
此安装程序将执行以下操作:
• 安装 ThingWorx Foundation
• 安装 Tomcat
• 帮助您配置 ThingWorx Foundation 许可证
以下操作系统与数据库组合支持 ThingWorx Foundation 安装程序:
• 带有 PostgreSQL 的 Windows
• 带有 Microsoft SQL Server 的 Windows
• Red Hat Enterprise Linux 与 PostgreSQL
• Red Hat Enterprise Linux 与 Microsoft SQL Server
硬件规模定制
以下是最低要求,实际大小取决于应用程序和使用情况。
组件
|
值
|
注意
|
内存
|
16 GB RAM (最小)
|
必须为 Java VM 分配专用内存。
|
CPU
|
4
|
虚拟环境对于 CPU 或内核数量可能有其特殊要求和用语。在确定环境是否满足最低要求时必须考虑这一点。
|
磁盘空间
|
100 GB 可用磁盘空间
|
该大小将容纳默认的应用程序和部分初始配置数据。
|
• 其中不包括操作系统或其他必备软件所需的空间。
• 任何给定应用程序所需的总磁盘空间取决于要维持的配置量和运行时数据量。客户应根据其应用程序要求,与“销售和现场支持”一起估计空间需求。
|
|
磁盘速度
|
10K RPM 或更快
|
如果要将数据存储在 ThingWorx Platform 上,则速度至关重要。
|
根据您的操作系统和数据库,您必须确保在运行 ThingWorx Foundation 安装程序之前具备以下条件:
Windows 与 PostgreSQL 的先决条件
您必须具备以下条件:
• 具有管理员访问权限的 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 文件在 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 环境变量中。您可以按照以下步骤进行操作:
2. 安装 pgadmin 客户端。
3. 更新 PATH 环境变量以添加 pgadmin 客户端的安装路径。
Windows 与 Microsoft SQL Server 先决条件
您必须具备以下条件:
• 具有管理员访问权限的 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 环境变量中。
Red Hat Enterprise Linux 与 PostgreSQL 的先决条件
您必须具备以下条件:
• 具有管理员访问权限的 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 文件在 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 9.6 或 10.8 兼容的 psql 客户端。您可以运行以下命令来安装 psql 客户端:
yum install rh-postgresql96-postgresql-syspaths
Red Hat Enterprise Linux 与 Microsoft SQL Server 的先决条件
您必须具备以下条件:
• 具有管理员访问权限的 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 屏幕上,单击 Next。
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 屏幕上,单击 Next。
b. 使用许可证配置器连接到 PTC 许可证服务器,或配置 ThingWorx Foundation 使用预先下载的许可证。
c. 逐步通过许可证屏幕。
8. ThingWorx Foundation 安装已完成,您现在可以使用 ThingWorx Foundation。
启动/停止 Linux 上的 ThingWorx Foundation 服务
1. 以具有管理权限 (执行 sudo) 的用户登录 ThingWorx 主机。
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. 出现提示时,单击 OK 以确认要继续卸载。
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; 命令。