Importing the ThingWorx Apps Extension
 |
The instructions in this topic are for an initial import of ThingWorx Apps on a single-server ThingWorx system. If you are importing ThingWorx Apps on a ThingWorx system that is configured as a high availability active-active environment, follow the instructions in Importing the ThingWorx Apps Extension
for a High Availability Active-Active Environment.
If you are upgrading from a previous ThingWorx Apps release, see Upgrading ThingWorx Apps.
|
ThingWorx Apps is imported as an extension into a ThingWorx system.
Complete the steps in the following sections:
Prerequisites
Before importing this product as a ThingWorx extension, complete the following prerequisites:
• Review the ThingWorx 9.0 requirements. For more information, see the 9.0 System Requirements in the ThingWorx Help Center.
• Install ThingWorx 9.0. For more information, see Installing ThingWorx in the ThingWorx Help Center.
• Configure ThingWorx to enable extension import. For more information, see Importing Extensions in the ThingWorx Help Center.
• The ThingWorx Remote Access Extension must be imported as part of your ThingWorx Platform installation before the ThingWorx Apps extension is imported. You can find the compatible version of the ThingWorx Remote Access Extension in the "ThingWorx Extensions" section of the release matrix in Release Advisor for your installed version of ThingWorx.
Import the Extension Files
Import ThingWorx Apps as a ThingWorx extension into an existing ThingWorx 9.x Platform installation.
1. Ensure that the ThingWorx Remote Access Extension is imported. You can find the compatible version of the ThingWorx Remote Access Extension in the "ThingWorx Extensions" section of the release matrix in Release Advisor for your installed version of ThingWorx.
2. Download and unzip the contents of the following file: ThingWorx-Apps-<version>-extension-bundle
To locate the download, go to the PTC Software Downloads page and expand the following folders: > > .
3. Import the ThingWorx Apps extension files. The extension files must be imported in the following order:
a. ThingWorx-Apps-<version>-extension-dependencies
b. ThingWorx-Apps-<version>-extension
To import the extension files:
a. In ThingWorx Composer, navigate to > .
b. On the Import window, select Extension from the Import Option list.
c. Under File Name, click Browse. Navigate to and select the extension file.
d. Click Import. When the import finishes, click Close.
e. Repeat as needed.
4. View the extensions after the import by navigating to > .
Import Optional Extensions
The following optional extensions are available to import along with ThingWorx Apps, and are downloaded from the same location on the PTC Software Downloads page:
• ThingWorx-Asset-Remoting-<version>-extension—Enables you to use the Remote Access and Control features in Asset Advisor. For more information, see Remote Access and Control.
• ThingWorx-Apps-<version>-extension-factory-demo—Provides an example implementation for manufacturing planning activities. For more information, see Manufacturing Planning Example Implementation.
The following optional extension is available to import along with ThingWorx Apps, and is available for download from > > > .
• ThingWorx-Utilities-Software-Content-Management-<version>—For more information, see Software Content Management.
|
|
The ThingWorx Utilities Core extension bundle (ThingWorx-Utilities-Core-<version>) is a prerequisite for the ThingWorx Software Content Management extension, and must be imported first. If you have not already imported the ThingWorx Utilities Core extension bundle, do so before importing the ThingWorx Software Content Management extension. For more information, see ThingWorx Utilities Installation in the ThingWorx Utilities Help Center.
|
The following optional extension is available to import along with ThingWorx Apps, and is available for download from > > . This 8.5.0 extension is supported with ThingWorx Apps 9.0.
• ThingWorx-Rockwell-FT-MES-8-5-0-Extension-Bundle—For more information, see ThingWorx Rockwell FactoryTalk MES Integration.
Import the optional extensions in the same manner as you imported the ThingWorx Apps extensions.
Post Import Database Configurations
|
|
If you have imported these ThingWorx Apps extensions as a prerequisite for installing the ThingWorx Applications (Real-Time Production Performance Monitoring, Asset Monitoring, Utilization, and Connected Work Cell), you cannot use the ThingWorx Platform database for your ThingWorx Apps database. You must create a separate MSSQL database for this purpose.
Complete the following steps:
1. Create an MSSQL database with the following collation: SQL_Latin1_General_CP1_CI_AS
2. Set Is Read Committed Snapshot On to true.
3. In step 2 of the following procedure, set the JDBC Settings on the PTC.SCA.SCO.MSSLDatabase Thing for the database that you created in the previous steps.
|
After importing the ThingWorx Apps extensions, complete the following database configurations.
1. Navigate to the database Thing corresponding to your database: PTC.SCA.SCO.PostgresDatabase or PTC.SCA.SCO.MSSQLDatabase.
2. Under Configuration, set the JDBC Settings appropriately for your database, including the JDBC Connection String, Database User Name, and Database Password fields. If you are using the same database that is used for the ThingWorx Platform, use the same values for those three fields as the values that are specified in the platform-settings.json file.
|
|
Before configuring your database Thing, ensure that the necessary JDBC drivers are present in ThingWorx. ThingWorx can use JDBC drivers to connect to any JDBC compatible database (such as SQL Server, MySQL, and so on). You can also connect using the ThingWorx Edge MicroServer and the ThingWorx Host/Resource using OLEDB and ODBC if the database is behind a firewall. If a JDBC extension for your database is not in ThingWorx, you can manually add the JDBC driver by downloading the driver and adding the files to the following location: /<Tomcat folder>/webapps/Thingworx/WEB-INF/lib. After copying the driver, you must restart your ThingWorx server.
|
3. Click Save to save the database Thing.
4. Navigate to the PTC.Factory.C_LaunchPointConfigurationThing_[ReleaseVersion] Thing.
5. Under Configuration, in the DatabaseConfigurationSettings section, edit the DBConnection field to point to the database Thing you configured in step 2.
6. Click Save to save the launch point configuration Thing.
7. Navigate to the PTC.SCA.SCO.DatabaseManager Thing.
8. Under Services, execute the CreateTables service.
Update the Script Timeout Setting
Update the script timeout setting.
1. On the ThingWorx server, navigate to the ThingWorxPlatform folder.
2. Open the platform-settings.json file in a text editor.
3. Find and update the ScriptTimeout setting to 500.
4. Save and close the platform-settings.json file.
5. Restart the ThingWorx server.
For more information, see platform-settings.json Configuration Details in the ThingWorx Help Center.
Access ThingWorx Apps
To access ThingWorx Apps, go to the following URL on your ThingWorx server. Replace the <port> with your port number.
https://localhost:<port>/Thingworx/FormLogin/Welcome
The default user name is Administrator. The password is the one that you specified during the installation and configuration of ThingWorx.