Send Data to AWS IoT Core

Procedure

  1. Access the AWS Management Console page.
  2. Search and select IoT Core.
    The AWS IoT page appears.
  3. Create a policy allowing the permissions that you want to grant on your device (for example, iot:Connect, iot:Publish, iot:Subscribe, iot:Receive). For the resource, provide the topic name. If, however, you want to use all topics, enter *.
  4. Create a thing, linking it with the policy that you have created.
  5. Download the certificates and key files for the device to communicate. In addition, download the root CA certificate.


    Important: This is mandatory, and it is the only time you can download the certificates.
  6. In the left navigation pane, select Settings.
  7. Make a note of the endpoint that appears.


  8. Access Configuration Hub.
  9. Select Collectors.
    A list of collectors in the system appears.

  10. Select .
    The Add Collector Instance: <system name> window appears, displaying the Collector Selection section. The MACHINE NAME field contains a list of machines on which you have installed collectors.

  11. In the MACHINE NAME field, select the machine in which you want to add a collector instance.
  12. In the COLLECTOR TYPE field, select a collector type (except the File collector and the Server-to-Server collector), and then select Get Details.
    The INSTALLATION DRIVE and DATA DIRECTORY fields are disabled and populated.
  13. Select Next.
    The Source Configuration section appears, populating the hostname of the collector machine.
  14. Select Next.
    The Destination Configuration section appears.

  15. In the CHOOSE DESTINATION field, select MQTT, and then provide values as described in the following table.
    Field Description
    HOST ADDRESS Enter the endpoint that you have noted down.
    PORT Enter 8883.
    CLIENT ID Enter the thing name.
    TOPIC Enter the MQTT topic to which you want the collector to publish data. A value is required. For information on topic names, refer to https://docs.aws.amazon.com/iot/latest/developerguide/topics.html.
    USERNAME Enter any value. Since we will use a certificate-based authentication, username and password will not be used; however, you must still enter a value.
    PASSWORD Enter any value. Since we will use a certificate-based authentication, username and password will not be used; however, you must still enter a value.
    CA SERVER ROOT FILE Enter the path of the root CA certificate file that you have downloaded.
    CLIENT CERTIFICATE Enter the path of the device certificate that you have downloaded.
    PRIVATE KEY FILE Enter the path of the private key file that you have downloaded.
    PUBLIC KEY FILE Enter the path of the public key file that you have downloaded.
    CHOOSE CONFIGURATION Select the type of the configuration to specify the tags whose data you want to collect. Select one of the following options:
    • Historian Configuration: Select this option if you want to add the tags manually using Historian Administrator. If you select this option, the CONFIGURATION HISTORIAN SERVER field appears.
    • Offline Configuration: Select this option if you want to provide the tag names using the offline configuration file instead of adding tags manually. By default, this file is located in the following location: <installation folder of Historian>\GE Digital\<collector name>
  16. Select Next.
    The Collector Initiation section appears.

  17. In the COLLECTOR NAME field, enter a unique collector name.
  18. In the RUNNING MODE field, select one of the following options.
    • Service - Local System Account: Select this option if you want to run the collector as a Windows service using the credentials of the local user (that is, the currently logged-in user). If you select this option, the USERNAME and PASSWORD fields are disabled.
    • Service Under Specific User Account: Select this option if you want to run the collector as a Windows service using a specific user account. If you select this option, you must enter values in the USERNAME and PASSWORD fields. If you have enabled the Enforce Strict Collector Authentication option in Historian Administrator, you must provide the credentials of a user who is added to at least one of the following security groups:
      • iH Security Admins
      • iH Collector Admins
      • iH Tag Admins

    If you choose the first option, you can also configure the collector to start automatically when you start the computer, or, in the case of iFIX collectors, whenever you start iFIX.

  19. Select Add.
    The collector instance is created.
  20. Specify the tags whose data you want to collect using the collector. While creating the collector instance, in the CHOOSE CONFIGURATION field in the Destination Configuration field:
    • If you have selected Historian Configuration, access Historian Administrator, and manage the tag configuration. For information, refer to Configure Tags.
    • If you have selected Offline Configuration, modify the offline configuration file of the collector. By default, this file is available in the following location: <installation folder of Historian>\GE Digital\<collector name>. For information, refer to Creating Offline Configuration XML file.
  21. Access AWS IoT Core, and in the left pane, select Test.
    The MQTT test client page appears.

  22. Subscribe to the topic to which the collector is publishing data, and then select Subscribe.
    The messages received from the topic appear, indicating that the collector is sending data to the AWS IoT device.
    AWS supports a payload of maximum 128 KB. Therefore, if the message size is greater than 128 KB, create a registry key named CloudMaxSamplesPerMsg for the collector instance, and decrease the value to 700 or less. If, however, you want to send more data in a message, we recommend that you create another collector instance and send data to another thing resource in AWS.
    Tip: To find out the message size, modify the collector instance and set the log level to 3 or more.
  23. Create a VPC destination or an HTTP destination for the messages.
  24. Monitor the data that you have collected.