Importing the Extensions (CSE, RAE, and ACE)
 |
This section assumes that you are working with a running, functional ThingWorx Platform. If you need to install and configure the ThingWorx Platform, v.9.x, refer to the ThingWorx Platform 9 Help Center. For earlier versions, use the search engine on the ThingWorx Reference Documents page on the PTC Support site to locate the PDF of the installation guide for your version of ThingWorx Platform.
|
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.
The ThingWorx SCM Extension and the required supporting ThingWorx Utilities-Core Extension that are provided in the ThingWorx Axeda Compatibility Package must be imported if you want the SCM functionality for assets that are running Axeda Agents. After importing the CSE, RAE, and ACE, refer to Importing ThingWorx Utilities Core and the SCM Extension for details on importing these extensions. For additional information about installing and upgrading ThingWorx Utilities, refer to the section, ThingWorx Utilities Installation, in the ThingWorx Utilities Help Center. This section of the 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 Migrating Extensions in the ThingWorx Platform 9 Help Center.
For information on the extension import and removal processes in a ThingWorx High Availability Cluster, refer to Managing ThingWorx Extensions in ThingWorx HA in the ThingWorx Platfom 9 Help Center.
|
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. Refer to the following topics in the ThingWorx Platform 9 Help Center for 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 
window, click the down arrow, and select Extension. The window changes to look like this:
window, click the down arrow, and select Extension. The window changes to look like this:
4. Click 
, and then navigate to the location where you downloaded the Axeda Compatibility Package and extracted it.
, 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 window, click the 
button.
window, click the 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.
| | When upgrading to RAE 3.0.0 and ACE 5.0.0, you must restart the ThingWorx Platform after importing the extensions. |
| | If you are upgrading the Axeda Compatibility Extension (ACE), the following error may appear.  If you click the more link to see the ApplicationLog, the following additional information appears:  You can ignore the error and, if SCM functionality is required, continue to upgrade the Utilities Core and SCM extensions. • thingworx_utilities_core-9.2.0-78.zip • thingworx_utilities_scm-9.2.0-78.zip However, make sure that after the upgrade you run the permissions services provided in the eMessageServices Thing. Running these scripts is required to grant runtime permissions to new services provided in this release. For example, the GetThingNameAndIdentifierByModelAndSerial services was updated to call the QueryImplementingThingWithData service. The eMessage Connector does not have Execute permissions on this service until the upgraded permissions services are run.Ignore the error and install the rest of the extensions: |
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 
.
.10. Restart the ThingWorx Platform.