Importing the Extension
Operator Advisor is imported as a extension into an existing ThingWorx system. The instructions in this topic are for an initial import of the extension. If you are upgrading from a previous release, see Upgrading Operator Advisor.
 |
Operator Advisor is imported as part of the ThingWorx Apps extension. If you have already completed the Importing the ThingWorx Apps Extension instructions in the ThingWorx Apps Help Center, skip the steps below and proceed to Configuring Operator Advisor.
|
Complete the steps in the following sections:
Prerequisites
Before importing this product as a ThingWorx extension, complete the following prerequisites:
• Review the Product Requirements.
• Review the ThingWorx 8.5 requirements. For more information, see 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 Extension
Import Operator Advisor as a ThingWorx extension into an existing ThingWorx 8.5 platform installation.
|
|
Before importing the extension files, ensure that the ThingWorx Remote Access extension has already been imported. For more information, see Remote Access in the ThingWorx Help Center.
• For initial imports of the ThingWorx Apps 8.5.0 or 8.5.1 extension, the ThingWorx Remote Access Extension 1.1.0 is supported.
• For initial imports of the ThingWorx Apps 8.5.2 extension, the ThingWorx Remote Access Extension 1.2.0 is supported.
|
1. 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: > > .
2. Import the 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 drop-down 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.
3. View the extensions after the import by navigating to > .
Post Import Database Configurations
After importing the extensions files, 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.
Configure Operator Advisor
Proceed to Configuring Operator Advisor.