Restore Your Configuration and Custom Tasks into the Target System
1. Export Configuration: Export your ThingWorx Navigate configurations from the source system.
a. Extract the zip file ThingWorx-Navigate-Framework-<version>.zip from ThingWorx Navigate Framework Extension: thingworx-navigate-configuration-manager-1.0.1.zip.
b. In ThingWorx Composer, select > > .
c. In the Import Extensions window, click Browse and select thingworx-navigate-configuration-manager-1.0.1.zip.
d. Click Import.
e. To export the file to ThingWorx complete the following steps:
a. In ThingWorx Composer go to Things.
b. Search for DataConfigurationAPI.
c. Select View.
d. Under Entity Information, select Services.
e. Click Test on ExportDataToFile.
f. Under fileName enter the name of the JSON file for storing the exported configuration. The exported file is saved to the default location: \ThingworxStorage\repository\NavigateFileRepository\.
g. Click Execute Service.
h. Check for a success message: Export completed successfully.
2. Prepare for configuring your system:
a. When upgrading from these versions:
▪ ThingWorx Navigate 1.5.x
▪ ThingWorx Navigate 1.6.1
Run the “Prepare configurations” service in the DataConfigAPI Thing:
a. In ThingWorx go to Things.
b. Search for DataConfigurationAPI.
c. Select View.
d. On Entity Information, select Services.
e. Click Test on the service you need:
▪ PrepareConfiguratuonsFor1_5
▪ PrepareConfigurationsFor1_6_1
c. Restart
Apache Tomcat and clear browser cache. Otherwise, you may experience problems later in the process. For more information, see “Import and Management” in
ThingWorx Development Guide.
3. Import your JSON ThingWorx Navigate Configuration file (the one you exported in the previous section):
a. In ThingWorx go to Things.
b. Search for Thing: DataConfigurationAPI.
c. Select View.
d. On Entity Information, select Services.
e. Click Test on ImportDataFromFile.
f. Under fileName, provide the file name.
g. Click Execute Service. You can check the generated import logs, for entities details or errors, at this location: \ThingworxStorage\repository\NavigateFileRepository\ImportLogs.
4. Redeploy Your Custom Tasks
a. Import your custom tasks:
If you have custom tasks built by modifying ThingWorx Navigate out-of-the box extensions, reimport those custom tasks you backed up earlier.
b. Configure custom tasks for the newWindchill Connector:
ThingWorx Navigate 1.7.1 uses a new Windchill connector. You must do one of the following to make sure your custom tasks work with the new connector:
▪ If your task uses Info*Engine tasks, reconfigure ptc-windchill-demo-thing.
▪ If your task uses REST services, update your task to use the new ptc-windchill-integration-connector thing. To do this, you must recreate the services on the new connector. Only REST services are supported on the new connector.
5. Restart Apache Tomcat and Integration Runtime.
