Running SiteWise Edge on Siemens Industrial Edge
You can ingest data from your Siemens Industrial Edge device to your Amazon Web Services account by running a SiteWise Edge
gateway on the device. To do this, you create a SiteWise Edge gateway resource with a deployment target of
Siemens Industrial Edge device - new, download the configuration file, and upload it to
your Siemens app through the Siemens Industrial Edge Management (IEM) portal. For more information about running
Amazon IoT SiteWise Edge on Siemens Industrial Edge, including how to set up the required Siemens resources, see What is Industrial Edge?
Note
Siemens is not a vendor or supplier for Amazon IoT SiteWise Edge. The Siemens Industrial Edge Marketplace is an independent marketplace.
Prerequisites
To run Amazon IoT SiteWise Edge on Siemens Industrial Edge, you need the following:
A Siemens Digital Exchange Platform
account A Siemens Industrial Edge Hub (iehub) account
A Siemens Industrial Edge Management (IEM) instance
Either a Siemens Industrial Edge Device (IED) or a Siemens Industrial Edge virtual Device (IEvD)
Access to the Siemens Industrial Edge device deployment target. To get access, go to the Amazon IoT SiteWise console
and choose Request access.
Security
As part of the Shared Responsibility Model
- Customer responsibility
-
Vetting the partner.
Configuring the network access given to the partner.
Physically securing the device running Amazon IoT SiteWise Edge.
- Amazon responsibility
-
Isolating the partner from the customer Amazon cloud resources.
- Partner responsibility
-
Using secure defaults.
Keeping the solution secure over time through patches and other appropriate updates.
Keeping customer data confidential.
Vetting other applications available in the partner marketplace.
During the preview stage of this feature, customer data that Amazon IoT SiteWise caches on the partner device is accessible by the partner and other applications installed through the partner marketplace.
Creating the configuration file
Once you have the proper Siemens accounts and IEM instances, you can create a SiteWise Edge gateway of deployment type Siemens Industrial Edge device.
To create the configuration file
Navigate to the Amazon IoT SiteWise console
. -
In the navigation pane, choose Edge gateways.
-
Choose Create gateway.
-
For Deployment type, choose Siemens Industrial Edge device - new.
-
Enter a name for your SiteWise Edge gateway or use the name generated by Amazon IoT SiteWise.
-
(Optional) Under advanced configuration, do the following:
-
Enter a name for your Amazon IoT Core Thing or use the name generated by Amazon IoT SiteWise.
-
-
Choose Create gateway.
-
In the Generate SiteWise Edge gateway configuration file dialog box, choose Generate and download. Amazon IoT SiteWise automatically generates a configuration file that you will use to configure the Amazon IoT SiteWise Edge application.
Important
Make sure that you save the configuration file in a secure location. You will use the file later.
Now that you've created the SiteWise Edge gateway, do the following to finish setting up your SiteWise Edge gateway:
Once you have the configuration file and the SiteWise Edge gateway is configured, download the Amazon IoT SiteWise Edge application from the Siemens Industrial Edge Marketplace and install it using the Siemens Industrial Edge Management (IEM) portal. Then, access your Siemens Industrial Edge device through the Siemens Industrial Edge Management (IEM) portal and upload the configuration file on the device where you want to install the SiteWise Edge gateway.
Troubleshooting
To troubleshoot the SiteWise Edge gateway on your Siemens Industrial Edge device, you can access the logs for the application through the Siemens Industrial Edge Management (IEM) or
Siemens Industrial Edge Device (IED) portals. For more information, see Downloading Logs
I see 'SESSION_TAKEN_OVER' or 'com.aws.greengrass.mqttclient.MqttClient: Failed to publish the message via Spooler and will retry.' in the logs
If you see a warning that includes SESSION_TAKEN_OVER
or an error that includes com.aws.greengrass.mqttclient.MqttClient: Failed to publish the message
via Spooler and will retry.
in your logs at /greengrass/v2/logs/greengrass.log
, you may be trying to use the same configuration file for multiple SiteWise Edge
gateways on multiple devices. Each SiteWise Edge gateway needs a unique configuration file to connect to your Amazon Web Services account.
I see 'com.aws.greengrass.deployment.IotJobsHelper: No deployment job found.' or 'Deployment result already reported.' in the logs
If you see com.aws.greengrass.deployment.IotJobsHelper: No deployment job found.
or Deployment result already reported.
in your logs at
/greengrass/v2/logs/greengrass.log
, you may be trying to reuse the same configuration file.
There are multiple solutions:
If you want to reuse the configuration file, do the following:
Navigate to the Amazon IoT SiteWise console
. -
In the navigation pane, choose Gateways.
Choose the SiteWise Edge gateway you want to reuse.
Choose the Updates tab.
Select a different Publisher version and choose Deploy.
Follow the steps in Creating the configuration file to create a new configuration file.
I see 'Config file missing AWS_REGION' in the logs.
If you see Config file missing AWS_REGION
in the Siemens logs, the JSON of the configuration file has been corrupted. You'll need to create a new configuration file.
Follow the steps in Creating the configuration file to create a new configuration file.
Contact us
If you'd like to request access to the application, go to the Amazon IoT SiteWise console
and choose Request access. If you'd like help troubleshooting the application, go to the Amazon IoT SiteWise console
, navigate to the details page of the SiteWise Edge gateway, and choose Get support.