Running SiteWise Edge on Siemens Industrial Edge - AWS IoT SiteWise

Running SiteWise Edge on Siemens Industrial Edge

You can ingest data from your Siemens Industrial Edge device to your AWS 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 AWS IoT SiteWise Edge on Siemens Industrial Edge, including how to set up the required Siemens resources, see What is Industrial Edge? in the Siemens documentation.

Note

Siemens is not a vendor or supplier for AWS IoT SiteWise Edge. The Siemens Industrial Edge Marketplace is an independent marketplace.

Prerequisites

To run AWS 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 AWS IoT SiteWise console and choose Request access.

Security

As part of the Shared Responsibility Model between AWS, our customers, and our partners the following describes who is responsible for the different aspects of security:

Customer responsibility
  • Vetting the partner.

  • Configuring the network access given to the partner.

  • Physically securing the device running AWS IoT SiteWise Edge.

AWS responsibility
  • Isolating the partner from the customer AWS 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 AWS 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
  1. Navigate to the AWS IoT SiteWise console.

  2. In the navigation pane, choose Edge gateways.

  3. Choose Create gateway.

  4. For Deployment type, choose Siemens Industrial Edge device - new.

  5. Enter a name for your SiteWise Edge gateway or use the name generated by AWS IoT SiteWise.

  6. (Optional) Under advanced configuration, do the following:

    1. Enter a name for your AWS IoT Core Thing or use the name generated by AWS IoT SiteWise.

  7. Choose Create gateway.

  8. In the Generate SiteWise Edge gateway configuration file dialog box, choose Generate and download. AWS IoT SiteWise automatically generates a configuration file that you will use to configure the AWS 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 AWS 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 in the Siemens documentation.

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 AWS 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:

    1. Navigate to the AWS IoT SiteWise console.

    2. In the navigation pane, choose Gateways.

    3. Choose the SiteWise Edge gateway you want to reuse.

    4. Choose the Updates tab.

    5. 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 AWS IoT SiteWise console and choose Request access.

  • If you'd like help troubleshooting the application, go to the AWS IoT SiteWise console, navigate to the details page of the SiteWise Edge gateway, and choose Get support.