Adding partner data sources to SiteWise Edge gateways - Amazon IoT SiteWise
SecurityAdd a partner data sourceSet up docker on your SiteWise Edge gateway
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Adding partner data sources to SiteWise Edge gateways

When using an Amazon IoT SiteWise Edge gateway you can connect a partner data source to your SiteWise Edge gateway and receive data from the partner in your SiteWise Edge gateway and the Amazon cloud. These partner data sources are Amazon IoT Greengrass components that are developed in partnership between Amazon and the partner. When you add a partner data source, Amazon IoT SiteWise will create this component and deploy it on your SiteWise Edge gateway.

To add a partner data source, do the following:

  • Add a partner data source

  • Go to the partner’s web portal and configure the partner data source so it connects to the SiteWise Edge gateway.

Topics

Security

As part of the Shared Responsibility Model between Amazon, 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.

Amazon responsibility

  • Isolating the partner from the customer Amazon cloud resources except those needed by the partner. In this case, Amazon IoT SiteWise ingestion.

  • Restricting the partner solution to a reasonable usage of the SiteWise Edge gateway machine resources (CPU, memory, file system).

Partner responsibility

  • Using secure defaults.

  • Keeping the solution secure over time through patches and other appropriate updates.

  • Keeping customer data confidential.

Add a partner data source

To connect a partner data source to your SiteWise Edge gateway, add it as a data source. When you add it as a data source, Amazon IoT SiteWise will deploy a private Amazon IoT Greengrass component to your SiteWise Edge gateway.

Prerequisites

To add a partner data source, you must do the following:

  • Create an account with the partner.

  • Bind the accounts.

To create a SiteWise Edge gateway with a partner data source

If you want to create a new SiteWise Edge gateway, complete the steps in Creating a SiteWise Edge gateway. After you’ve created SiteWise Edge gateway follow the steps in To add a partner data source to an existing SiteWise Edge gateway to add a partner data source.

To add a partner data source to an existing SiteWise Edge gateway

  1. Navigate to the Amazon IoT SiteWise console.

  2. In the navigation pane, choose Gateways.

  3. Choose the SiteWise Edge gateway you want to connect the partner data source to.

  4. Under Data sources, choose Add data source.

  5. For Source type, choose the partner you want to connect your SiteWise Edge gateway to.

    Note

    Currently, EasyEdge is the only available partner data source. The first time you add an EasyEdge data source, you'll need to create an EasyEdge account.

  6. Enter a name for the source.

  7. To grant the partner access to the data source, select Authorize.

  8. To let Amazon IoT SiteWise update your Amazon IoT SiteWise publisher component and, if the data processing pack is enabled, the Amazon IoT SiteWise processor component, select Update components.

  9. Choose Save.

Set up docker on your SiteWise Edge gateway

To add a partner data source, Docker Engine 1.9.1 or later must be installed on your local device.

Note

Version 20.10 is the latest version that is verified to work with the SiteWise Edge gateway software.

To verify Docker is installed

To verify Docker is installed, run the following command from a terminal connected to your SiteWise Edge gateway:

docker info

If the command returns a docker is not recognized result, or an older version of Docker is installed, Install Docker Engine before continuing.

To set up Docker

The system user that runs a Docker container component must have root or administrator permissions, or you must configure Docker to run it as a non-root or non-admistrator user.

On Linux devices, you must add a ggc_user user to the docker group to call Docker commands without sudo.

To add ggc_user, or the non-root user that you use to run Docker container components, to the docker group, run the following command:

sudo usermod -aG docker ggc_user

For more information, see Linux post-installation steps for Docker Engine.