Creating a gateway
You can use the Amazon IoT SiteWise console to create a gateway. This topic contains the following steps:
Topics
Step 1: Configure a gateway
-
Navigate to the Amazon IoT SiteWise console
. -
In the navigation pane, choose Gateways.
-
Choose Create gateway.
-
Enter a name for your gateway or use the name generated by Amazon IoT SiteWise.
-
For Greengrass core device, choose one of the following options:
-
Default setup ‐ Amazon automatically uses default settings to create a Greengrass core device in Amazon IoT Greengrass V2.
-
Enter a name for the Greengrass core device or use the name generated by Amazon IoT SiteWise.
-
-
Advanced setup ‐ Choose this option if you want to use an existing Greengrass core device or to create one manually.
-
Choose a Greengrass core device or choose Create Greengrass core device to create one in the Amazon IoT Greengrass V2 console. For more information, see Setting up Amazon IoT Greengrass V2 core devices in the Amazon IoT Greengrass Version 2 Developer Guide.
-
-
-
Choose Next.
Step 2: Configure edge capabilities
Amazon IoT SiteWise provides the following packs that your gateway can use to determine how to collect and process your data. Select packs to enable edge capabilities for your gateway.
-
Data collection pack enables your gateway to collect data from multiple OPC-UA servers, and then export the data from the edge to the Amazon Cloud. By default, this pack is automatically enabled for your gateway. You can't disable this pack.
-
Data processing pack enables your gateway to process your data at the edge. For example, you can use asset models to compute metrics and transforms. For more information about asset models and assets, see Modeling industrial assets.
Note -
Amazon IoT SiteWise retains your edge data on your gateways up to 30 days. The retention of your data is dependent on your device and the available disk space.
-
The data processing pack is automatically turned off 30 days after your gateway has been disconnected from the Amazon Cloud.
-
-
(Optional) In the Edge capabilities pane, select Data processing pack.
-
(Optional) In the Edge LDAP connection pane, you can grant user groups in your corporate directory access to this gateway. The user groups can use the Lightweight Directory Access Protocol (LDAP) credentials to access the gateway. Then they can use the Amazon OpsHub for Amazon IoT SiteWise application, Amazon IoT SiteWise APIs, or other tools to manage the gateway. For more information, see Managing gateways
Note You can also use the Linux credentials to access the gateway. For more information, see Accessing your gateway using Linux operating system credentials.
-
Select Enable.
-
For Provider name, enter a name for your LDAP provider.
-
For Hostname or IP address, enter the hostname or IP address of your gateway device.
-
For Port, enter a port number.
-
For Base distinguished name (DN), enter a distinguished name (DN) for the base.
The following attribute types are supported: commonName (CN), localityName (L), stateOrProvinceName (ST), organizationName (O), organizationalUnitName (OU), countryName (C), streetAddress (STREET), domainComponent (DC), and userid (UID).
-
For Admin group DN, enter a DN.
-
For User group DN, enter a DN.
-
-
Choose Next.
Step 3: Configure publisher - optional
You can configure the publisher to control what data is sent to the cloud and the order that it's sent to the cloud. The Amazon IoT SiteWise publisher is an Amazon IoT Greengrass component that runs on your gateway device. For more information, see IoT SiteWise Publisher in the Amazon IoT Greengrass Version 2 Developer Guide.
To configure the publisher, use the Amazon IoT SiteWise console or API.
Step 4: Add data sources - optional
Data sources are local servers or industrial equipment that are connected to gateways. You can add data sources so that your gateway can ingest data from the OPC-UA servers to Amazon IoT SiteWise.
Gateways running on Amazon IoT Greengrass V2 currently don't support Modbus TCP and Ethernet IP sources.
To add an OPC-UA source
-
Choose Add data source.
-
Enter a name for the source.
-
Enter the Local endpoint of the data source server. The endpoint can be the IP address or hostname. You may also add a port number to the local endpoint. For example, your local endpoint might look like
opc.tcp://203.0.113.0:49320
. -
(Optional) For Node ID for selection, add node filters to limit which data streams are ingested to the Amazon Cloud. By default, gateways use the root node of a server to ingest all data streams. To define node filters, you can use node IDs and the
*
and**
wildcard characters. -
For Destinations, choose where the source data is sent.
-
Amazon IoT SiteWise ‐ Send data to Amazon IoT SiteWise. Choose this option if you want to process data at the edge.
-
Amazon IoT Greengrass stream manager ‐ Use Amazon IoT Greengrass stream manager to send data to the following Amazon cloud destinations: channels in Amazon IoT Analytics, streams in Amazon Kinesis Data Streams, asset properties in Amazon IoT SiteWise, or objects in Amazon Simple Storage Service (Amazon S3). For more information, see Manage data streams on the Amazon IoT Greengrass Core in Amazon IoT Greengrass Version 2 Developer Guide.
Enter a name for the Amazon IoT Greengrass stream.
-
-
In the Advanced configuration pane, do the following:
-
(Optional) Enter a Data stream prefix. The gateway adds this prefix to all data streams from this source. Use a data stream prefix to distinguish between data streams that have the same name from different sources. Each data stream should have a unique name within your account.
-
Choose a Message security mode for connections and data in transit between your source server and your gateway. This field is the combination of the OPC-UA security policy and message security mode. Choose the same security policy and message security mode that you specified for your OPC-UA server.
-
If your source requires authentication, choose an Amazon Secrets Manager secret from the Authentication configuration list. The gateway uses the authentication credentials in this secret when it connects to this data source. You must attach secrets to your gateway's Amazon IoT Greengrass component to use them for data source authentication. For more information, see Configuring data source authentication.
Tip Your data server might have an option named Allow anonymous login. If this option is Yes, then your source doesn't require authentication.
-
For Property groups, choose Add new group.
-
Enter a Name for the property group.
-
For Properties:
-
(Optional) For Node paths, add OPC-UA node filters to limit which OPC-UA paths are uploaded to Amazon IoT SiteWise. You can use node filters to reduce your gateway's startup time and CPU usage by only including paths to data that you model in Amazon IoT SiteWise. By default, gateways upload all OPC-UA paths except those that start with
/Server/
. To define OPC-UA node filters, you can use node paths and the*
and**
wildcard characters. For more information, see Using OPC-UA node filters.
-
-
For Group settings, do the following:
-
Starting for Amazon IoT SiteWise OPC-UA collector 2.1.x:
-
(Optional) For DataQuality, choose the type of data quality that you want Amazon IoT SiteWise Collector to ingest.
-
(Optional) For Subscription, configure following standard subscription properties:
-
DataChangeTrigger
‐ You can define the condition that initiates a data change alert. -
QueueSize
‐ The depth of the queue on an OPC‐UA server for a particular metric where notifications for monitored items are queued. -
PublishingIntervalMilliseconds
‐ The interval (in milliseconds) of publishing cycle specified when subscription is created. -
SnapshotFrequencyMilliseconds ‐ You can configure the snapshot frequency timeout setting to ensure that Amazon IoT SiteWise Edge ingests a steady stream of data.
-
-
-
For Scan mode, choose the mode that you want Amazon IoT SiteWise to use to collect your data. For more information about scan mode, see Filter data ingestion ranges with OPC-UA.
-
For Scan rate, update the rate that you want the gateway to read your registers. Amazon IoT SiteWise automatically calculates the minimum allowable scan rate for your gateway.
-
(Optional) configure a Deadband setting for your source. This controls what data your source sends to your Amazon IoT SiteWise, and what data it discards. For more information about the deadband setting, see Filter data ingestion ranges with OPC-UA.
-
-
Choose Add.
-
-
Choose Next.
Step 5: Review and generate an installer
In this step, you review the configuration of your gateway, and then do the following:
-
Choose one of the following operating systems:
-
Amazon Linux
-
Red hat
-
Ubuntu
-
Windows Server
-
-
Choose Generate.
-
In the dialog box, choose Acknowledge.
Amazon IoT SiteWise automatically generates an installer that you can use to configure your gateway device. Make sure that you save the installer file in a secure location. You will use the file later.