Requirements for Remote Sessions
To use the Remote Access features of the ThingWorx Asset Advisor, ThingWorx Remote Access Client, ThingWorx eMessage Connector, and ThingWorx Platform, your environment must meet the following prerequisites):
1. The version of ThingWorx Platform for your version of the Remote Access Client (RAC) is installed and running. For compatibility information, refer to the topic, in this help center.
 |
Make sure that you have changed the settings in the platform configuration file, platform-settings.json, to enable the import of extensions and that you subsequently restarted the platform. Refer to the following topics in the ThingWorx Platform Help Center for details:
|
2. The ThingWorx Axeda Compatibility Package (ACP) has been downloaded and extracted. This package provides the versions of the Connection Services Extension (CSE), Remote Access Extension (RAE), Axeda Compatibility Extension (ACE), and the eMessage Connector that are required to use Remote Access features. Refer to the release notes for your version of the ACP for the version numbers.
3. The following extensions that are included in the ACP have been imported in the following order:
a. ThingWorx Connection Services Extension (CSE)
b. ThingWorx Remote Access Extension (RAE)
c. ThingWorx Axeda Compatibility Extension (ACE)
 |
The CSE and RAE must be imported before the ACE.
|
4. The ThingWorx eMessage Connector is installed, configured for remote access, and running.
5. You have created Things to represent your devices, using ThingWorx Composer and the latest Thing Templates provided in your version of the ACE.
6. As needed, you have set up the Remote Access Provider for your Axeda Gateway and/or Axeda Connector Agents:
a. You have configured the Axeda Global Access Server (GAS) to connect to the eMessage Connector instead of Axeda Platform.
b. When registering the GAS with ThingWorx Platform, the eMessage Connector automatically creates a Thing to represent the GAS. In ThingWorx Composer, navigate to the GAS Thing and run the EnableForRemoteSessions service to enable that GAS to be used for remote sessions.
For more details about remote access for Axeda eMessage Agents, refer to Remote Access for Axeda eMessage Agents through ThingWorx.
7. Depending on how you want to run remote sessions:
◦ If you want to use ThingWorx Asset Advisor, you have downloaded the ThingWorx Apps, imported the required Apps extensions into your ThingWorx Platform, and followed the setup, configuration, and permissions instructions in the help center for ThingWorx Apps 8.5.
◦ The Remote Access Client (RAC) is available separately and needs to be downloaded to the computer where a user will launch a remote session. Refer to ThingWorx Remote Access Client for details.
◦ End users have been assigned permissions and visibility to the devices they need to access.
8. The ThingWorx Remote Access Subsystem is configured and running on your ThingWorx Platform.
9. You have run the services that grant visibility and permissions for remote access to your end users. Refer to Security for Remote Sessions.
10. End users have the following permissions so that they can start a remote session on a RemoteAccessible Thing:
◦ READ on the RemoteAccessible Thing
◦ PROPERTY READ on the RemoteAccessible Thing
◦ SERVICE INVOKE on the services for remote sessions, such as StartSession
To assign end users these permissions, refer to the topic, Entity Permissions, in the ThingWorx Platform Help Center.
Next Steps
Once all of the steps above are complete, end users can access remote devices through ThingWorx Asset Advisor or the Remote Access Client that is launched from your own custom mashup. If creating your own mashup, use the RAClientLinker widget that is provided in the Remote Access Extension. Follow a link below to take your next step:
• To create a mashup using the widget and ThingWorx Mashup Builder, refer to Using the RAClientLinker Widget and ThingWorx Remote Access Client.
• To start a remote session using Asset Advisor, refer to the "Asset Advisor" section of the "Exploring the Apps" section in the help center for ThingWorx Apps 8.5