本文以Windows系统为例,介绍ThingWorx的安装步骤。

H2版

安装

  • PTC官网下载合适版本的Thingworx(h2版)
  • 访问Tomcat 网站下载32-bit/64-bit Windows 服务安装程序。
  • 下载JDK8以上的版本。

注意,H2为内嵌数据库,并不需要安装。

部署

Tomcat

  • 在“HTTP/1.1 连接器端口” 字段,键入“80” (或其他可用端口),其余默认设置安装

  • 启动Tomcat,在“Java 选项”字段中,将以下内容添加至选项字段的末尾:

    • 1
      2
      3
      4
      
      -Dserver -Dd64
      -XX:+UseG1GC
      -Dfile.encoding=UTF-8
      -Djava.library.path=<path to Tomcat>\webapps\Thingworx\WEB-INF\extensions
      
  • 清除Initial memory poolMaximum memory pool字段中的任意值。

  • 在Tomcat 的安装位置,打开CATALINA_HOME/conf/web.xml。通过将以下内容添加至web.xml 文件来替换默认错误页面。将以下内容置于web-app 标记内(在welcome-list 标记后)

    • 1
      2
      3
      4
      
      <error-page>
      <exception-type>java.lang.Throwable</exception-type>
      <location>/error.jsp</location>
      </error-page>
      
  • 要增加影响静态文件缓存的默认缓存设置,请在$CATALINA_HOME/conf/context.xml 文件中的<context></context> 标记内添加以下行:

    • 1
      
      <Resources cacheMaxSize="501200" cacheObjectMaxSize="2048" cacheTtl="60000"/>
      

配置Thingworx

  • 将压缩文件中的Thingworx.war文件放置在Tomcat中的webapps文件夹中。

  • 将platform-settings.json 放置在C:/ThingworxPlatform 文件夹中(没有则创建)。

  • 启用扩展导入

    • 将以下内容添加至platform-settings.json 文件

    •  1
       2
       3
       4
       5
       6
       7
       8
       9
      10
      
      "ExtensionPackageImportPolicy": {
      "importEnabled": <true or false>,
      "allowJarResources": <true or false>,
      "allowJavascriptResources": <true or false>,
      "allowCSSResources": <true or false>,
      "allowJSONResources": <true or false>,
      "allowWebAppResources": <true or false>,
      "allowEntities": <true or false>,
      "allowExtensibleEntities": <true or false>
      },
      
  • 使用h2数据库

    • 1
      2
      3
      4
      5
      6
      7
      8
      
      "PersistenceProviderPackageConfigs":{
      	"H2PersistenceProviderPackage":{
      		"ConnectionInformation":{
      			"password": "<addsecurepassword>",
      			"username": "twadmin"
      			}
      		}	
      },
      
  • 从官网得到license.bin文件,并放入C:\ThingworxPlatform中。

PostgreSQL版

安装

  • 官网进行下载合适的PostgreSQL版本,我这里下载的9.6.14 x64版。
  • PTC官网下载合适版本的Thingworx(PostgreSQL版)
  • 安装后打开pgAdmin,新建用户,并设置密码。

配置

  • 默认情况下,PostgreSQL服务器是在locked-down state。为了让ThingWorx与PostgreSQL服务器连接,需要pg监听其他用户的连接。
  • 在Windows平台下,找到PostgreSQL的data目录,默认为C:\Program Files\ PostgreSQL\9.x\data,在pg_hba.conf配置文件中,进行修改:
    • 允许所有IPv4地址进行连接:hostallall0.0.0.0/0md5
    • 允许所有IPv6地址进行连接:hostallall::0/0md5

执行脚thingworxPostgresDBSetup.bat时,将第10行改为全称,例如C:/ThingworxPostgresqlStorage

thingworx1

  • 执行Thingworx脚本

    • thingworxPostgresDBSetup.bat
    • thingworxPostgresSchemaSetup.bat
  • 同样,将Thingworx.war文件放置在Tomcat中的webapps文件夹中。

  • platform-settings.json使用PostgreSQL数据库

    • 1
      2
      3
      4
      5
      6
      7
      8
      9
      
      "PersistenceProviderPackageConfigs": {
      		"PostgresPersistenceProviderPackage": {
      			"ConnectionInformation": {
      				"jdbcUrl": "jdbc:postgresql://localhost:5432/thingworx",
      				"password": "password",
      				"username": "twadmin"
      			}
      		}
      	}
      

登录系统

  • 浏览器端输入http://localhost/Thingworx,进入系统。
  • 首次登录,用户名为Administrator,密码为platform-settings.json中的初始密码。
  • 若在tomcat中的log中看见SecurityManager错误,则可以参考这里

修改密码

  1. 在Composer 中,选择“管理员”>“更改密码”。
  2. 在“更改密码”窗口中,输入“当前密码”、“新密码”以及“确认密码”。
  3. 删除plateform-settings.json 文件中的初始密码。
  4. 在Composer 中打开“监控”>“子系统”> “许可子系统设置”来确认许可中包括的功能列表(获得许可的实体)。