Importing the ThingWorx Apps Extension
ThingWorx Apps is imported as an extension into a ThingWorx system. The instructions in this topic are for an initial import of ThingWorx Apps. If you are upgrading from a previous ThingWorx Apps release, see Upgrading ThingWorx Apps.
Complete the steps in the following sections:
Prerequisites
Before importing this product as a ThingWorx extension, complete the following prerequisites:
• Review the ThingWorx 8.5 requirements. For more information, see the 8.5 System Requirements in the ThingWorx Help Center.
• Install ThingWorx 8.5. 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. For more information, see Remote Access in the ThingWorx Help Center.
Import the ThingWorx Apps Extension
Import ThingWorx Apps as a ThingWorx extension into an existing ThingWorx 8.5 platform installation.
1. Ensure that the ThingWorx Remote Access Extension is imported. For more information, see Remote Access in the ThingWorx Help Center.
◦ For initial imports of ThingWorx Apps 8.5.0 or 8.5.1, the ThingWorx Remote Access Extension 1.1.0 is supported.
◦ For initial imports of ThingWorx Apps 8.5.2, the ThingWorx Remote Access Extension 1.2.0 is supported.
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:
• 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-Asset-Advisor-Integrations-<version>-extension-bundle—Includes the ThingWorx ServiceMax Integration extension (ThingWorx-ServiceMax-Integration-<version>-extension) For more information, see Asset Advisor Integrations.
The following optional extension is available to import along with ThingWorx Apps, and is available for download from > > > .
• ThingWorx-Software-Content-Management-<version>—For more information, see Software Content Management.
 |
The ThingWorx Utilities Core extension bundle 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 Installing ThingWorx Utilities 8.5 available from Reference Documents.
|
The following optional extension is available to import along with ThingWorx Apps, and is available for download from > > .
• ThingWorx-Rockwell-FT-MES-<version>-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. For more information, see JDBC Extensibility in the ThingWorx Help Center.
|
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.