Restore Your Configuration and Custom Tasks into the Target System
Before you import, perform the following:
1. Create the NavigateFileRepository folder at the following location: $<installdir>\ThingWorxStorage\repository\
2. Copy all exported files (created by executing the ExportEntities, ExportDataToFile, and ExportDBEntries services) from the source ThingWorx Navigate version to the location mentioned in step 1.
Import All Non-Navigate Entities
Import the XML file for all entities that you exported at the beginning:
1. In ThingWorx Composer, search for DataConfigurationAPI, and then open it. The General Information page opens.
2. Click Services.
3. For
ImportEntities, click
![Execute service icon Execute service icon](../../ThingWorx_Navigate/images/Navigate.1.046.1.jpg)
. The
Execute Service: ImportEntities window opens.
4. For Inputs, under fileName enter the name of the file earlier created by executing the ExportEntities service.
5. Click Execute. You can check the generated import logs, for entities details or errors, at this location: $<installdir>\ThingworxStorage\repository\NavigateFileRepository\ImportLogs.
Import Your Configurations
Complete the following steps to import your JSON ThingWorx Navigate Configuration file (the one you exported at the beginning):
1. In ThingWorx Composer, search for DataConfigurationAPI, and then open it. The General Information page opens.
2. Click Services.
3. For
ImportDataFromFile, click
![Execute service icon Execute service icon](../../ThingWorx_Navigate/images/Navigate.1.046.2.jpg)
. The
Execute Service: ImportDataFromFile window opens.
4. For Inputs, under fileName enter the name of the file earlier created by executing the ExportDataToFile service.
5. Click Execute. You can check the generated import logs, for entities details or errors, at this location: $<installdir>\ThingworxStorage\repository\NavigateFileRepository\ImportLogs.
Import Your Configurations for My Tasks
| This step is only applicable if you are upgrading from ThingWorx Navigate 8.5.x to 9.x. |
Complete the following steps to import your JSON
ThingWorx Navigate configuration file for
My Tasks (the file you exported in
Export the Configuration for My Tasks):
1. In ThingWorx Composer, search for DataConfigurationAPI, and then open it. The General Information page opens.
2. Click Services.
3. For
ImportDBEntries, click
![Execute service icon Execute service icon](../../ThingWorx_Navigate/images/Navigate.1.046.3.jpg)
. The
Execute Service: ImportDBEntries window opens.
4. For Inputs, under fileName enter the name of the file earlier created by executing the ExportDBEntries service.
5. Click Execute.
Restart Your ThingWorx Services
1. Restart Apache Tomcat.
2. Restart ThingWorx Integration Runtime.
Redeploy Your Custom Tasks
If you have custom tasks, reimport those custom tasks you backed up earlier.
1. Configure the Integration Connector for your custom tasks. For more information, refer to relevant topic:
| WindchillConnector (ptc-windchill-demo-thing) is deprecated, and will be removed in the release following ThingWorx Navigate 9.1. For a smooth transition to the next release, update your custom tasks to use the OData connector. |
2. Ensure that the TWXNavigate:AppMashup tag is added to your custom task’s mashup.
3. Restart Apache Tomcat and ThingWorx Integration Runtime.
Restore Your Blacklisted Attributes
| This step is only applicable if you are upgrading from ThingWorx Navigate 8.5.x to 9.x. |
If you made any changes to the blacklisted attributes, restore the blacklist you backed up before the upgrade. See the
Blacklist Attributes topic for more information.
Restart Your ThingWorx Services
1. Restart Apache Tomcat.
2. Restart ThingWorx Integration Runtime.