Importing the Extensions (CSE, RAE, and ACE)
Three extensions within the Axeda Compatibility Package enable a ThingWorx Connector to communicate with the ThingWorx Platform and to support Axeda entities and remote sessions with assets that are running Axeda Agents:
• Connection Services Extension (CSE)
• Remote Access Extension (RAE)
• Axeda Compatibility Extension (ACE)
Since the eMessage Connector requires these extensions, your next step is to import them into the ThingWorx Platform. The CSE adds entities that the RAE and ACE require, and the RAE adds entities that the ACE requires, so you must import the CSE first, followed by the RAE and finally the ACE.
If you want to use ThingWorx Software Content Management functionality for assets that are running Axeda Agents, ensure that SCM is installed. For more information, see ThingWorx Utilities Installation, in the ThingWorx Utilities Help Center. This section of the ThingWorx Utilities Help Center includes the topics, Upgrading to a New Version of ThingWorx Utilities and Avoiding Upgrade Impacts.
 |
For information on migrating extensions, refer to the "Migrating Extensions" topic in the ThingWorx Platform Help Center for your ThingWorx version, available from the ThingWorx Help Centers landing page.
For information on the extension import and removal processes in a ThingWorx High Availability Cluster, refer to the "Managing ThingWorx Extensions in ThingWorx HA" topic in the ThingWorx Platfom Help Center for your ThingWorx version, available from the ThingWorx Help Centers landing page.
|
Import the Extensions
 |
Before importing extensions, you must modify settings in the platform-settings.json configuration file for the platform and restart the platform before you can import any extensions. For more information, see the following topics in the ThingWorx Platform Help Center for your ThingWorx version, available from the ThingWorx Help Centers landing page:
• "Importing Extensions"
• "platform-settings.json Configuration Details"
|
To import the extensions, using ThingWorx Composer, follow these steps
1. Log in to ThingWorx Composer.
2. From the Import/Export menu of Composer, select Import, as shown here:
3. Under Import Option in the Import window, click the down arrow, and select Extension. The window changes to look like this:
4. Click Browse, and then navigate to the location where you downloaded the Axeda Compatibility Package and extracted it.
5. Select the CSE archive, and click Open.
6. Once it becomes active in the Import window, click the Import button.
The ThingWorx Platform returns a message, indicating that the import was successful. For more information on what the CSE creates in the ThingWorx Platform, refer to Connection Services Extension Entity Reference.
Once the CSE import process is complete, event notification messaging is enabled in the ThingWorx Platform and the Thing Templates, Thing Shapes, Data Shapes, Things, and subsystem entities needed for the Connection Services Hub are available in the ThingWorx Platform.
7. To import the RAE archive, repeat steps 2 through 4, and for step 5, select the RAE archive. Repeat step 6 to complete the import.
For more information on what the RAE creates in the ThingWorx Platform, refer to the Remote Access Extension (RAE) Entity Reference.
Once the RAE import process is complete, the Thing Shapes, Data Shapes, and Things needed for remote access to Axeda entities in the ThingWorx Platform are available.
8. To import the ACE archive, repeat steps 2 through 4, and for step 5, select the ACE archive. Repeat step 6 to complete the import.
For more information on what the ACE creates in the ThingWorx Platform, refer to Axeda Compatibility Extension Entity Reference.
Once the ACE import process is complete, the Thing Templates, Thing Shapes, Data Shapes, and Things needed for Axeda entities in the ThingWorx Platform are available.
9. Click Close.
10. Restart the ThingWorx Platform.